Webhooks

ترسل الـ Webhooks الأحداث إلى عنوان URL تتحكم به في اللحظة التي يحدث فيها شيء في مساحة عملك، فلا تضطر إلى استعلام الـ API.

الإعداد

أنشئ webhook من الإعدادات → المطوّرون → Webhooks (أو عبر الـ API بمفتاح webhooks:manage). أنت تقدم:

عنوان URL لاستقبال طلبات POST
الأحداث التي تريد الاشتراك بها
سر توقيع مُولَّد

الحمولة

كل عملية تسليم هي طلب POST بالجسم التالي:

{
  "event": "ticket.created",
  "timestamp": "2026-06-30T12:00:00Z",
  "organization_id": "org_...",
  "data": { /* the resource */ },
  "metadata": { "delivery_id": "...", "attempt": 1, "version": "1.0" }
}

الأحداث المتاحة

الحدث	يُطلَق عند
`conversation.started`	بدء محادثة جديدة
`conversation.ended`	إغلاق محادثة
`conversation.assigned`	تعيين محادثة
`message.received`	وصول رسالة واردة
`message.sent`	إرسال رسالة صادرة
`ticket.created` / `ticket.updated` / `ticket.closed`	دورة حياة التذكرة
`broadcast.sent` / `broadcast.failed`	نتيجة البثّ
`user.created`	إنشاء مستخدم في مساحة العمل
`lead.created`	التقاط عميل محتمل جديد

يمكنك جلب القائمة الحية والموثوقة في أي وقت من GET /api/v1/webhooks/events.

التحقق من التواقيع

يتم توقيع كل طلب بـ HMAC-SHA256 باستخدام سر الـ webhook الخاص بك. أعد حساب التوقيع على جسم الطلب الخام وقارنه بترويسة التوقيع قبل الوثوق بأي حمولة. ارفض أي شيء لا يتطابق.

إعادة المحاولات

تُعاد محاولة عمليات التسليم الفاشلة بتراجع أُسي. افحص سجل التسليم والاستجابات عبر GET /api/v1/webhooks/{id}/logs.

ابدأ من هنا

حزم التطوير

المنصة

الإعداد

الحمولة

الأحداث المتاحة

التحقق من التواقيع

إعادة المحاولات

​الإعداد

​الحمولة

​الأحداث المتاحة

​التحقق من التواقيع

​إعادة المحاولات

الإعداد

الحمولة

الأحداث المتاحة

التحقق من التواقيع

إعادة المحاولات