@איל-משולש
אכן צריך לשלוח מייל עם פירוט שיחה מהיום האחרון

@בוס כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 כאשר מגדירים

אם ברצונכם שהנציג שמקבל את השיחה ישמע כמה זמן הלקוח המתין על הקו "זמן ההמתנה" X "דקות" וX"שניות" יש להגדיר

reportholdtime=yes

זה לא משמיע לנציג כלום.
אם אפשר לראות מה הבעיה.

עדין זה לא קיים.
יהיה בהמשך

@עידו כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@eliyahu מה לגבי רישום לחזרה? זה היום חובה במערכות

כנ"ל..
יהיה בהמשך

@אבו כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 דיברנו על זה לפני כחודש וחצי ומאז אני ממתין לתגובה
אבל באמת תודה על הכל גם זה הרבה

מאז טופלו המון בעיות.
אני משתמש במודל הזה והוא עובד לי מעולה.
לכן ממש אשמח שתשלחו פרטי שיחה למייל ולכתוב בכותרת 'עבור אלחנן'.
תודה

@אבו כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@תן-חיוך-1 כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

כרגע יש לי את מודל תור הקודם בתשלום
וחשוב לי שיעבוד בלי באגים כלל!!!
האם מומלץ מניסיון לעבור למודל הנוכחי??
האם מישהו כבר בדק בצורה
מקיפה ויודע להגיד שזה תקין

תודה רבה

ממש לא תקין!
לחלק מהנציגים השיחות לא מגיעות ולחלק מפסיק אחרי כמה שעות
אם אתה עושה את זה וזה מגיע לכולם ואצה ממשיך לעקוב שמגיע לכולם אתה יכול לנסות לעבור לזה, אם לא...

חברים.. תשלחו פרטי שיחה.
אחרת איך נפתור את הבעיות, באם ישנם.

@אהרון-דויד
אשמח לקבלת פירוט מלא של הבעיה + פרטי שיחה מהיום למייל: cs@yemot.co.il

ב"ה

עלה אפשרות טעינת הגדרות תור דרך API.
שימו לב! במודול זה יש שיפור וגמישות בנושא בשונה מהמודול הקודם.

לחצו כאן לתיעוד

---

טעינת הגדרות תור ומספרים לחיוג ב-API

הגדרות בקובץ ext

---

כללי

כברירת מחדל המערכת טוענת את הגדרות התור ואת רשימת המספרים לחיוג מקובץ queue.ini.

ניתן להגדיר כי נתוני התור ייטענו באמצעות API.

ההגדרה היא:

queue_url_link=https://example.com/queue.php

כמובן שאחרי ה = יש לרשום את כתובת ה-URL של השרת שלכם

• במקרה כזה, בכל כניסה של משתמש לשלוחה תתבצע פנייה בAPI לקבלת נתוני התור.
  את תגובת השרת יש להחזיר בהתאם לפורמט המובא להלן.
• במידה ואין התייחסות בתגובת השרת להגדרות התור, המערכת תטען את ההגדרות מקובץ queue.ini.
• במקרה של סתירה בהגדרות התור בין המופיע בתגובת השרת למופיע בקובץ queue.ini, ההגדרות המופיעות בתגובת השרת גוברות.
• את רשימת המספרים לחיוג המערכת טוענת אך ורק מתגובת השרת. ולא מקובץ queue.ini.

הערה: מדובר בהחלפת ערכים מלאה של הגדרות התור כולה, ולא רק של הגדרות שיחה ספציפית.

---

פרמטרים המצורפים לשליחה

פרמטרים ברירת מחדל

כברירת מחדל המערכת מצרפת לכל פנייה פרמטרים הכוללים מידע על השיחה
הפרמטרים המצורפים הם

• ApiCallId=מזהה ייחודי לאורך הפנייה לשרת
• YemotCallID=מזהה ייחודי לאורך השיחה
• ApiPhone=מספר הטלפון של המשתמש
• ApiDID= מספר טלפון הראשי של המערכת שלכם
• ApiRealDID=המספר אליו חייג המשתמש.
  (במידה ויש כמה מספרים למערכת שלכם, והמשתמש חייג למספר משנה, הערך הזה יהיה שונה מהערך הקודם)
• ApiExtension=שם התיקייה/שלוחה בה נמצא המשתמש
• ApiEnterID=במידה ובוצעה התחברות לפי זיהוי אישי, יצורף ערך זה המכיל את סוג ההתחברות וה-ID של המשתמש (מידע נוסף כאן)
• ApiEnterIDName= שם משויך לזיהוי האישי (כפי שמוסבר כאן)
• ApiTime= זמן בשניות מ1970, Epoch, i.e., since 1970-01-01 00:00:00 UTC.

כדי לבטל את שליחת הפרמטרים הנ"ל או את חלקם יש להגדיר (בהתאמה)

queue_api_did_send=no /// Deleting a parameters "ApiDID" "ApiRealDID"
queue_api_phone_send=no /// Deleting a parameter "ApiPhone"
queue_api_extension_send=no /// Deleting a parameter "ApiExtension"
queue_api_enter_id_send=no /// Deleting a parameter "ApiEnterID"
queue_api_enter_id_name_send=no /// Deleting a parameter "ApiEnterIDName"
queue_api_time_send=no /// Deleting a parameter "ApiTime"
queue_api_call_id_send=no /// Deleting a parameter "ApiCallId"
queue_api_yemot_call_id_send=no /// Deleting a parameter "YemotCallID"

פרמטרים קבועים

ניתן להגדיר שבכל פנייה, המערכת תצרף פרמטרים קבועים שיישלחו לשרת.

(הערה: לא ניתן לצרף פרמטרים הנשלחים כברירת מחדל)

לדוגמה אם ברצונכם שבכל פנייה לשרת המערכת תצרף את הפרמטרים p1=v1 p2=v2 יש להגדיר בהגדרות השלוחה

queue_api_add_0=p1=v1
queue_api_add_1=p2=v2

במקרה כזה הבקשה ב-GET תראה כך

https://example.com/queue.php?p1=v1&p2=v2

כמובן שניתן לצרף פרמטרים נוספים (queue_api_add_X=), כשבמקום X יש לרשום את מספר הפרמטר.
שימו לב שחשוב לשמור על רצף סידורי החל מהספרה 0.

---

מתודת שליחה

כברירת מחדל הפנייה נשלחת בHTTP GET
אם ברצונכם שהפנייה תישלח בHTTP POST יש להגדיר

queue_api_url_post=yes

---

תגובת שרת

את תגובת השרת יש להחזיר בתבנית JSON.
הנתונים שניתן להחזיר הם בדומה להגדרות האפשריות בקובץ queue.ini
דוגמה

{
	"description" : x,
	"queueactive" : x,
	"autofill" : x,
	"context" : x,
	"monitor-type" : x,
	"monitor-format" : x,
	"servicelevel" : x,
	"keepstats" : x,
	"maxlen" : x,
	"autopause" : x,
	"announce-position" : x,
	"announce-position-limit" : x,
	"announce-holdtime" : x,
	"announce-frequency" : x,
	"relative-periodic-announce" : x,
	"random-periodic-announce" : x,
	"min-announce-frequency" : x,
	"announce-round-seconds" : x,
	"periodic-announce" : x,
	"periodic-announce-frequency" : x,
	"reportholdtime" : x,
	"strategy" : x,
	"joinempty" : x,
	"leavewhenempty" : x,
	"retry" : x,
	"wrapuptime" : x,
	"timeout" : x,
	"timeoutrestart" : x,
	"musicclass" : x,
	"ringinuse" : x,
	"queue-thankyou" : x,
	"queue-youarenext" : x,
	"queue-thereare" : x,
	"queue-callswaiting" : x,
	"queue-holdtime" : x,
	"queue-minutes" : x,
	"queue-seconds" : x,
	"queue-less-than" : x,
	"queue-reporthold" : x,
	"members" : [
		"0507707701",
		"SIP-0773137770"
	]
}

• בפרמטר members יש להחזיר את רשימת המספרים לחיוג.

שימו לב!
המערכת טוענת את כל הגדרות התור מתוך תגובת השרת בלבד!
אין כל הסתמכות על קובץ queue.ini!!
אין מיזוג בין תגובת השרת לבין queue.ini.
אין fallback לקובץ queue.ini במקרה שחסר פרמטר בתגובה.

---

חסימת שיחה באמצעות API

כדי לחסום שיחה באופן יזום דרך ה-API יש להחזיר JSON במבנה הבא:

{
  "status": "error",
  "action": "API_MODULE",
  "action_data": "id_list_message=t-שלום עולם.g-/1"
}

בדוגמה, השיחה לא תיכנס לתור.
המשתמש ישמע 'שלום עולם' בהקראה רובוטית ויעבור לשלוחה אחת תחת השלוחה הראשית.

כאשר מתקבלת תגובה זו:

• המערכת אינה ממשיכה לתהליך התור.
• אין ניסיון לחייג למספרים.
• אין טעינה של הגדרות תור.
• התגובה מטופלת בהתאם למנגנון מודול API.

כלומר, במקום כניסה לתור, המערכת מתייחסת לתגובה כאילו הופעל מודול API רגיל, ומבצעת את הפעולה בהתאם לערך action_data.

המשמעות המעשית

באמצעות action_data ניתן:

• להעביר לשלוחה אחרת
• להשמיע הודעה
• להפעיל מוזיקה בהמתנה
• לבצע ניתוק
• או כל פעולה אחרת הנתמכת במודול API

כך ניתן לשלוט באופן מלא בזרימת השיחה במקרה שהחלטתם לא להכניס את המתקשר לתור (לדוגמה: חסימה לפי זיהוי, שעות פעילות, בדיקת הרשאות וכד').

הפירוט המלא של מבנה ואפשרויות action_data מופיע בתיעוד מודול API:
https://f2.freeivr.co.il/post/77904

---

טיפול במצב שגיאה בתגובת ה-API

מצב שגיאה כולל בין היתר:

• action אינו API_MODULE
• action_data ריק
• JSON לא תקין
• תגובה ריקה
• שגיאת כל שהיא בשרת

ההתנהגות תיקבע לפי queue_error_api_status כמובא בהמשך.

---

יש 3 מצבים שאפשר להגדיר במצב שגיאה:

1. יציאה מהשלוחה (ברירת מחדל)

queue_error_api_status=exit

המעבר יתבצע לפי:

queue_error_api_goto=/1/1

בדוגמה זו המערכת תעבור לשלוחה /1/1 מהתפריט הראשי.
אם לא הוגדר queue_error_api_goto, המערכת תפעל לפי:

queue_error_goto=/2/2

אם גם זה אינו מוגדר, תתבצע חזרה של שלוחה אחת אחורה (exit רגיל).

---

2. קריאה מקובץ queue.ini

queue_error_api_status=read_ini_file

במצב זה המערכת תטען את הגדרות התור מקובץ queue.ini.

---

3. שימוש בנתונים מהשיחה הקודמת

queue_error_api_status=read_cash

במצב זה המערכת תשתמש בהגדרות התור המעודכנות מהשיחה הקודמת, ללא רענון חדש מה-API.

@CUBASE כתב במודול תור לא טוען הגדרות תור מהשרת?:

@שמואל-ש. יכול להיות שבעקבות השינויים שביצעו במודול תור החדש השתבש משהו במודול הישן, שלח במייל.

אין קשר

@האדם-החושב כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@האדם-החושב כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 עכשיו הwebhook לא נשלח כלל.
וגם בקובץ הymgr אין את העמודה של תגובת שרת.

טופל.
תבדוק ותעדכן

עדיין חסרים השדות הבאים:
QueueTotalSeconds
QueueWaitingSeconds
AnswerSeconds

עוד נקודה - הנתיב של ההקלטה שנשלח בwebhook לא נכון
כל נתיב מתחיל כך:

ivr2:/Trash/QueueRecord//QueueRecord/CustomerDID-

במקום:

ivr2:/Trash/QueueRecord/CustomerDID-

טופל.

@אהרון-דויד כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 מיום שישי או חמישי אני לא מקבל בכלל הקלטות שיחה למייל
אפילו לא את הדוח

טופל

@אופיר כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@BEN-ZION כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 אם יש כמה נציגים שזה מופנה לטלפון הנייד שלהם אם כולם דוחים את השיחה במקום לנתק את הלקוח זה שוב מחייג לכל הנציגים

ככה עובד מודול תור
תוכל להגדיר אחרת אצליך..

ההגדרה

retry=10

לא קיימת במודול החדש. זה מאוד חסר.

אולי לא קיים בתיעוד, אבל זה עובד

@BEN-ZION כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 אם יש כמה נציגים שזה מופנה לטלפון הנייד שלהם אם כולם דוחים את השיחה במקום לנתק את הלקוח זה שוב מחייג לכל הנציגים

ככה עובד מודול תור
תוכל להגדיר אחרת אצליך..

דירוג חווית השירות לאחר שיחה עם נציג - קובץ 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 הדירוג התקבל בהצלחה. תודה וּלהתראות

@האדם-החושב כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 עכשיו הwebhook לא נשלח כלל.
וגם בקובץ הymgr אין את העמודה של תגובת שרת.

טופל.
תבדוק ותעדכן

@אהרון-דויד כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 אני לא מקבל את הקובץ של ההקלטות שיחה למייל רק את הדוח שיחה

זה קורה רק שהנציג מנתק את השיחה.
בטיפול

שימו לב!

עלה אתמול עדכון משמעותי במודול תור החדש.
באם אתם חווים תקלות, נא לפרט כאן, או לשלוח במסודר במייל.
תודה

@האדם-החושב כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

@אלחנן1 עדיין לא נשלחים השדות הבאים:
IdType
EnterId
QueueTotalSeconds
QueueWaitingSeconds
AnswerSeconds
QueueRecordPath

טופל
תבדוק שוב

@HMJE22 כתב בחדש! הקלטת הודעה זמנית עם הגדרת תוקף | מודול הקלטת הודעות מערכת:

@אלחנן1 כתב בחדש! הקלטת הודעה זמנית עם הגדרת תוקף | מודול הקלטת הודעות מערכת:

הגדרת כמות זמן כערך קבוע ללא תפריט

לאחר בחירת סוג תוקף, מקליט ההודעה מתבקש להקיש כמות זמן מבוקשת.
כדי שיהיה כמות זמן כערך קבוע וללא תפריט, יש להגדיר:

record_system_temp_validity_quantity=30

בדוגמה, באם מקליט ההודעה בחר בסוג 'שעות', הזמן שיוגדר לשמיעת ההודעה הוא: 30 שעות.

@אלחנן1 השורה record_system_temp_validity_quantity=30 לא עובד.
כאשר מוגדר השורה הנ"ל השיחה מתנתקת מיד בכניסה לשלוחה.

אני הגדרתי שיהיה לפי ימים, וכן הגדרתי שיהיה ברירת מחדל 2, כך:

record_system_temp_validity_type=days
record_system_temp_validity_quantity=2

ובכניסה לשלוחה השיחה מתנתקת!

עשיתי שינוי כל שהוא.
אשמח לבדיקה אם זה עובד או לא.
באם לא, תשלח פרטי שיחה במייל

@האדם-החושב כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

• הגדרתי שליחת webhook לשרת בסיום התור באותם הגדרות כמו תור רגיל ואמנם אני מקבל webhook אבל רק עם YDTimestamp ו YemotCallID

טופל, תבדוק תקינות

@האדם-החושב כתב בחדש! מודול ניתוב שיחות לפי תור ללא עלות יחידות - שרשור מתעדכן:

2 תופעות מעניינות:

• כשאני מתקשר לשלוחה על ידי "חייג לשלוחה זו" מהאתר (לצורך טסטים) הוא משמיע "שגיאה", בחיוג רגיל זה עובד מצויין.
• הגדרתי שליחת webhook לשרת בסיום התור באותם הגדרות כמו תור רגיל ואמנם אני מקבל webhook אבל רק עם YDTimestamp ו YemotCallID

1. כנראה ששיחה בצורה הזו לא מטעינה את כל הערכים הנדרשים למודול זה.
2. אשמח לקבל פרטי שיחה למייל שלנו. תכתוב בכותרת 'עבור אלחנן'

תודה