إرسال رسالة نصية

الرسائل النصية الحرة مسموحة فقط داخل نافذة خدمة العملاء (24 ساعة) التي تُفتح من آخر رسالة يرسلها العميل إليك. خارج النافذة استخدم رسالة قالب.

POST /api/v1/whatsapp/messages/send-text
curl -X POST "https://nabbih.com/api/v1/whatsapp/messages/send-text" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: {unique-key}" \
  -d "{
    \"to\": \"+966500000000\",
    \"body\": \"شكراً لتواصلك! كيف يمكننا مساعدتك؟\",
    \"preview_url\": true
  }"

الحقول

الحقل النوع إلزامي الوصف
tostringنعمرقم المستلم بصيغة دولية (E.164).
bodystringنعمنص الرسالة (حتى 4096 حرفاً).
preview_urlbooleanلاإظهار معاينة الروابط داخل الرسالة (افتراضي false).
account_idintegerلامعرّف حساب واتساب — يُستخدم تلقائياً إذا كان لديك حساب واحد.
phone_number_idintegerلامعرّف رقم الإرسال — يُستخدم تلقائياً إذا كان للرقم واحد.

خارج نافذة الـ 24 ساعة

إذا لم تكن هناك محادثة مفتوحة مع المستلم تُرجع الواجهة:

422 outside_session_window
{
  "error": {
    "code": "outside_session_window",
    "message": "Official WhatsApp outbound policy denied the request (approved_template_required)."
  }
}