Webhooks: أحداث موقعة وإعادة المحاولة
حدّد عنوان webhook لتطبيقك. يرسل Echo إليه أحداث JSON ويعيد المحاولة لمدة يوم إذا كان خادمك متوقفاً.
- echo.message.sent
- غادرت رسالة الجهاز.
- echo.message.failed
- تعذّر إرسال رسالة.
- echo.message.received
- وصلت رسالة إلى أحد هواتفك أو أرقامك.
- echo.verification.approved
- تمت الموافقة على عملية تحقق.
- echo.call.completed
- رنّت مكالمة.
- echo.call.failed
- فشلت مكالمة.
تحقق من التوقيع
كل إرسال يحمل ترويسة Echo-Signature: t=<الوقت>,v1=<HMAC-SHA256 لـ t.body بسرّ الـ webhook>. تحقق منها وارفض أي شيء أقدم من 5 دقائق.
- أجب بأي رمز 2xx خلال 5 ثوانٍ؛ ونفّذ العمل البطيء لاحقاً.
- قد يصل الحدث مرتين: استخدم ترويسة Echo-Event-Id لتجاهل التكرار.
- لا تحمل الـ webhooks رموزاً أو نصوص رسائل أبداً. اقرأ النص عبر الـ API.
