ווב-הוקס

ווב-הוקס #

webhooks לאחר השיחה מספקים מידע על כל שיחה שהושלמה במערכת. מידע זה יכול לשמש לעדכון מערכות חיצוניות או להפעלת אוטומציות זרימת עבודה, באמצעות מוצרים כמו Azure Logic Apps או Zapier.

דוגמאות למקרי שימוש:

  • הוסף אירוע היסטוריית שיחות מול רשומת CRM
  • הוסף פרטי השמעת הקלטת שיחות לרשומת CRM
  • תיעוד החלטות מוצלחות ב-CRM
  • מעקב אחרי תלונות הלקוחות במערכת חיצונית
Information Circle info
ניתן להגדיר מספר Webhooks (תלוי ברישיון) לספק מידע לאחר השיחה למערכות חיצוניות שונות לפי הצורך.

הגדרת Webhook #

אירוע #

בחר אחד או יותר מהאירועים הבאים שיפעילו את ה-webhook:

סוג אירוע תיאור
נוצר ה-webhook יפעיל כאשר נוצר סשן שיחה חדש. ברגע שמושב השיחה מסתיים, ה-webhook 'Created' יפעיל ויספק את כל הפרטים על שיחת הטלפון.
עודכן ה-webhook יפעיל כאשר סשן שיחה מתעדכן. זה קורה כאשר פרטי השיחה הקודמת מתעדכנים. בעיקר זה יכול לקרות ואז מתווסף מידע נוסף לשיחה לאחר סיום השיחה – כמו Disposition או Notes.
תומלל ה-webhook יפעיל כאשר כל הקטעים הרלוונטיים של סשן השיחה תומללו. הפעלת ה-web hook רלוונטית רק ללקוחות המשתמשים בתכונות תמלול השיחה.

תנאי מסנן #

כברירת מחדל, webhook יפעל בכל סשני הקריאה אלא אם כן מוחל מסנן. ניתן להוסיף מסננים לרוב מאפייני הקריאה כדי לאפשר להגביל את ה-webhook לפעול רק בקריאות 'חיצוניות', למשל, או קריאה שתואמת מספר מסוים 'DID'.

הוסף אפשרויות מסנן לפי הצורך. כאשר מתווספים מספר שדות מסנן, הם משולבים באמצעות אופרטור 'AND'.

Information Circle info
למידע נוסף על סינון, ראו כאן

פעולה #

פרמטר אפשרויות תיאור
URL https:// ספק HTTPS URL שהטריגר יקרא כשהוא מופעל.
שיטת הבקשה GET, POST, PUT בחר את שיטת הבקשה הנדרשת ל-webhook.
פורמט הבקשה JSON, נתוני טופס בחרו את פורמט הבקשה הנדרש ל-webhook אם נבחרים POST או PUT כשיטת בקשה.
נתוני מטען נוספים זוג מפתח/ערך במידת הצורך, ניתן להוסיף מידע סטטי נוסף למטען webhook. הזן כל נתון נוסף כזוגות מפתח/ערך לפי הצורך.
ניסיונות ניסיון חוזר 0 - 10 ברירת מחדל 1. הזן את מספר הפעמים שה-webhook צריך לנסות שוב אם בכל שלב לא מצליח
Hand Left warning
תצורת הטריגרים של Webhook נשמרת במטמון לשיפור הביצועים. כל טריגר או שינוי חדש בטריגרים קיימים עשוי לקחת עד 10 דקות עד שיתחיל לתוקף.
Information Circle 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 שדות לנשיאת נתונים מותאמים אישית עבור רשומת הקשר מיתר
Color Wand 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": { 
        "הוק": "שיחה לאחר הקשר" 
    }
}

  1. נתוני סילוקציה כלולים בשדה התג של מושב הקריאה. ↩︎