מוניטור SIP בזמן אמת - מערכת SiP_panel שימו לב, שירות זה דורש רישיון פעיל (חבילה בתשלום מול שירות הלקוחות, או התנסות). ניתן לבדוק את מצב הרישיון גם ללא רישיון באמצעות getLicenseInfo. הפקודה היא - SipRealtimeMonitor אפשר לקרוא לשירות בGET (פרמטרים ב-query string) או בPOST עם json בbody — למעט getCalls עם פילטר חשבונות שמצריך POST. בכל פניה יש לצרף: פרמטר תיאור סוג token טוקן string action הפעולה לביצוע - יבואר string פעולות: קבלת מצב הרישיון - getLicenseInfo הפעולה היא - getLicenseInfo מענה בעת הצלחה מאפיין סוג הסבר דוגמא responseStatus string סטטוס הפעולה OK license.allowed boolean האם יש גישה לשירות true license.trial boolean האם זהו רישיון ניסיון true license.trialStart number Unix timestamp של תחילת הניסיון 1779705344 license.trialEnd number Unix timestamp של סיום הניסיון 1780310144 license.trialAvailable boolean האם ניסיון זמין להפעלה false דוגמא לתגובה כאשר השירות בניסון פעיל: { "responseStatus": "OK", "license": { "allowed": true, "trial": true, "trialStart": 1779705344, "trialEnd": 1780310144 } } דוגמא לתגובה — אין רישיון, ניסיון זמין: { "responseStatus": "OK", "license": { "allowed": false, "reason": "no_license", "trialAvailable": true } } הפעלת ניסיון חינם - startTrial הפעולה היא - startTrial מפעיל ניסיון חינם של 7 ימים. ניתן לבצע את הפעולה בכל מערכת פעם אחת בלבד!. מענה בעת הצלחה מאפיין סוג הסבר דוגמא responseStatus string סטטוס הפעולה OK trialStarted boolean האם הניסיון הופעל כעת true alreadyLicensed boolean האם כבר היה רישיון פעיל true license object פרטי הרישיון לאחר הפעלה { "responseStatus": "OK", "trialStarted": true, "license": { "allowed": true, "trial": true, "trialStart": 1779705344, "trialEnd": 1780310144 } } קבלת שיחות - getCalls הפעולה היא - getCalls שירות זה דורש רישיון פעיל. הפרמטרים הנדרשים בנוסף (אופציונליים): פרמטר תיאור סוג ברירת מחדל includeEnded כלול שיחות שהסתיימו (כלומר שלא בחיוג / בשיחה כרגע) (ended[]) בתגובה 0 או 1 0 onlyEnded החזר רק שיחות שהסתיימו, ללא שיחות פעילות 0 או 1 0 endedLimit מגבלת מספר שיחות שהסתיימו להחזיר (האחרונות לפי זמן ניתוק, כאשר הראשון הוא החדש ביותר) number 30 accounts מערך חשבונות לסינון — רק חשבונות אלו יוחזרו. מצריך POST עם JSON body array ללא סינון מענה בעת הצלחה מאפיין סוג הסבר responseStatus string סטטוס הפעולה summary object סיכום המכיל את המידע המצטבר מכלל החשבונות שנבחרו accounts object המפתח — key הוא שם החשבון, value הוא נתוני החשבון license object מצורף רק כשהרישיון הוא רישיון התנסות, עם מידע עוד כמה זמן הוא פג תוקף וכו כמו שנכתב למעלה מבנה summary: מאפיין סוג הסבר totalActive number סה"כ שיחות פעילות כרגע dialing number שיחות במצב חיוג inCall number שיחות בשיחה ממש totalCalls number סה"כ שיחות (היסטוריה שבועית ~~ יבואר למטה) totalIncoming number סה"כ נכנסות totalOutgoing number סה"כ יוצאות totalAnswered number סה"כ נענו totalMissed number סה"כ לא נענו totalTalkTimeSeconds number סה"כ זמן שיחה בשניות totalRecorded number סה"כ מספר שיחות שהוקלטו הוקלטו מבנה כל חשבון ב-accounts: מאפיין סוג הסבר summary object סטטיסטיקות החשבון (אותם שדות כמו summary הכללי - רק כלפי החשבון הספציפי הזה) calls array מערך שיחות שיחות פעילות כרגע ended array שיחות שהסתיימו (רק אם includeEnded=1 או onlyEnded=1) מבנה שיחה (calls / ended): מאפיין סוג הסבר דוגמא id string מזהה שיחה ייעודי "3f2a1b..." account string שם חשבון ה-SIP "06558877=2" callType string סוג שיחה "IN" / "OUT" source string מספר מקור "050000000" destination string מספר יעד "0773133333=2" startTime number Unix timestamp — תחילת השיחה 1779710278 answeredTime number|null Unix timestamp — מענה (null אם לא נענה) 1779710282 endTime number|null Unix timestamp — ניתוק (null אם עדיין פעיל) null status string מצב השיחה "dialing" / "in_call" / "ended" hasRecord boolean האם יש הקלטה true recordPath string|null נתיב ההקלטה "ivr2://Trash/SIPRecord/DID-..." history array רצף אירועי השיחה - יבואר למטה מבנה history event: מאפיין סוג הסבר דוגמא event string סוג האירוע "start" / "answer" / "transfer" / "end" time number Unix timestamp 1779710278 to string יעד ההעברה (רק באירוע-transfer) "05200000" דוגמא לתגובה מלאה: { "responseStatus": "OK", "summary": { "totalActive": 2, "dialing": 1, "inCall": 1, "totalCalls": 4395, "totalAnswered": 219, "totalMissed": 4176, "totalIncoming": 4380, "totalOutgoing": 15, "totalTalkTimeSeconds": 13515, "totalRecorded": 16 }, "accounts": { "0888888888=2": { "summary": { "totalActive": 1, "dialing": 0, "inCall": 1, "totalCalls": 250, "totalAnswered": 8, "totalMissed": 242, "totalTalkTimeSeconds": 480, "totalRecorded": 1 }, "calls": [ { "id": "3f2a1b4c-5d6e-7f8g-9h0i-1j2k3l4m5n6o", "account": "0888888888=2", "callType": "IN", "source": "050000000", "destination": "0888888888=2", "startTime": 1779710278, "answeredTime": 1779710282, "endTime": null, "status": "in_call", "hasRecord": true, "recordPath": "ivr2://Trash/SIPRecord/DID-xxxx-Phone-xxxx-routing-4446464646=2-Date-2026-05-25-19-00-00.wav", "history": [ { "event": "start", "time": 1779710278 }, { "event": "answer", "time": 1779710282 }, { "event": "transfer", "time": 1779710290, "to": "079999999" } ] } ], "ended": [] } } } קבלת שיחות לחשבון ספציפי - getCallsByAccount הפעולה היא - getCallsByAccount שירות זה דורש רישיון פעיל. הפרמטרים הנדרשים בנוסף: פרמטר תיאור סוג account שם חשבון ה-SIP string includeEnded כלול שיחות שהסתיימו 0 או 1 מענה בעת הצלחה מאפיין סוג הסבר responseStatus string סטטוס הפעולה account string שם החשבון שנשאל summary object סטטיסטיקות החשבון calls array שיחות פעילות ended array שיחות שהסתיימו (רק אם includeEnded=1) { "responseStatus": "OK", "account": "09948949494=2", "summary": { "totalActive": 1, "dialing": 0, "inCall": 1, "totalCalls": 250, "totalAnswered": 8, "totalMissed": 242, "totalTalkTimeSeconds": 480, "totalRecorded": 1 }, "calls": [], "ended": [] } שימו לב: השירות מיועד להיות שירות לקבל מידע בזמן אמת על מצב חשבונות ה SIP במערכת - ועל כן כל הנתונים לא נשמרים לטווח ארוך. נכון לכתיבת שורות אלה - אלה פחות או יותר הזמנים שנשמרים הנתונים לאחר שהם כבר לא ״זמן אמת״: נתון זמן שמירה שיחה בחיוג (dialing) 5 דקות — פג תוקף אוטומטית אם לא נענתה שיחה פעילה (in_call) עד 2.5 שעות מרגע המענה שיחה שהסתיימה 20 דקות סטטיסטיקות 7 ימים שיחות שמועברות: כל העברה מתועדת כ-event מסוג transfer ב-history עם שדה to המכיל את מספר היעד, אבל לא יוצרת שיחה חדשה או מזהה שיחה ייחודי.

הגדרות מקשי נציג בתור (DialKey) מערכת מקשי הנציג מאפשרת להגדיר פעולות שהנציג יכול לבצע תוך כדי שיחה עם לקוח. את ההגדרות יש לשים בקובץ ext.ini של שלוחת התור. טבלת הגדרות הגדרה ברירת מחדל תיאור dial_key_direct_press ריק (=no) yes = מקש ישיר ללא קידומת. ללא הגדרה — חייב קידומת לפני. dial_key_prefix # תו הקידומת — הנציג מקיש קודם את הקידומת ואז את הרצף. dial_key_seq ריק רצפי מקשים מותאמים. פורמט: ACTION=KEYS.ACTION=KEYS — מפריד נקודה (.). dial_key_seq_max_digits 2 מספר ספרות מקסימלי לקרוא אחרי המקש הראשון / קידומת. dial_key_return_to_call ** רצף מקשים לחזרה לשיחה מהמתנה. none = מבטל. dial_key_spy_and_talk #* רצף מקשים להאזנה + דיבור עם הלקוח. none = מבטל. dial_key_0 עד dial_key_9 ריק פעולה ישירה לספרה בודדת. dial_key_star ריק פעולה ישירה למקש *. dial_key_hash ריק פעולה ישירה למקש #. פעולות אפשריות פעולה תיאור דוגמה בהגדרה הערות hold העברת הלקוח להמתנה — הנציג עובר למצב המתנה ויכול לחזור עם dial_key_return_to_call. dial_key_5=hold return_to_call חזרה לשיחה עם הלקוח מהמתנה. dial_key_**=return_to_call spy_and_talk האזנה לשיחת הלקוח (ערוץ 3) + אפשרות דיבור (whisper/barge). dial_key_spy_and_talk=99 menu_move_client פתיחת תפריט אינטראקטיבי — הנציג בוחר שלוחה/תיקייה להעביר אליה את הלקוח. dial_key_3=menu_move_client move_client_to_folder-/FOLDER הזזת הלקוח לשלוחה/תיקייה מוגדרת מראש ללא תפריט. המערכת בודקת שהשלוחה קיימת. dial_key_seq=33=move_client_to_folder-/6 menu_routing_client פתיחת תפריט אינטראקטיבי — הנציג מקליד מספר טלפון לחייג עבור הלקוח. dial_key_4=menu_routing_client routing_client_to_number-XXXXX חיוג למספר מוגדר מראש עבור הלקוח ללא תפריט. תומך מספרים מקוצרים מקובץ DialKeyAbbreviatedDialing.ini. dial_key_seq=55=routing_client_to_number-0501234567 שימו לב! השימוש באפשרות זו כרוך בעלות יחידות כיצד זה עובד מצב קידומת (ברירת מחדל) הנציג מקיש קידומת (ברירת מחדל #) ואז את הרצף: #1 = קידומת # + מקש 1 #22 = קידומת # + רצף 22 מצב ישיר (dial_key_direct_press=yes) הנציג מקיש ישירות את הרצף בלי קידומת: 22 = הנציג מקיש 2, 2 — המערכת מזהה את הרצף *1 = הנציג מקיש *, 1 סדר עדיפויות מקש בודד — dial_key_5=hold רצף מותאם — dial_key_seq=22=hold Fallback — במידה ולא מוגדר, יתעלם מההקשה הנוספת ויתחשב במקש הראשון בלבד (כלומר מתעלם מהמקש השני וכו'). מקשים מובנים ברירת מחדל — return_to_call / spy_and_talk אחרי שנייה ללא הקשה (TIMEOUT) המערכת מסיימת לקרוא ומעבדת את מה שנאסף. אם הנציג מקיש פחות ספרות מהמקסימום — ה-TIMEOUT מסיים את הקלט. דוגמאות דוגמה 1 — מצב בסיסי: מקש בודד עם קידומת dial_key_5=hold dial_key_star=return_to_call נציג מקיש #5 ← השהיה נציג מקיש #* ← חזרה לשיחה נציג מקיש ** ← חזרה לשיחה (ברירת מחדל) דוגמה 2 — מצב ישיר + מקשים בודדים dial_key_direct_press=yes dial_key_5=hold dial_key_star=return_to_call נציג מקיש 5 ← השהיה נציג מקיש * ← חזרה לשיחה נציג מקיש ** ← חזרה לשיחה (ברירת מחדל) דוגמה 3 — רצפים קצרים עם קידומת dial_key_prefix=# dial_key_seq_max_digits=2 dial_key_seq=11=hold.22=return_to_call dial_key_return_to_call=none dial_key_spy_and_talk=none נציג מקיש #11 ← השהיה נציג מקיש #22 ← חזרה לשיחה נציג מקיש ** ← לא עובד (בוטל עם none) דוגמה 4 — רצפים ישירים עם תיקיות + חיוג dial_key_direct_press=yes dial_key_seq_max_digits=3 dial_key_seq=11=hold.22=return_to_call.33=move_client_to_folder-/6.44=menu_move_client.55=routing_client_to_number-0501234567.66=menu_routing_client dial_key_return_to_call=none dial_key_spy_and_talk=99 נציג מקיש 11 ← השהיה נציג מקיש 22 ← חזרה לשיחה נציג מקיש 33 ← הזזה לתיקייה 6 נציג מקיש 44 ← תפריט בחירת שלוחה נציג מקיש 55 ← חיוג ל-0501234567 נציג מקיש 66 ← תפריט הקלדת מספר נציג מקיש 99 ← האזנה + דיבור דוגמה 5 — רצף ארוך עם # באמצע dial_key_direct_press=yes dial_key_seq_max_digits=11 dial_key_seq=234*1*45#57=hold dial_key_return_to_call=## dial_key_spy_and_talk=none נציג מקיש 234*1*45#57 ← השהיה נציג מקיש ## ← חזרה לשיחה דוגמה 6 — קידומת * במקום # dial_key_prefix=* dial_key_seq_max_digits=2 dial_key_seq=1=hold.2=return_to_call dial_key_return_to_call=none dial_key_spy_and_talk=none נציג מקיש *1 ← השהיה נציג מקיש *2 ← חזרה לשיחה דוגמה 7 — שילוב מקשים בודדים + רצפים dial_key_direct_press=yes dial_key_5=hold dial_key_3=menu_move_client dial_key_4=menu_routing_client dial_key_seq_max_digits=3 dial_key_seq=123=move_client_to_folder-/6.456=routing_client_to_number-0501234567 dial_key_spy_and_talk=none נציג מקיש 5 ← השהיה (מקש בודד, עדיפות גבוהה) נציג מקיש 3 ← תפריט בחירת שלוחה נציג מקיש 4 ← תפריט הקלדת מספר נציג מקיש 123 ← הזזה לתיקייה 6 נציג מקיש 456 ← חיוג ל-0501234567 נציג מקיש ** ← חזרה לשיחה (ברירת מחדל) הערות חשובות מפריד בין רצפים ב-dial_key_seq — הוא נקודה (.) none מבטל ברירת מחדל — dial_key_return_to_call=none מבטל את **, ו-dial_key_spy_and_talk=none מבטל את #* dial_key_seq_max_digits — חובה להגדיר כשהרצף ארוך מ-2 תווים (למשל רצף 123 דורש לפחות 3) אפשר להשתמש בפחות מהמקסימום — אם מוגדר מקסימום 11, הנציג יכול להקיש 2 ספרות ולחכות שנייה; ה-TIMEOUT מסיים את הקלט מספרים מקוצרים — בפעולת routing_client_to_number אפשר להשתמש במספר מקוצר מתוך קובץ DialKeyAbbreviatedDialing.ini בתיקיית השלוחה או בשורש

דירוג חווית השירות לאחר שיחה עם נציג - קובץ ext.ini להפעלת הדירוג יש להגדיר בקובץ ext.ini: queue_call_rating=yes הגדרה זו היא חובה, כדי שאפשרות הדירוג תופעל. להגדרת זמן ההמתנה רצוי להקשת הדירוג (אופציונלי) יש להגדיר בקובץ ext.ini: queue_call_rating_timeout=10 ברירת מחדל 7 שניות, בדוגמה כאן המערכת תמתין 10 שניות להקשת הדירוג. במידה ואין הקשה במשך הזמן שהוגדר, המערכת תנתב את המחייג בהתאם להגדרת queue_end_continue_goto. לקביעת תדירות הדוח (אופציונלי) יש להגדיר בקובץ ext.ini: queue_call_rating_log_file_type=day בדוגמה זו, הדוח הוא יומי. ברירת מחדל, הדוח הוא כללי, כלומר החל מיום הפעלת הדירוג במערכת ועד לזמן הנוכחי. להלן פירוט ערכי תדירות דוח אפשריים: דוחות יומיים: day - דוח יומי (ברירת מחדל) day.15:23 - דוח יומי שמתחדש מדי יום בשעה 15:23 דוחות שבועיים: week - דוח שבועי (מתחדש כל יום ראשון) week.5 - דוח שבועי שמתחדש כל יום חמישי week.5.19:59 - דוח שבועי שמתחדש כל יום חמישי בשעה 19:59 דוחות חודשיים: month - דוח חודשי (מתחדש בראשון לחודש) month.25 - דוח חודשי שמתחדש ב-25 לכל חודש month.25.19:59 - דוח חודשי שמתחדש ב-25 לכל חודש בשעה 19:59 דוחות שנתיים: year - דוח שנתי (מתחדש בראשון בינואר) year.31/11 - דוח שנתי שמתחדש ב-31 בנובמבר year.31/11.19:59 - דוח שנתי שמתחדש ב-31 בנובמבר בשעה 19:59 דוחות דירוגים דוח מפורט של נתוני הדירוג נוצר אוטומטית בתוך תקיית Queue שבתוך תקיית Log (תקיית הדוחות) במערכת. שם הדו"ח: QueueCallRatingLog.ymgr. ניתן להוריד את הדו"ח, בדומה לכל דוחות המערכת כמפורט כאן. במידה והגדרתם דו"ח יומי / חודשי / שנתי, התאריך יתווסף אוטומטית בשם הדו"ח שנוצר, לדוגמה: QueueCallRatingLog[.תאריך].ymgr הערות חשובות: הדירוג מתבצע רק לאחר סיום שיחה שנענתה על ידי נציג. כל דירוג חדש מעדכן את הממוצע הכללי של הנציג. הדירוג הוא פר מערכת, כך שגם אם ישנם כמה שלוחות תור באותה מערכת, כל הנתונים ירוכזו בדו"ח כללי אחד. הודעות מערכת קשורות M4117 לקוח יקר כחלק משיפור השירות, נשמח לקבל משוב על חווית השירות. אנא דרג את רמת השירות מ 1 עד 5 כאשר 1 הוא הדירוג הנמוך ביותר ו-5 הוא הדירוג הגבוה ביותר M4118 הדירוג התקבל בהצלחה. תודה וּלהתראות

קופונים הנחת קופונים בסליקת אשראי ️ הסבר ניתן לאפשר ללקוחות להזין קוד קופון במהלך הרכישה וליהנות מהנחה אוטומטית בעת סליקת אשראי! האופציה מאפשרת להגדיר הנחות לפי אחוזים או סכום קבוע, ולשלוט בכמות המימושים לכל קופון. הפעלת אפשרות קופונים כדי לאפשר שימוש בקופונים בסליקת, הוסיפו את השורה הבאה לקובץ ההגדרות: credit_card_discount_coupons=yes הוספת קופונים יש להכניס את הקופונים לקובץ: CouponDiscount.ini ברירת מחדל: הקובץ ימוקם בשלוחה שבה נמצא המשתמש. במודול קבלת נתונים עם סליקת אשראי – ההתנהגות לפי recording_and_entering_data_folder_to_play. 🧮 סוגי הנחות ניתן להגדיר שני סוגי קופונים: הנחה באחוזים – למשל: 1234=25% קופון מספר 1234 מקנה 25% הנחה. הנחה בסכום קבוע (ש"ח) – למשל: 4567=30 קופון מספר 4567 מקנה 30 ש"ח הנחה. הגבלת מימושים 1. הגבלה גלובלית לכל הקופונים: discount_coupons_quantity_limit=10 בדוגמה, כל קופון ניתן למימוש עד 10 פעמים. 2. הגבלה ספציפית לכל קופון ההגדרה מתבצעת באותו קובץ שבו מגדירים את הקופונים (CouponDiscount.ini) – פשוט מוסיפים פסיק וכמות מקסימלית. דוגמה: 1234=25%,5 4567=30,4 בפירוט: 1234 – 25% הנחה, עד 5 מימושים. 4567 – 30 ש"ח הנחה, עד 4 מימושים. כמות המימושים נשמרת אוטומטית בקובץ: CouponDiscountAmoun.ini נתונים בדוחות הסליקה כאשר נעשה שימוש בקופון, יתווספו הנתונים הבאים לדוחות: initialAmount=סכום לפני ההנחה CouponCode=קוד הקופון שהוזן DiscountAmount=סכום ההנחה בפועל 🧾 הנתונים יופיעו בדוחות הסליקה ובדוחות סיכום המשתמשים עם סליקת אשראי.

שלוחה לניהול הטריוויה = הקלטת השאלות כמו שכתוב לעיל ניתן להקליט את השאלות דרך הטלפון, יש לפתוח שלוחה נפרדת מהשלוחה של הטריוויה עצמה ולהגדיר שם את ההגדרות הבאות מלבד הגדרת סוג השלוחה שיש להגדיר כמו בשלוחת הטריוויה עצמה type=trivia_questions יש להגדיר את סוג שלוחת הטריוויה למצב ניהול trivia_type=admin כמובן שצריך להגן על שלוחה זו שלא כל אחד יוכל להיכנס איליה בשביל להגדיר סיסמא לשלוחה ראה כאן יש להגדיר את השלוחה במערכת שלתוכה יוכנסו השאלות (בדרך כלל שלוחת הטריוויה עצמה): trivia_questions_val=2 כאן בדוגמה מוגדר שהשאלות יוקלטו לשלוחה 2 שתחת השלוחה הראשית (שימו לב! לא שמים את הסלש לפני הכתובת). כברירת מחדל, בשלוחת הקלטת השאלות, מושמעת שאלה איזה סוג שאלה רוצים להקליט (טריוויה או נכון/לא נכון). אם רוצים שלא יושמע תפריט זה, ולעבור ישירות להקלטת שאלה מסוג טריוויה אמריקאית, יש להגדיר: record_trivia_american=yes אם רוצים שלא יושמע התפריט הנ"ל, אלא לעבור ישירות להקלטת שאלה מסוג 'נכון או לא נכון' יש להגדיר: record_trivia_yes_no=yes כברירת מחדל, בשלוחת הקלטת השאלות, השאלות מוקלטות עבור טריוויה יומית. על מנת להגדיר את הקלטת השאלות למצב טריוויה 'קבוע', יש להגדיר: trivia_questions_location=always על סוגי החלפת השאלות (יומי/שבועי/קבוע) - ראו בהמשך.