مرجع

أكواد الأخطاء

كل استجابة فاشلة تحتوي حقل error برمز ثابت يمكن الاعتماد عليه في المنطق البرمجي، وmessage عربي لعرضه للمستخدم النهائي.

الرمز	HTTP	المعنى
MISSING_ACCESS_TOKEN	401	لم يُرسَل access_token في الطلب.
INVALID_ACCESS_TOKEN	401	المفتاح غير موجود أو تم إيقافه.
PLAN_NOT_ALLOWED	403	الحساب ليس ضمن باقات مؤتمت الأعمال.
MISSING_INSTANCE_ID	400	لم يُمرَّر instance_id في الطلب.
INVALID_NUMBER	400	رقم الهاتف غير صالح (8-15 خانة أرقام فقط).
MISSING_CONTENT	400	يجب إرسال message أو media_url على الأقل.
INSTANCE_NOT_FOUND	404	لا توجد جلسة بهذا المعرّف لهذا الحساب.
INSTANCE_NOT_CONNECTED	409	الجلسة موجودة لكنها لم تُربط بواتساب بعد.
QUOTA_EXCEEDED	402	تجاوزت حد أرقام الواتساب المسموحة في باقتك.
WA_SERVICE_TIMEOUT	504	انتهت مهلة الاتصال بخدمة الواتساب.
WA_SERVICE_UNREACHABLE	502	تعذّر الوصول لخدمة الواتساب حاليًا.
SERVICE_MISCONFIGURED	500	خطأ إعدادات داخلي — راسِل الدعم.
DATABASE_ERROR	500	فشل عملية قاعدة البيانات.

صيغة الاستجابة الفاشلة

{
  "status": "error",
  "error": "INVALID_ACCESS_TOKEN",
  "message": "access_token غير صالح أو موقوف"
}