كل ما يستحق المعرفة، ولا شيء مما لا يستحقها.
ما هي الفعاليات التي يقدمها
أكثر نوعين شيوعًا هما إيصالات التسليم (DLRs)، التي تُبلغ عما إذا كانت كل رسالة قد وصلت إلى الهاتف وسبب فشلها، والرسائل الواردة، التي تُمكّنك من إنشاء تدفقات ثنائية الاتجاه ومعالجة طلبات STOP. راجع /answers/what-is-dlr و /answers/what-is-mo-vs-mt.
لماذا يتفوق الإرسال الفوري (push) على الاستعلام الدوري (polling)؟
يؤدي استطلاع حالة واجهة برمجة التطبيقات (API) إلى إهدار الطلبات وزيادة زمن الاستجابة؛ بينما يقوم Webhook بتسليم الحدث فور حدوثه، مما يسمح بإعادة محاولات OTP، ودعم التوجيه، والتحليلات بالاستجابة في الوقت الفعلي. راجع /developers/webhooks.
تحقق منه وقم بتأمينه
لأن أي شخص يستطيع إرسال طلب POST إلى عنوان URL عام، يجب توقيع حمولات webhook (على سبيل المثال باستخدام HMAC-SHA256) والتحقق من التوقيع قبل الوثوق بأي حدث، ويجب دائمًا تقديم نقطة النهاية عبر HTTPS. راجع /answers/hmac-sha256-dlr-signing و /tools/webhook-signature-validator.
اجعله مرنًا
أعد استجابة سريعة برمز 2xx وقم بالمعالجة بشكل غير متزامن، وتوقع إعادة المحاولات وتكرارها أحيانًا (لذا تعامل مع الأحداث بشكل متكرر)، وراقب حالات الفشل حتى لا تفوتك أي عملية تسليم دون إشعار. راجع /developers/webhooks.