companyLogo

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.

التوثيق

إيكو من ibotek