التوثيق / مرجع الواجهة البرمجية
إرسال رسالة
أرسل نصاً حراً داخل نافذة 24 ساعة أو قالباً معتمداً في أي وقت.
POST
/messagesscope: messages:sendيرسل رسالة واتساب إلى مستلم واحد.
#جسم الطلب
| الحقل | النوع | الوصف |
|---|---|---|
to | string | رقم المستلم بصيغة دولية. |
type | "text" or "template" | ما سيُرسل. |
text.body | string | لنوع text: الرسالة حتى 4096 حرفاً. |
template.name, template.language | string | لنوع template: قالب معتمد ورمز لغته. |
template.params | string[] | قيم {{1}} و{{2}}… بالترتيب. يجب أن يطابق العدد القالب. |
from | string, optional | معرّف رقم الهاتف المرسل منه عند وجود عدة أرقام. |
#إرسال نص
curl -X POST https://your-domain/v1/api/messages \
-H "Authorization: Bearer rk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1001" \
-d '{
"to": "966501234567",
"type": "text",
"text": { "body": "Your order #1001 has shipped" }
}'{
"id": "6f1c0a3e-5b2d-4c1a-9d3e-2f6a1b7c8d90",
"status": "sent",
"waMessageId": "wamid.HBgM...",
"conversationId": "b2d9a7c4-1e3f-4a5b-8c6d-0f9e8d7c6b5a"
}النص الحر مسموح فقط خلال 24 ساعة من آخر رسالة للعميل. وإلا تحصل على 409 window_closed: استخدم قالباً.
#إرسال قالب
curl -X POST https://your-domain/v1/api/messages \
-H "Authorization: Bearer rk_live_YOUR_KEY" -H "Content-Type: application/json" \
-d '{
"to": "966501234567",
"type": "template",
"template": { "name": "order_update", "language": "ar", "params": ["Sara", "1001"] }
}'#القواعد المفروضة على كل إرسال
- اشتراكك نشط وحصتك الشهرية لم تنفد.
- المستلم وافق (راجع جهات الاتصال) ولم يلغِ الاشتراك أو يُحظر.
- يجب أن يكون القالب معتمداً ويتبع الرقم المرسل ويستلم عدد القيم الذي يعلنه تماماً.
#منع التكرار
أرسل ترويسة Idempotency-Key (أي نص فريد، مثل رقم طلبك). إن أعدت المحاولة بالمفتاح نفسه يعيد رد النتيجة الأصلية بدل الإرسال مرة أخرى.