البداية السريعة

أرسل أول رسالة واتساب عبر نبّه في أربع خطوات.

1. اربط حساب واتساب الرسمي

من لوحة التحكم: الإعدادات → المنصات → واتساب الرسمي. يجب أن يكون الحساب متصلاً وفيه رقم مفعل وقالب معتمد واحد على الأقل.

2. أنشئ مفتاح API

من الإعدادات → API أنشئ مفتاحاً باسم واضح مع صلاحية whatsapp:send و whatsapp:consent:write، وانسخه.

3. سجّل موافقة العميل على رسائل واتساب

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

4. أرسل رسالة قالب

API_KEY="your-api-key-here"
TEMPLATE_ID=42

curl -X POST "https://nabbih.com/api/v1/whatsapp/messages/send-template" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1001-welcome" \
  -d "{
    \"to\": \"+966500000000\",
    \"template_id\": $TEMPLATE_ID,
    \"parameters\": [\"أحمد\", \"NB1001\"]
  }"

الاستجابة عند القبول:

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

الرسالة توضع في قائمة الإرسال وتُسلَّم عبر خط أنابيب نبّه مع إعادة المحاولة التلقائية. تابع حالتها عبر الاستعلام عن حالة الرسالة باستخدام message_id.

معرّف الطلب (Idempotency-Key)

إرسال نفس المعرّف مع نفس محتوى الطلب يُرجع الطلب الأصلي من دون إرسال مكرر — استخدمه دائماً لعمليات مثل تأكيد الطلبات حتى تكون إعادة المحاولة آمنة. إعادة استخدام المعرّف مع محتوى مختلف تُرجع خطأ idempotency_conflict.