Qulaq Qulaq
← عودة إلى المدونة
Email API

أحداث البريد الإلكتروني اللحظية عبر webhooks

ف
فريق Qulaq
خبراء التسويق عبر البريد الإلكتروني
أحداث البريد الإلكتروني اللحظية عبر webhooks

الدفع بدل السحب: ما إن تعرّف webhook حتى تُرسَل أحداث المشتركين والبريد (bounce، فتح الرسالة، شكوى…) إلى نظامك عبر POST في اللحظة نفسها، بلا polling.

الإعداد

POST /api/v1/webhooks/

أرسل حقل url وقائمة events التي ترغب في متابعتها — 12 نوعًا من الأحداث مدعومة.

الأمان

يحمل كل طلب توقيع SHA-256 HMAC في header باسم X-Qulaq-Signature؛ تحقّق منه باستخدام المفتاح السري.

الموثوقية

عند أي استجابة خارج نطاق 2xx تُعاد المحاولة 5 مرات وفق exponential backoff؛ وتجد سجلات التسليم ضمن /webhooks/{id}/deliveries/.