إرسال رسالة نصية
الرسائل النصية الحرة مسموحة فقط داخل نافذة خدمة العملاء (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
}"
الحقول
| الحقل | النوع | إلزامي | الوصف |
|---|---|---|---|
| to | string | نعم | رقم المستلم بصيغة دولية (E.164). |
| body | string | نعم | نص الرسالة (حتى 4096 حرفاً). |
| preview_url | boolean | لا | إظهار معاينة الروابط داخل الرسالة (افتراضي false). |
| account_id | integer | لا | معرّف حساب واتساب — يُستخدم تلقائياً إذا كان لديك حساب واحد. |
| phone_number_id | integer | لا | معرّف رقم الإرسال — يُستخدم تلقائياً إذا كان للرقم واحد. |
خارج نافذة الـ 24 ساعة
إذا لم تكن هناك محادثة مفتوحة مع المستلم تُرجع الواجهة:
422 outside_session_window
{
"error": {
"code": "outside_session_window",
"message": "Official WhatsApp outbound policy denied the request (approved_template_required)."
}
}