إرسال رسالة قالب

القوالب المعتمدة هي الطريقة الوحيدة لبدء محادثة مع العميل خارج نافذة الـ 24 ساعة. تُدار القوالب من لوحة التحكم (واتساب → القوالب)، ويمكن عرضها برمجياً من نقطة القوالب.

قبل بدء المحادثة، سجّل موافقة العميل الفعلية على رسائل واتساب عبر واجهة تسجيل الموافقة. اعتماد القالب لا يعني موافقة العميل. احتفظ بمفتاح API على الخادم.

curl -X POST "https://nabbih.com/api/v1/whatsapp/messages/send-template" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: {unique-key}" \
  -d "{
    \"to\": \"+966500000000\",
    \"template_id\": 42,
    \"parameters\": [\"أحمد\"],
    \"account_id\": 1,
    \"phone_number_id\": 3
  }"

الحقول

الاستجابة

{
  "data": {
    "message_id": 1024,
    "attempt_id": 512,
    "status": "pending",
    "created": true
  }
}

created: true تعني إنشاء طلب إرسال جديد (كود 202). عند إرسال نفس Idempotency-Key مرة أخرى تُرجع الواجهة الطلب نفسه مع created: false (كود 200) من دون إرسال مكرر. اطلب الصلاحية whatsapp:send.