الانتقال إلى المحتوى الرئيسي
ترسل الـ 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.