ווב-הוקס #
webhooks לאחר השיחה מספקים מידע על כל שיחה שהושלמה במערכת. מידע זה יכול לשמש לעדכון מערכות חיצוניות או להפעלת אוטומציות זרימת עבודה, באמצעות מוצרים כמו Azure Logic Apps או Zapier.
דוגמאות למקרי שימוש:
- הוסף אירוע היסטוריית שיחות מול רשומת CRM
- הוסף פרטי השמעת הקלטת שיחות לרשומת CRM
- תיעוד החלטות מוצלחות ב-CRM
- מעקב אחרי תלונות הלקוחות במערכת חיצונית
info
ניתן להגדיר מספר Webhooks (תלוי ברישיון) לספק מידע לאחר השיחה למערכות חיצוניות שונות לפי הצורך.
הגדרת Webhook #
אירוע #
בחר אחד או יותר מהאירועים הבאים שיפעילו את ה-webhook:
| סוג אירוע | תיאור |
|---|---|
| נוצר | ה-webhook יפעיל כאשר נוצר סשן שיחה חדש. ברגע שמושב השיחה מסתיים, ה-webhook 'Created' יפעיל ויספק את כל הפרטים על שיחת הטלפון. |
| עודכן | ה-webhook יפעיל כאשר סשן שיחה מתעדכן. זה קורה כאשר פרטי השיחה הקודמת מתעדכנים. בעיקר זה יכול לקרות ואז מתווסף מידע נוסף לשיחה לאחר סיום השיחה – כמו Disposition או Notes. |
| תומלל | ה-webhook יפעיל כאשר כל הקטעים הרלוונטיים של סשן השיחה תומללו. הפעלת ה-web hook רלוונטית רק ללקוחות המשתמשים בתכונות תמלול השיחה. |
תנאי מסנן #
כברירת מחדל, webhook יפעל בכל סשני הקריאה אלא אם כן מוחל מסנן. ניתן להוסיף מסננים לרוב מאפייני הקריאה כדי לאפשר להגביל את ה-webhook לפעול רק בקריאות 'חיצוניות', למשל, או קריאה שתואמת מספר מסוים 'DID'.
הוסף אפשרויות מסנן לפי הצורך. כאשר מתווספים מספר שדות מסנן, הם משולבים באמצעות אופרטור 'AND'.
info
למידע נוסף על סינון, ראו כאן
פעולה #
| פרמטר | אפשרויות | תיאור |
|---|---|---|
| URL | https:// | ספק HTTPS URL שהטריגר יקרא כשהוא מופעל. |
| שיטת הבקשה | GET, POST, PUT | בחר את שיטת הבקשה הנדרשת ל-webhook. |
| פורמט הבקשה | JSON, נתוני טופס | בחרו את פורמט הבקשה הנדרש ל-webhook אם נבחרים POST או PUT כשיטת בקשה. |
| נתוני מטען נוספים | זוג מפתח/ערך | במידת הצורך, ניתן להוסיף מידע סטטי נוסף למטען webhook. הזן כל נתון נוסף כזוגות מפתח/ערך לפי הצורך. |
| ניסיונות ניסיון חוזר | 0 - 10 | ברירת מחדל 1. הזן את מספר הפעמים שה-webhook צריך לנסות שוב אם בכל שלב לא מצליח |
warning
תצורת הטריגרים של Webhook נשמרת במטמון לשיפור הביצועים. כל טריגר או שינוי חדש בטריגרים קיימים עשוי לקחת עד 10 דקות עד שיתחיל לתוקף.
info
הזמן לבקשת webhook הוא 10 שניות. הזמן בין ניסיונות הניסיון שווה ל-מספר ניסיון x 2 Seconds
נתוני מטען
הטבלה למטה מציגה את הנתונים שסופקו במטען הטריגר.
| פרמטר | תיאור |
|---|---|
| טריגרID | המזהה הייחודי של הטריגר שעליו מופעלת בקשת ה-web hook. |
| id | מזהה הישות שמשתנה (User ID או Tenant Id). |
| tenantId | הלקוח מזהה שהאירוע קשור אליו. |
| CDR | מטען נתוני השיחה |
| customData | אם מוגדרים לפי הטריגר, כל מידע נוסף על מפתח/זוג ערך יועבר כאן. |
CDR נתונים
| פרמטר | תיאור |
|---|---|
| id | מזהה המושב עבור רשומת CDR. |
| dType | CDR סוג רשומה - "CloudSessionCdr" |
| sVer | CDR גרסה - 1 |
| pbxId | ~.Dimensions.~ ID עבור פלטפורמת התקשורת CDR נלקח מ-(למשל ~.pbx.kazoo.name.~) |
| pbxName | השם המוגדר של פלטפורמת התקשורת |
| tz | מזהה TZ לזמני השיחה. |
| התחל | שעת תחילת סשן השיחות. |
| ענה | הגיע הזמן שהשיחות נענו לראשונה. |
| סוף | סיום סשן השיחה. |
| dur | משך השיחה בשניות. |
| טבעת | שעת השיחה תוך שניות. |
| שיחה | שעת השיחה תוך שניות. |
| החזיקו | החזק את זמן השיחה בשניות. |
| פארק | זמן החניה של השיחה בשניות. |
| אבד | סימן האם השיחה בוטלה - 1/0 |
| לוסטין פארק | אינדיקציה האם השיחה ננטשה בזמן חניה - 1/0 |
| אבן | אינדיקציה אם השיחה הייתה שיחה קצרה וצלצול או לא - 1/0 |
| הערה | אינדיקציה אם השיחה הייתה תשובה - 1/0 |
| קצר | אינדיקציה אם השיחה נקראה כבעלת משך קצר - 1/0 |
| סיבה | תבהיר את הסיבה לשיחה. |
| מנהל | כיוון קריאה. 0 - לא ידוע, 1 - פנימי, 2 - נכנס, 3 - יוצא, 4 - שניהם |
| סוג | סוג שיחה. 0 - לא ידוע, 1 - פנימי, 2 - חיצוני |
| T2T | אינדיקציה האם השיחה הייתה שיחת טרנק לטרנק - 1/0 |
| נקרא Num | בשיחה נכנסת זה יהיה ה-DID שחייג על ידי הלקוח. בשיחה יוצאת, זה יהיה מספר הטלפון היוצא שחייג. |
| callerNum | בשיחה נכנסת, מספר הטלפון של המתקשר. בשיחה יוצאת, זה יהיה מזהה המתקשר היוצא שמוצג. |
| קלינום | מספר זיהוי מתקשר (CLI) בפורמט E.164. |
| cliName | שם המתקשר |
| קלילוק | מיקום CLI |
| קליאריה | קידומת CLI |
| קליסטייט | מדינת CLI (ארה"ב בלבד) |
| קליקטרי | מדינת CLI |
| ddiNum | DID בפורמט E.164. |
| ddiName | DID שם |
| fRngDevNum | התקשרה ראשונה למספר המכשיר. |
| fRngDevName | הטלפון הראשון, שם המכשיר. |
| lRngDevNum | טלפון טלפון אחרון. |
| lRngDevName | שם המכשיר בשעה האחרונה. |
| ansDevNum | מספר המכשיר עונה. |
| ansDevName | שם מכשיר התשובה. |
| lAnsDevNum | מספר המכשיר האחרון שעונה. |
| lAnsDevName | שם המכשיר האחרון שעונה. |
| fRngUsrNum | הטלפון הראשון צלצל למשתמש. |
| fRngUsrName | הצלצלתי לראשונה שם משתמש. |
| lrngUsrNum | מספר המשתמש בטלפון האחרון. |
| lRNGUsrName | שם משתמש ב-Last Line. |
| ansUsrNum | עונה למספר משתמש. |
| ansUsrName | עונה על שם המשתמש. |
| lAnsUsrNum | מספר המשתמש האחרון שעונה. |
| lAnsUsrName | שם משתמש שענה לאחרונה. |
| fRngAgtNum | קודם התקשרה למספר סוכן. |
| fRngAgtשם | שחיתי בטלפון ראשון, שם סוכן. |
| lrngAgtNum | טלפון אחרון של סוכן מספר. |
| lRngAgtשם | שם הסוכן בטלפון אחרון. |
| ansAgtNum | מספר סוכן עונה. |
| ansAgtName | שם הסוכן המגיב. |
| lAnsAgtNum | מספר הסוכן האחרון שעונה. |
| lAnsAgtName | שם הסוכן האחרון שעונה. |
| rteID | מספר קידומת. כל מספר שנוסף ל-CLI כקידומת במהלך ניתוב דרך פלטפורמת התקשורת. |
| rteName | שם קידומת. כל מחרוזת שנוספה לשם המתקשר כקידומת במהלך ניתוב דרך פלטפורמת התקשורת. |
| fRngGroupName | שמה של קבוצה בפעם הראשונה. |
| lRngGroupName | שם הקבוצה בדרגה האחרונה. |
| ansGroupName | שם קבוצה עונה. |
| hasRec | אינדיקציה האם השיחה הוקלטה - 1/0 |
| קצב | אינדיקציה האם השיחה קיבלה דירוג - 1/0 |
| קצב עלות | עלות הריבית (כפולה). |
| rateBand | שם הלהקה של הקצב. |
| rateName | שם השיעור חל. |
| הקלטת IDS | מערך מזהי מחרוזות לכל הקלטות הקשורות למושב הקריאה הזה. |
| התאמות מדריך | פריט ספריית אנשי הקשר מערך של כל אנשי הקשר התואמים לקריאה. |
| תגיות1 | מערך המכיל זוג מפתח/ערך של כל תגי/סידור שהוחל על הקריאה. |
| אנליטי | סיכום שיחות ונתוני נושא מתכונת Conversational Intelligence. רלוונטי רק על טריגר ה-Web hook 'מתמלל'. |
CDR פריט תיקיית יצירת קשר
| מפתח | תיאור | סוג |
|---|---|---|
| כותרת | שם איש הקשר (מר, גברת, דוקטור וכו') | מיתר |
| שם מלא | שם מלא לאיש הקשר. שם זה משמש בדוחות וב-~.UcClient.~ כדי לסייע למשתמשים לזהות מתקשרים. | מיתר |
| שם החברה | שם החברה שבה עובד איש הקשר. | מיתר |
| תפקיד | תפקיד הקשר עם החברה. | מיתר |
| טלפון 1 לטלפון4 | כתובת דוא"ל ליצירת קשר עבור איש הקשר. | E.164 |
| דוא"ל | עד 4 שדות מספרי טלפון שונים | מיתר |
| crmID | מזהה ייחודי לרשומת יצירת הקשר ממערכת חיצונית CRM | מיתר |
| שדה 1 לשדה 10 | 10 שדות לנשיאת נתונים מותאמים אישית עבור רשומת הקשר | מיתר |
tip
ניתן למצוא את ה-triggerId על ידי עריכת טריגר מוגדר בפורטל הלקוחות והעתקת GUID מסוף URL. למשל https://myreports.com/en-GB/webhooks/00000000-0000-0000-0000-000000000000
דוגמה JSON payload
דוגמה JSON פורמט מטען עבור PUT/POST:
{
"triggerId": "00000000-00000-0000-0000-00000-00000000000",
"id": "00000000-00000-0000-0000-00000-0000000000",
"tenantId": "00000000-0000-0000-0000-00000-0000000000",
"CDR": {
"id": "00000000-00000-0000-0000-00000-0000000000",
"dType": "CloudSessionCdr",
"sver": 1,
"pbxId": "00000000-00000-0000-0000-00000-0000000000",
"pbxName": "BenDV1 - Dev - Ben",
"tz": "אירופה/לונדון",
"התחל": "2024-05-29T09:37:35+01:00",
"סוף": "2024-05-29T09:37:45+01:00",
"משך": 10,
"טבעת": 10,
"אבוד": 1,
"סיבה": "נורמלי_ניקוי",
"בימים": 2,
"סוג": 2,
"קלינום": "\\u002B4470000000000",
"cliLoc": "הממלכה המאוחדת",
"cliCtry": "GB",
"ddiNum": "\\u002B441610000000",
"fRngDevNum": "user_**\*\***",
"fRngDevName": "(T42S) משתמש בדיקה",
"lRngDevNum": "user\_**\*\***",
"lRgDevName": "(משתמש בדיקה T42S)",
"fRngUsrNum": "302",
"fRngUsrName": "משתמש בדיקה",
"lRngUsrNum": "302",
"lRngUsrName": "משתמש בדיקה",
"fRngAgtNum": "302",
"fRngAgtName": "משתמש בדיקה",
"lRngAgtNum": "302",
"lRngAgtName": "משתמש בדיקה",
"hasRec": 1,
"recordingIds": ["00000000-0000-0000-0000-0000-0000000000"]["00000000-0000-0000-0000-000000000000"],
"DirectoryMatches": [{
"dirName": "הגלובלי שלי",
"dirId": "00000000-00000-00000-0000-00000000000",
"dirType": "DirectoryContactMatch",
"contactId": "00000000-0000-0000-0000-0000-00000000000",
"שדות": {
"fullName": "דוגמת איש קשר",
"שם חברה": "חברה",
"jobTitle": "Job Title",
"אימייל": "כתובת דוא"ל",
"field1": "field1",
"field2": "field2",
"field3": "field3",
"field4": "field4",
"field5": "field5",
"field6": "field6",
"field7": "field7",
"field8": "field8",
"field9": "field9",
"Field10": "301"
}][{
"dirName": "My Global",
"dirId": "00000000-0000-0000-0000-000000000000",
"dirType": "DirectoryContactMatch",
"contactId": "00000000-0000-0000-0000-000000000000",
"fields": {
"fullName": "Example Contact",
"companyName": "Company",
"jobTitle": "Job Title",
"email": "Email Address",
"field1": "field1",
"field2": "field2",
"field3": "field3",
"field4": "field4",
"field5": "field5",
"field6": "field6",
"field7": "field7",
"field8": "field8",
"field9": "field9",
"field10": "301"
}],
"תגיות": {
"תמיכה": "שלב 1"
}
"אנליטית": {
"סיכום": "סיכום תוכן שיחת השיחה.",
"priTop": "נושא ראשי",
"secTops": ["נושא נוסף 1", "נושא נוסף 2"]["Additional Topic 1", "Additional Topic 2"]
}
},
"customData": {
"הוק": "שיחה לאחר הקשר"
}
}-
נתוני סילוקציה כלולים בשדה התג של מושב הקריאה. ↩︎