# تكامل واجهة برمجة تطبيقات WhatsApp

> تكامل خطوة بخطوة لـ WhatsApp Business API عبر BroadNet — تشمل التسجيل المدمج، وتقديم القوالب، والإرسال، وخطافات الويب (webhooks) للرسائل الواردة. تشمل جميع فئات الرسائل.

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

تكامل شامل API WhatsApp للأعمال عبر BroadNet: تسجيل مدمج، إرسال القوالب، وإرسال الرسائل. تتم عمليات الإرسال عبر POST /whatsapp/message/sendbulk مع messageType: TEXT، IMAGE، VIDEO، AUDIO، DOCUMENT، STICKER، LOCATION، CONTACTS، TEMPLATE، INTERACTIVE، REACTION، أو FLOW. يحتوي الرد على معرّف دفعة، ويتم إرسال حالة كل مُستلم (SUBMITTED، SENT، DELIVERED، READ، FAILED، REJECTED) إلى خطاف الويب (webhook) الخاص بك، ويمكن قراءتها على /whatsapp/message/bulk-insights.

> **ابدأ بالتسجيل المدمج** تُسهّل عملية التسجيل المدمجة في BroadNet إنشاء حساب WhatsApp للأعمال، والتحقق من رقم الهاتف، والموافقة على اسم العرض في نافذة واحدة مُستضافة. وتنتقل معظم الفرق من الصفر إلى إرسال أول نموذج في أقل من يوم.

## أمثلة

### template send

```bash
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=447700900123 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400
```

### whatsapp.ts

```typescript
import { Configuration, WhatsAppWhatsAppMessagingAPIApi } from "@broadnet/cpaas-sdk";

const wa = new WhatsAppWhatsAppMessagingAPIApi(
  new Configuration({
    basePath: "https://api.broadnet.me",
    accessToken: process.env.BROADNET_TOKEN!,
  }),
);

const res = await wa.whatsappMessageSendbulkPost({
  campaignName: "order-updates",
  messageType: "TEXT",
  destinationNo: "447700900123",
  content: "Your order has shipped.",
});

console.log(res.data); // batchId + per-file acceptance counts
```

SDK الرسمية لـ TypeScript · npm install @broadnet/cpaas-sdk axios