1. All Collections >
  2. التكاملات >
  3. Webhook

Webhook

Avatar
Joshua Lim
less than a minute read

تتوفر خطافات الويب فقط للخطة المتقدمة وما فوق.

قم بالاتصال بأنظمة وخدمات مختلفة مثل منصات التسويق عبر البريد الإلكتروني وأدوات إدارة علاقات العملاء ومنصات التجارة الإلكترونية وبرامج إدارة المشاريع لتلقي تحديثات المنصة في الوقت الفعلي على response.io. من خلال ربط عنوان URL الخاص بـ webhook (نقطة نهاية REST) بالمنصة، يمكنك مزامنة الأحداث ذات الصلة مع أنظمة إدارة علاقات العملاء وقواعد البيانات لديك، مما يضمن معلومات دقيقة ومحدثة عبر جميع أنظمتك.

إعدادات

الخطوة 1: في إعدادات مساحة العمل الخاصة بك، انتقل إلى التكاملات > خطافات الويب > انقر فوق الاتصال

الخطوة 2: انقر فوق الزر إضافة Webhook لإضافة عنوان URL لنقطة النهاية وحدد حدث Webhook

نقطة نهاية عنوان URL المحددة ضرورية لتلقي الطلب ومعالجته.

أحداث الويب هوك

فيما يلي بعض حالات الاستخدام الشائعة لأحداث webhook:

  • تم إغلاق محادثة - في كل مرة تُغلق محادثة، يتم تحديث تفاصيل جهة الاتصال تلقائيًا أو حفظ تفاصيل المحادثة في تطبيق/نظام طرف ثالث لأغراض الأرشفة، ويتم تتبع عدد المحادثات المغلقة لأغراض التحليل.

  • جهة اتصال جديدة - في كل مرة تُضاف جهة اتصال جديدة، تُضاف تلقائيًا إلى CRM، وتُرسل رسائل ترحيب، ويُخطر أعضاء الفريق بوجود جهات اتصال جديدة.

  • رسالة صادرة جديدة - في كل مرة تُرسل رسالة صادرة جديدة، تُرسل إشعارات تلقائيًا لكل رسالة، وتُسجَّل تفاصيل الرسالة في CRM، وتُعيَّن علامات أو تُحتَسب درجات العملاء المحتملين بناءً على محتوى الرسالة.

  • رسالة واردة جديدة - في كل مرة تتلقى رسالة واردة جديدة، تُرسل إشعارات تلقائيًا لكل رسالة واردة، وتُسجَّل تفاصيل الرسالة في CRM، وتُعيَّن علامات أو تُحتَسب درجات العملاء المحتملين بناءً على محتوى الرسالة.

  • تم تحديث جهة الاتصال - في كل مرة يتم فيها تحديث جهة اتصال، يتم تلقائيًا تحديث معلوماتها في CRM وإرسال إشعارات لأعضاء الفريق المعنيين بالتغييرات.

  • تم فتح محادثة - في كل مرة تُفتح محادثة، يتم إخطار أعضاء الفريق تلقائيًا بالمحادثات الجديدة مع العملاء في الوقت الفعلي وفتح تفاصيل المحادثة.

  • تم تحديث مسؤول جهة الاتصال - في كل مرة يتغير المكلف بجهة الاتصال، يُبلَّغ أعضاء الفريق تلقائيًا عند تعيين جهة اتصال جديدة لهم وتُدار مهام المتابعة أو التذكيرات.

  • تم تحديث علامة جهة الاتصال - في كل مرة تُحدَّث علامة جهة الاتصال، تُحدَّث تلقائيًا درجات العملاء المحتملين، وتُدار قوائم التسويق عبر البريد الإلكتروني وتُرسل حملات تسويقية مستهدفة بناءً على علامات جهات الاتصال.

  • تعليق جديد - في كل مرة يُضاف تعليق جديد، يتم إخطار أعضاء الفريق تلقائيًا بالتعليقات الجديدة وتتم مزامنة التعليقات بين respond.io وأنظمة أخرى.

  • انتهاء المكالمة (المكالمات الصوتية) – في كل مرة تنتهي فيها مكالمة صوتية (سواء تم إتمامها أو لم يتم الرد عليها)، تُرسل تلقائيًا البيانات المتعلقة بالمكالمة إلى أنظمتك الخارجية مثل CRM أو أدوات التحليل أو منصات التقارير الداخلية. قد تتضمن هذه البيانات حالة المكالمة، مدتها، تفاصيل الوكيل أو الوكيل الصوتي المدعوم بالذكاء الاصطناعي، وإذا تم تفعيل ذلك - تسجيلات المكالمات، نصوصها، وملخصات المكالمات.

تعرف على المزيد حول المعلومات التي يمكن تمريرها باستخدام أحداث Webhook هذه في وثائق Webhooks API الخاصة بنا هنا.

الأسئلة المتكررة وحل المشكلات

لماذا يستمر تعطيل Webhook الخاص بي تلقائيًا وكيف يمكنني إعادة تفعيله؟

قد يتم تعطيل Webhook الخاص بك تلقائيًا إذا تجاوز عدد المحاولات الفاشلة الحد المسموح به وهو 30 خطأ خلال 30 دقيقة. تجدر الإشارة إلى أن حصة الأخطاء هذه مشتركة بين جميع Webhooks. إذا حدث ذلك، ستتلقى إشعارًا عبر البريد الإلكتروني بشأن الفشل. لتجنب التعطيل، راقب سجلات نقطة النهاية لديك بانتظام لرصد أحداث Webhook الفاشلة.

بالإضافة إلى ذلك، يجب على نقطة النهاية أن تعيد استجابة 200 OK خلال 5 ثوانٍ. سيُحتسب عدم الامتثال ضمن حد الأخطاء الخاص بك وقد يؤدي إلى تعطيل تلقائي.

لإعادة تفعيل Webhook الخاص بك، اتبع الخطوات التالية:

  1. انتقل إلى إعدادات مساحة العمل

  2. انتقل إلى التكاملات > Webhooks

  3. ابحث عن Webhook الخاص بك وانقر على 'تفعيل' في عمود الإجراءات

لعرض سجلات أحداث Webhook، يمكنك التصويت لطلب الميزة هنا.

لماذا تتأخر Webhooks الخاصة بي من respond.io؟

تحدث التأخيرات إذا لم تستجب نقطة النهاية الخاصة بك خلال 5 ثوانٍ، مما يتسبب في إعادة محاولة نظام Webhook الخاص بنا ووضع الأحداث في قائمة الانتظار. إليك كيفية عمل إعدادنا:

  • نقوم بتجميع الأحداث حسب نقطة النهاية لمنع أي نقطة نهاية من تحميل النظام.

  • تتم معالجة الأحداث بالترتيب، وإذا استغرقت نقطة النهاية وقتًا طويلاً للرد، فستحدث محاولات إعادة بعد 30 و60 و90 ثانية، حتى حد أقصى 3 دقائق قبل استبعاد الحدث.

لتجنب التأخيرات، نوصي بتحسين كيفية تعامل نظامك مع Webhooks الواردة. سيساعد ذلك في ضمان تسليم الأحداث في الوقت المناسب.

لماذا لا أرى تسجيلات المكالمات أو نسخ المحادثات أو الملخصات في الحمولة الخاصة بـWebhook؟

تعتمد بيانات المكالمات في أحداث Webhook على إعدادات مساحه عملك. إذا تم تعطيل تسجيل المكالمات أو النصوص أو ملخصات المكالمات، فستُرجع الحقول المقابلة بقيمة null أو تُحذف من الحمولة. المكالمات الفائتة لا تتضمن تسجيلات أو نصوصًا أو ملخصات.

مشاركة هذه المقالة
Telegram
Facebook
Linkedin
Twitter

لا يمكن العثور على ما تبحث عنه؟ 🔎