יועציםהמרכזיה מדווחת למערכת על כל שיחה בקריאת POST, והמערכת רושמת אותה בכרטיס הלקוח לפי מספר הטלפון. זה מה שמזין את יומן השיחות בכרטיס, את הקפצת הכרטיס בשיחה נכנסת, ואת דוח ממוצע השיחות.
שני שלבים
1. בחירת הספק — במסך מודולים וממשקים בוחרים את ספק המרכזיה.
2. הפניית ה-webhook — מגדירים אצל הספק שליחת POST לכתובת שמופיעה במסך לאחר בחירת הספק. הכתובת כוללת את מזהה החברה ואת הטוקן שלכם.
הסכמות
לכל ספק מבנה משלו. אלה השדות שהמערכת קוראת:
Voicenter
| שדה | תוכן |
|---|---|
did |
המספר של הקו במרכזיה |
cnumber |
מספר הלקוח |
ivruniqueid |
מזהה ייחודי לשיחה |
start |
שעת התחלה, unix time |
totaltime |
משך בשניות |
extension |
שלוחה |
direction |
inbound / outbound / internal |
Event |
Abandon / Hangup / NOTCALLED |
record |
קישור להקלטה |
message |
הודעה |
RetryAmount, RetryNum |
לשימוש תותח השיחות |
1com
| שדה | תוכן |
|---|---|
callername |
המספר של הקו במרכזיה |
caller |
המספר המתקשר, או השלוחה בשיחה יוצאת |
cnumber |
המספר שאליו התקשרו |
ivruniqueid |
מזהה ייחודי לשיחה |
extension |
שלוחה |
direction |
Incoming Call / Outgoing Call |
start |
שעת התחלה |
totaltime |
משך |
Event |
ANSWER / ABANDONE / NO ANSWER |
record |
קישור להקלטה |
שימו לב שערכי direction ו-Event שונים לגמרי מאלה של Voicenter.
015 / הלו
| שדה | תוכן |
|---|---|
callername |
המספר של הקו במרכזיה, בלי 0 בהתחלה |
caller |
המספר המתקשר, או השלוחה בשיחה יוצאת |
cnumber |
המספר שאליו התקשרו |
dnumber |
התור |
ivruniqueid |
מזהה ייחודי לשיחה |
start, totaltime |
שעת התחלה ומשך בשניות |
extension |
שלוחה |
type |
1 נכנסת, 2 יוצאת, 3 פנימית |
status |
השעה שבה נענתה השיחה ב-unix time, ו-0 כשלא נענתה |
Event |
Abandon נותקה ללא מענה, Hangup, Leave |
record |
קישור להקלטה |
transcription |
תמלול השיחה |
מה נרשם בכרטיס
שיחה שנענתה נרשמת כפעילות מסוג שיחה, עם שעת התחלה וסיום. רק שיחות כאלה נספרות בדוח ממוצע השיחות.
שיחה שלא נענתה או תא קולי נרשמים כמשימה שמופנית לאחראי על הכרטיס, ולא כפעילות שיחה. הן לא ייספרו בדוח.
הקלטה — הקישור שנשלח ב-record נשמר עם הרשומה וניתן להשמעה מהכרטיס.
כשזה לא עובד
השיחות לא נרשמות בכלל — הספק לא נבחר במסך מודולים וממשקים, או שה-webhook אצל הספק מצביע על כתובת שגויה. הכתובת חייבת לכלול את מזהה החברה ואת הטוקן.
השיחות נרשמות בלי משך — המערכת מחשבת משך משעת ההתחלה ועד הסיום. אם המרכזיה שולחת רק את אירוע תחילת השיחה ולא את אירוע הניתוק, לא יהיה משך.
כל השיחות נרשמות ככיוון אחד — ערכי direction שונים בין הספקים. שליחת inbound לספק שמצפה ל-Incoming Call לא תזוהה.
השיחה נרשמה בכרטיס הלא נכון או פתחה כרטיס חדש — הזיהוי הוא לפי מספר הטלפון. מספר שמופיע בכמה כרטיסים, או בפורמט שונה, יגיע ליעד לא צפוי.