ويبهوكس #
توفر webhooks بعد المكالمة معلومات عن كل مكالمة تم إكمالها على النظام. يمكن استخدام هذه المعلومات لتحديث الأنظمة الخارجية أو بدء أتمتة تدفق العمل، باستخدام منتجات مثل Azure Logic Apps أو Zapier.
أمثلة على حالات الاستخدام:
- أضف حدث سجل مكالمات مقابل سجل CRM
- أضف تفاصيل تشغيل تسجيل المكالمات إلى سجل CRM
- سجل القرارات الناجحة في CRM
- تتبع شكاوى العملاء في نظام خارجي
info
يمكن تكوين عدة Webhooks (حسب الترخيص) لتوفير معلومات ما بعد الاستدعاء لأنظمة خارجية مختلفة حسب الحاجة.
تكوين Webhook #
الحدث #
اختر واحدا أو أكثر من الأحداث التالية التي ستفعل webhook:
| نوع الحدث | الوصف |
|---|---|
| تأسيس | سيعمل webhook عند إنشاء جلسة اتصال جديدة. بمجرد اكتمال جلسة الاتصال، سيعمل webhook 'Created' مع توفير جميع التفاصيل المتعلقة بالمكالمة الهاتفية. |
| تحديث | سيعمل webhook عند تحديث جلسة الاتصال. يحدث هذا عندما يتم تحديث تفاصيل مكالمة سابقة. بشكل أساسي، يمكن أن يحدث هذا بعد إضافة معلومات إضافية إلى المكالمة بعد الانتهاء، مثل التوزيع أو الملاحظات. |
| تم النسخ | سيعمل webhook عندما يتم نسخ جميع المقاطع القابلة للتطبيق من جلسة المكالمة. هذا التفعيل الخاص ب web hook مخصص فقط للعملاء الذين يستخدمون ميزات نسخ المكالمة. |
شروط المرشح #
افتراضيا، سيعمل webhook لجميع جلسات الاستدعاء ما لم يتم تطبيق فلتر. يمكن إضافة فلاتر لمعظم خصائص الاستدعاء للسماح بتقييد webhook على الإطلاق فقط على المكالمات 'الخارجية' مثلا، أو استدعاءات تطابق رقم 'DID' المحدد.
أضف خيارات المرشح حسب الحاجة. عند إضافة عدة حقول مرشح، يتم دمجها باستخدام عامل 'AND'.
info
لمزيد من المعلومات حول التصفية، يرجى الرجوع إلى here
الحدث #
| المعلمة | الخيارات | الوصف |
|---|---|---|
| URL | https:// | قدم HTTPS URL حيث سيستدعي الزناد عند إطلاقه. |
| طريقة الطلب | GET, POST, PUT | اختر طريقة الطلب المطلوبة لهوك الويب. |
| صيغة الطلب | JSON, بيانات النماذج | اختر تنسيق الطلب المطلوب لwebhook إذا تم اختيار POST أو PUT كطريقة الطلب. |
| بيانات إضافية للحمولة | زوج المفتاح/القيمة | إذا لزم الأمر، يمكن إضافة معلومات ثابتة إضافية إلى حمولة webhook. أدخل أي بيانات إضافية كأزواج مفاتيح/قيم حسب الحاجة. |
| محاولات إعادة المحاولة | 0 - 10 | الإعداد الافتراضي 1. أدخل عدد المرات التي يجب أن يعيد فيها الرابط المحاولة إذا لم ينجح في أي لحظة |
warning
يتم تخزين إعدادات مشغل Webhook مؤقتا لتحسين الأداء. أي مشغلات جديدة أو تغييرات على المحفزات الحالية قد تستغرق حتى 10 دقائق قبل أن تبدأ في التفعيل.
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 حقول لحمل أي بيانات مخصصة لسجل جهات الاتصال | الوتر |
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": {
"هوك": "ما بعد الاتصال"
}
}-
يتم تضمين بيانات التوزيع مع حقل العلامة في جلسة الاستدعاء. ↩︎