التوثيق / مرجع الواجهة البرمجية

إرسال رسالة

أرسل نصاً حراً داخل نافذة 24 ساعة أو قالباً معتمداً في أي وقت.

POST/messagesscope: messages:send

يرسل رسالة واتساب إلى مستلم واحد.

#جسم الطلب

الحقلالنوعالوصف
tostringرقم المستلم بصيغة دولية.
type"text" or "template"ما سيُرسل.
text.bodystringلنوع text: الرسالة حتى 4096 حرفاً.
template.name, template.languagestringلنوع template: قالب معتمد ورمز لغته.
template.paramsstring[]قيم {{1}} و{{2}}… بالترتيب. يجب أن يطابق العدد القالب.
fromstring, 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" }
  }'
Response 201
{
  "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 (أي نص فريد، مثل رقم طلبك). إن أعدت المحاولة بالمفتاح نفسه يعيد رد النتيجة الأصلية بدل الإرسال مرة أخرى.

إرسال رسالة · توثيق رد