ويبهوكس

ويبهوكس #

توفر webhooks بعد المكالمة معلومات عن كل مكالمة تم إكمالها على النظام. يمكن استخدام هذه المعلومات لتحديث الأنظمة الخارجية أو بدء أتمتة تدفق العمل، باستخدام منتجات مثل Azure Logic Apps أو Zapier.

أمثلة على حالات الاستخدام:

  • أضف حدث سجل مكالمات مقابل سجل CRM
  • أضف تفاصيل تشغيل تسجيل المكالمات إلى سجل CRM
  • سجل القرارات الناجحة في CRM
  • تتبع شكاوى العملاء في نظام خارجي
Information Circle info
يمكن تكوين عدة Webhooks (حسب الترخيص) لتوفير معلومات ما بعد الاستدعاء لأنظمة خارجية مختلفة حسب الحاجة.

تكوين Webhook #

الحدث #

اختر واحدا أو أكثر من الأحداث التالية التي ستفعل webhook:

نوع الحدث الوصف
تأسيس سيعمل webhook عند إنشاء جلسة اتصال جديدة. بمجرد اكتمال جلسة الاتصال، سيعمل webhook 'Created' مع توفير جميع التفاصيل المتعلقة بالمكالمة الهاتفية.
تحديث سيعمل webhook عند تحديث جلسة الاتصال. يحدث هذا عندما يتم تحديث تفاصيل مكالمة سابقة. بشكل أساسي، يمكن أن يحدث هذا بعد إضافة معلومات إضافية إلى المكالمة بعد الانتهاء، مثل التوزيع أو الملاحظات.
تم النسخ سيعمل webhook عندما يتم نسخ جميع المقاطع القابلة للتطبيق من جلسة المكالمة. هذا التفعيل الخاص ب web hook مخصص فقط للعملاء الذين يستخدمون ميزات نسخ المكالمة.

شروط المرشح #

افتراضيا، سيعمل webhook لجميع جلسات الاستدعاء ما لم يتم تطبيق فلتر. يمكن إضافة فلاتر لمعظم خصائص الاستدعاء للسماح بتقييد webhook على الإطلاق فقط على المكالمات 'الخارجية' مثلا، أو استدعاءات تطابق رقم 'DID' المحدد.

أضف خيارات المرشح حسب الحاجة. عند إضافة عدة حقول مرشح، يتم دمجها باستخدام عامل 'AND'.

Information Circle info
لمزيد من المعلومات حول التصفية، يرجى الرجوع إلى here

الحدث #

المعلمة الخيارات الوصف
URL https:// قدم HTTPS URL حيث سيستدعي الزناد عند إطلاقه.
طريقة الطلب GET, POST, PUT اختر طريقة الطلب المطلوبة لهوك الويب.
صيغة الطلب JSON, بيانات النماذج اختر تنسيق الطلب المطلوب لwebhook إذا تم اختيار POST أو PUT كطريقة الطلب.
بيانات إضافية للحمولة زوج المفتاح/القيمة إذا لزم الأمر، يمكن إضافة معلومات ثابتة إضافية إلى حمولة webhook. أدخل أي بيانات إضافية كأزواج مفاتيح/قيم حسب الحاجة.
محاولات إعادة المحاولة 0 - 10 الإعداد الافتراضي 1. أدخل عدد المرات التي يجب أن يعيد فيها الرابط المحاولة إذا لم ينجح في أي لحظة
Hand Left warning
يتم تخزين إعدادات مشغل Webhook مؤقتا لتحسين الأداء. أي مشغلات جديدة أو تغييرات على المحفزات الحالية قد تستغرق حتى 10 دقائق قبل أن تبدأ في التفعيل.
Information Circle info
المهلة لطلب webhook هي 10 ثوان. الوقت بين محاولات إعادة المحاولة يساوي <رقم المحاولة c0> x 2 Second</c0>

بيانات الحمولة

يوضح الجدول أدناه البيانات المقدمة في حمولة المحفز.

المعلمة الوصف
triggerID المعرف الفريد للمحفز الذي يتم تفعيل طلب الرابط الإلكتروني من أجله.
معرف معرف الكيان الذي يتغير (معرف المستخدم أو معرف المستأجر).
معرف المستأجر معرف المستأجر العميل الذي يرتبط به الحدث.
CDR حمولة بيانات النداء
customData إذا تم تكوينه مقابل الزناد، سيتم تمرير أي معلومات إضافية عن مفاتيح/زوج القيم هنا.

CDR البيانات

المعلمة الوصف
معرف معرف الجلسة لسجل CDR.
dType CDR نوع السجل - "CloudSessionCdr"
sVer CDR الإصدار - 1
pbxId ~.Dimensions.~ معرف لمنصة الاتصالات 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
يدعى نوم في المكالمة الواردة، سيكون هذا هو DID الذي يتصل به العميل. في المكالمة الصادرة، سيكون هذا هو رقم الهاتف الصادر الذي يتم الاتصال به.
callerNum في مكالمة واردة سيكون هذا رقم هاتف المتصل. في المكالمة الصادرة، سيكون هذا هو معرف المتصل الصادر الذي يتم تقديمه.
كلينوم رقم معرف المتصل (CLI) بصيغة E.164.
كلي نيم اسم المتصل
كلي لوك موقع CLI
كلي آريا رمز منطقة CLI
كليستيت ولاية CLI (الولايات المتحدة فقط)
كليكتري دولة CLI
ddiNum DID بصيغة E.164.
ddiName DID name
fRngDevNum أول اتصلت برقم الجهاز.
fRngDevName أول رنين لي اسم الجهاز.
lRNGDevNum آخر اتصال رقم الجهاز.
lRngDevName آخر هاتف اسمي للجهاز.
ansDevNum أرد على رقم الجهاز.
ansDevName اسم جهاز الرد.
lAnsDevNum آخر جهاز يرد عليه.
lAnsDevName آخر اسم جهاز للرد.
fRngUsrNum اتصل أول من برقم المستخدم.
fRngUsrName اسم المستخدم في البلاغ الأول.
lrngUsrNum رقم المستخدم في Last Call.
lRNGUsrName اسم المستخدم في الدرجة الأخيرة.
ansUsrNum أجيب على رقم المستخدم.
ansUsrName أجيب على اسم المستخدم.
lAnsUsrNum آخر رقم مستخدم يجيب عليه.
lAnsUsrName آخر إجابة باسم المستخدم.
fRngAgtNum اتصل أولا برقم العميل.
fRngAgtName اتصلت أولا باسم العميل.
lrnAgtNum آخر اتصال برقم العميل.
lRngAgtName آخر هاتف اسمي عميل.
ansAgtNum رقم الوكيل يرد.
ansAgtName اسم العميل يرد.
lAnsAgtNum آخر موظف يجيب رقم الوكيل.
اسم ال lAnsAgt آخر اسم وكيل للإجابة.
rteID رقم بادئة. أي رقم يضاف إلى واجهة القيادة كبادئة أثناء التوجيه عبر منصة الاتصالات.
rteName اسم البادئة. أي سلسلة نصية تضاف إلى اسم المتصل كبادئة أثناء التوجيه عبر منصة الاتصالات.
fRngGroupName اسم المجموعة في الدرجة الأولى.
lRngGroupName اسم المجموعة في الدرجة الأخيرة.
ansGroupName اسم المجموعة للرد.
hasRec إشارة إلى ما إذا كانت المكالمة مسجلة - 1/0
المعدل الإشارة إلى ما إذا كانت المكالمة قد تم تقييمها - 1/0
السعر التكلفة تكلفة السعر (الضعف).
rateBand اسم الفرقة للسعر.
rateName كان اسم السعر ينطبق.
recordingIds مصفوفة سلاسل من معرفات التعريف لأي تسجيلات مرتبطة بجلسة الاستدعاء هذه.
مطابقات الدليل عنصر دليل جهات الاتصال مصفوفة لأي جهات اتصال مطابقة للمكالمة.
الوسوم1 مصفوفة تحتوي على زوج مفتاح/قيمة لأي وسوم/ترتيبات مطبقة على النداء.
تحليلي ملخص المكالمات وبيانات الموضوع من ميزة الذكاء المحادثي. ينطبق فقط على مشغل الخطاف 'المنقول'.

CDR عنصر دليل الاتصال

مفتاح الوصف النوع
العنوان عنوان جهة الاتصال (سيد، سيدة، دكتور، إلخ) الوتر
الاسم الكامل الاسم الكامل لجهة الاتصال. يستخدم هذا في التقارير و~.UcClient.~ عملاء لمساعدة المستخدمين على تحديد المتصلين. الوتر
اسم الشركة اسم الشركة التي يعمل بها الاتصال. الوتر
المسمى الوظيفي وظيفة الاتصال مع الشركة. الوتر
من Phone1 إلى Phone4 عنوان بريد إلكتروني للتواصل الخاص بجهة الاتصال. E.164
البريد الإلكتروني حتى 4 حقول مختلفة لأرقام الهاتف الوتر
crmID معرف فريد لسجل الاتصال من نظام خارجي CRM الوتر
من الحقل 1 إلى 10 10 حقول لحمل أي بيانات مخصصة لسجل جهات الاتصال الوتر
Color Wand tip
يمكن العثور على <معرف > triggerId</c0> عن طريق تحرير مشغل مكون في بوابة العملاء ونسخ GUID من نهاية URL. مثلا https://myreports.com/en-GB/webhooks/00000000-0000-0000-0000-000000000000

مثال JSON payload

مثال JSON تنسيق الحمولة لطلبات PUT/POST:

 
{ 
    "triggerId": "00000000-0000-0000-0000-0000-000000000000"، 
    "المعرف": "00000000-0000-0000-0000-0000000000000" 
    "tenantId": "00000000-00000-0000-0000-00000-000000000000"، 
    "CDR": { 
        "المعرف": "00000000-0000-0000-0000-0000000000000" 
        "dType": "CloudSessionCdr", 
        "sVer": 1, 
        "pbxId": "00000000-0000-0000-0000-00000000000"، 
        "pbxName": "BenDV1 - ديف - بن"، 
        "tz": "أوروبا/لندن", 
        "ابدأ": "2024-05-29T09:37:35+01:00", 
        "النهاية": "2024-05-29T09:37:45+01:00", 
        "المدة": 10, 
        "خاتم": 10, 
        "ضائع": 1, 
        "السبب": "طبيعي_تنظيف"، 
        "المدير": 2، 
        "النوع": 2، 
        "كلينوم": "\\u002B4470000000000", 
        "كليلوك": "المملكة المتحدة", 
        "cliCtry": "GB", 
        "ddiNum": "\\u002B441610000000", 
        "fRngDevNum": "المستخدم_**\*\***", 
        "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-00000-0000000000"]["00000000-0000-0000-0000-000000000000"], 
        "Directory Matches": [{ 
            "dirName": "عالمي الخاص", 
            "dirId": "00000000-00000-0000-00000-0000000000000"، 
            "dirType": "DirectoryContactMatch", 
            "معرف الاتصال": "00000000-0000-0000-0000-00000-0000000000"، 
            "الحقول": { 
            "الاسم الكامل": "مثال على جهة الاتصال", 
            "اسم الشركة": "الشركة", 
            "مسمى الوظيفة": "مسمى الوظيفة", 
            "البريد الإلكتروني": "عنوان البريد الإلكتروني", 
            "الحقل1": "الحقل1", 
            "الحقل2": "الحقل2", 
            "فيلد3": "فيلد3", 
            "فيلد4": "فيلد4", 
            "field5": "field5", 
            "فيلد6": "فيلد6"، 
            "فيلد7": "فيلد7", 
            "فيلد8": "فيلد8", 
            "فيلد9": "فيلد9"، 
            "فيلد10": "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. يتم تضمين بيانات التوزيع مع حقل العلامة في جلسة الاستدعاء. ↩︎