# إعداد خطافات الويب (Webhooks)

> اضبط BroadNet لإرسال إيصالات التسليم (DLR) والرسائل الواردة (MO) عبر POST إلى عنوان HTTPS الخاص بك، لتتابع الحالة النهائية لكل رسالة دون استعلام متكرر. أكّد الاستلام بسرعة بالرمز HTTP 200 وعالج البيانات بشكل غير متزامن.

- الرابط الأساسي: https://www.broadnet.me/ar/developers/webhooks
- اللغة: ar
- آخر تحديث: 2026-10-21
- الناشر: BroadNet (https://www.broadnet.me)

تُرسل BroadNet حالة التسليم إلى عنوان URL لخطاف الويب (webhook) المُعدّ في حسابك مع انتقال كل رسالة بين مراحل دورة حياتها. ويمكنك أيضًا الاستعلام الدوري (polling): GET /whatsapp/message/bulk-insights لعرض حالة كل مُستلم WhatsApp في مجموعة، و GET /sms/list لعرض عدد الرسائل المُعالجة والمعلقة في مهام SMS القصيرة الجماعية.

> **استجب بسرعة، وعالج لاحقًا** أجب عن كل POST من نوع webhook برمز 2xx فور تخزينه، ثم عالجه بشكل غير متزامن. اجعل معالجك آمنًا للتشغيل مرتين لنفس التحديث.

## أمثلة

### message statuses

```text
SUBMITTED   قبلتها BroadNet ووضعتها في طابور الإرسال إلى الشبكة
SENT        سُلِّمت إلى المشغّل أو القناة
DELIVERED   تأكّد وصولها إلى جهاز المستلم
READ        فتحها المستلم (في القنوات التي تُبلغ عن القراءة، مثل WhatsApp)
FAILED      لم تُسلَّم
REJECTED    رفضها المشغّل أو القناة
```

### webhook.ts

```typescript
import express from "express";

const app = express();

app.post("/webhooks/broadnet", express.json(), async (req, res) => {
  // Store the raw status update first, then acknowledge.
  // Field names per channel are in the OpenAPI spec.
  await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
  res.sendStatus(200);
});
```

معالج توضيحي. تختلف حقول الحمولة باختلاف القناة؛ راجع مواصفات OpenAPI.

## ذو صلة

- [معيار تسليم وموثوقية Webhook](https://www.broadnet.me/ar/reference/webhook-delivery-and-reliability)