> ## Documentation Index
> Fetch the complete documentation index at: https://developers.nateq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> استقبل الأحداث في الوقت الفعلي بدلاً من الاستعلام المتكرر.

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

## الإعداد

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

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

## الحمولة

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

```json theme={null}
{
  "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`                                        | التقاط عميل محتمل جديد      |

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

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

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

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

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