نظرة عامة
عنوان الاستقبال هو عنوان يستقبل عليه نظامك. يرسل RevoplyAI إليه كل حدث تختاره بصيغة JSON لحظة حدوثه، موقّعًا بمفتاح لا يعرفه سواك وسوى RevoplyAI.
ما ستحققه
- إضافة عنوان استقبال واختيار أحداثه.
- معرفة طريقة التحقق من التوقيع.
- معرفة ما يحدث عند إخفاق الإرسال.
لمن هذا الدليل
المطوّرون والمسؤولون الذين يربطون RevoplyAI بنظام العملاء أو بنظامهم الخاص، في باقة Business.
قبل أن تبدأ
- باقة Business.
- عنوان يبدأ بـ https:// ويمكن الوصول إليه من الإنترنت.
أضف عنوان استقبال
الخطوة 1: افتح إشعارات الأحداث
افتح التكاملات واختر إشعارات الأحداث (Webhooks). اختر إضافة عنوان استقبال 1. ويعرض العدّاد 2 0 من أصل 10 في هذه الباقة. ويشرح قسم التحقق من توقيعنا 3 طريقة التحقق من كل طلب.
فتح بالحجم الكاملإشعارات الأحداث قبل أول عنوان.
- 1إضافة عنوان استقبال
- 2العناوين المستخدمة
- 3التحقق من توقيعنا
الخطوة 2: اختر الأحداث
في نافذة إضافة العنوان، أعطه اسمًا (اختياري) وعنوان الاستقبال، ويجب أن يبدأ بـ https://. وتحت الأحداث حدّد ما يهم نظامك أن يعرفه، أو استخدم تحديد الكل وإلغاء التحديد 1. هناك 16 حدثًا 2، لكل منها اسمه البرمجي، مثل رسالة واردة (message.received) وتحويل إلى فريقك (conversation.handover) وتأهيل عميل محتمل (lead.qualified) وحجز موعد (appointment.booked).
فتح بالحجم الكاملالأحداث في نافذة إضافة عنوان استقبال.
- 1تحديد الكل وإلغاء التحديد
- 2الأحداث
أحداث الرسائل الجماعية تخص الرسائل الجماعية المنشأة عبر الواجهة البرمجية فقط.
تحقق من التوقيع
الخطوة 3: تحقق من كل طلب
اختر اعرض الطريقة تحت التحقق من توقيعنا لرؤية مثال برمجي. يحمل كل طلب ترويسة X-Revoply-Signature. يحسب نظامك HMAC SHA-256 للطابع الزمني والمحتوى الخام بمفتاح العنوان، ويرفض أي طلب وُقّع قبل أكثر من 5 دقائق. وأثناء تبديل المفتاح يُقبل أي من التوقيعين.
الخطوة 4: عند إخفاق الإرسال
تحت عند إخفاق الإرسال 1: يعيد RevoplyAI المحاولة بعد دقيقة، ثم بعد 5 دقائق، ثم 30 دقيقة، ثم ساعتين، ثم 6 ساعات، ثم 12 ساعة، ثم 24 ساعة، ثم يتوقف. ويمكنك إعادة إرسال أي حدث من سجل الإرسال. وإذا ردّ العنوان بالرمز 410 (Gone)، أو أخفق 100 مرة متتالية أو طوال 3 أيام، يُوقف ويُراسَل مالك الحساب بالبريد الإلكتروني.
فتح بالحجم الكاملالمثال البرمجي وقواعد إعادة المحاولة.
- 1عند إخفاق الإرسال
النتيجة المتوقعة
يستقبل نظامك الأحداث التي اخترتها، ويستطيع التأكد أن كلًا منها صادر من RevoplyAI ولم يُعدّل في الطريق.
حل المشكلات
أُوقف عنوان الاستقبال.
ردّ بالرمز 410 (Gone)، أو أخفق 100 مرة متتالية أو طوال 3 أيام. أصلح العنوان وفعّله مجددًا، وأعد إرسال ما فاتك من سجل الإرسال.
يفشل التحقق من التوقيع.
احسب التوقيع على المحتوى كما وصل تمامًا قبل تحليل JSON، واستخدم مفتاح التوقيع كاملًا.
ما زلت بحاجة إلى مساعدة؟
يرد شخص حقيقي على كل رسالة. أخبرنا بالصفحة التي كنت فيها وما ظهر لك.