BroadNet
حالة التسليم·/webhooks

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

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

قراءة لمدة 4 دقائق·تم التحديث في سبتمبر 2026·القسم 8 من 15مركز المطورين

Overview

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

أمثلة

انسخ والصق واستبدل القيم النائبة — هذه الأمثلة تستدعي واجهة API لبيئة الإنتاج كما هي مكتوبة.

message statusestext
SUBMITTED   قبلتها BroadNet ووضعتها في طابور الإرسال إلى الشبكة
SENT        سُلِّمت إلى المشغّل أو القناة
DELIVERED   تأكّد وصولها إلى جهاز المستلم
READ        فتحها المستلم (في القنوات التي تُبلغ عن القراءة، مثل WhatsApp)
FAILED      لم تُسلَّم
REJECTED    رفضها المشغّل أو القناة
webhook.tstypescript
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.
وصول تجريبي · نرد خلال يوم عمل واحد

اطلب وصولاً تجريبياً وابنِ بثقة.

سنرد عليك خلال يوم عمل واحد ببيانات اعتماد الاختبار. بعد ذلك، ثبّت TypeScript SDK أو استدعِ REST API من أي لغة، وأرسل رسالتك التجريبية الأولى إلى رقمك الخاص.

$npm install @broadnet/cpaas-sdk axiosready