مشكلات تسليم Webhook
Webhooks لا تصل، أو تفشل في التحقق، أو تصل متأخرة، أو تصل مرتين، مع ما يُفحص في Recent deliveries.
ما الذي ستحققه
ستعرف لماذا يغيب webhook أو يُرفَض.
انظر أولًا إلى Recent deliveries
افتح الـ webhook واقرأ Recent deliveries. يعرض صف المكالمة رمز الحالة وأي خطأ، ويخبرك بمعظم ما تحتاجه.
الأعراض
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
| لا تسليمات إطلاقًا | لا يرسل الوكيل إلى هذا الـ webhook، أو أن Webhook معطّل في Tools الخاصة به | افتح الوكيل، Tools، Built-in، فعّل Webhook واخترْه تحت Send to |
| لم يُرسَل لمكالمة | لم تنتهِ المكالمة، أو لم تُجرَ المراجعة بعد | انتظر مراجعة المكالمة؛ يُرسَل call.completed حالما تتم |
call.started أو tool.called لا يصلان أبدًا | الحدث غير محدَّد تحت Events، أو الـ Webhook موقوف، أو بدأت المكالمة قبل أن تحدّده، أو الوكيل لا يرسل إلى هذا الـ Webhook | حدّده، وفعّل الـ Webhook، واحفظ، وأجرِ مكالمة جديدة |
تغيب بعض أحداث tool.called عن مكالمة كثيرة النشاط | كان أكثر من 50 حدثًا في الانتظار لأن نقطة اتصالك ردّت ببطء | أجب بـ 2xx سريعًا وأنجز العمل بعد ذلك |
| حالة 401 أو 403 في الصف | رفضت نقطة اتصالك الطلب | تحقق من المصادقة لديك؛ ولا تُعاد محاولات 4xx |
| حالة 5xx أو انتهاء المهلة | فشل خادمك أو كان بطيئًا جدًا | أصلحه، أو ارفع Timeout؛ وتُعاد محاولات 5xx وانتهاء المهلة حتى Attempts |
| خطأ بشأن العنوان | عنوان URL خاص أو داخلي، أو ليس http(s) | استخدم عنوانًا عامًا |
| التوقيع لا يطابق | جسم أُعيد تسلسله، أو ترويسة خاطئة، أو سر خاطئ | راجع تحقق من توقيعات webhook |
| الاختبار يعمل، والمكالمات الحقيقية لا | الوكيل لا يرسل إلى هذا الـ Webhook، أو الـ Webhook موقوف، أو بدأت المكالمة قبل الحفظ | تحقق من Send to الخاص بالوكيل ومن أن الـ Webhook يعمل، وأجرِ مكالمة جديدة |
| تصل المكالمة نفسها مرتين | إعادة محاولة بعد رد بطيء | أجب بـ 2xx سريعًا وتجاهل call_id المكرر |
| ينقص الـ payload قسم | لم يُحدَّد تحت What to send | حدّده واحفظ |
يصل مع review.status بقيمة pending | لم تنتهِ المراجعة | اجلب المكالمة لاحقًا من API للحصول على المراجعة الكاملة |
الاختبار
اختر Send test وراقب الصف الجديد في Recent deliveries. ثم أجرِ مكالمة حقيقية قصيرة.
النتيجة المتوقعة
صف معلَّم بأنه نجح بحالة 200 لكل مكالمة منتهية.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.