WhatsApp API xətaları: 401, 403, 404, 422 və Meta xətaları

Son yeniləmə: 27 sentyabr 2026 · 7 dəq oxunur

{ "error": "Invalid phone number: 123" }

Addımlar

1. 1

   401 və 403

   • 401 Invalid API key: Authorization başlığı yoxdur və ya açar səhvdir. Açarı paneldən yenidən götürün (Profil parametrləri › API girişi).
   • 403 You are not authorized to send from this inbox: açarın sahibi həmin gələn qutunun üzvü deyil. Administrator açarı işlədin və ya agenti gələn qutuya əlavə edin. Toplu göndəriş də yalnız administrator açarı ilə işləyir.
2. 2

   404

   • No inbox with id X in this account: channel_id səhvdir və ya başqa hesaba aiddir.
   • No message with id X: mesaj id-si səhvdir və ya başqa hesabındır.
   • Toplu göndərişin nəticəsi 7 gündən sonra 404 qaytarır.
3. 3

   422: sorğunun özü

   • channel_id is required: gövdədə channel_id yoxdur.
   • Either text or template is required: nə mətn, nə şablon göndərilib.
   • conversation_status must be one of: ...: yalnız resolved, open və ya pending olar.
   • recipients must be a non-empty array: toplu göndərişdə alıcı siyahısı boşdur.
   • A batch can hold at most 1000 recipients: siyahını 1000-lik hissələrə bölün.
4. 4

   422: kanal, pəncərə, şablon, nömrə

   • The 24-hour messaging window ... is closed: pəncərə bağlıdır, fallback_template əlavə edin və ya şablon göndərin.
   • Inbox X is not a WhatsApp inbox: göstərilən gələn qutu WhatsApp deyil.
   • This API requires a WhatsApp Cloud API inbox: gələn qutu QR ilə qoşulub, şablon yalnız Cloud API-də var.
   • No approved template named '...': şablonun adı və ya dil kodu səhvdir, ya da şablon Clomni-yə sinxronlaşdırılmayıb.
   • Invalid phone number: ...: nömrədə 8-dən 15-ə qədər rəqəm yoxdur və ya ölkə kodu buraxılıb.
5. 5

   Şablon «tapılmadı»

   İki səbəb olur: şablon hələ APPROVED deyil, ya da Clomni-yə sinxronlaşdırılmayıb. Paneldə WhatsApp qutusunun Konfiqurasiya bölməsində Şablonları sinxronlaşdır basın və GET /v1/accounts/{account_id}/whatsapp/templates ilə yoxlayın.

   Dil kodunu oradakı language sahəsindən dəqiq götürün: az ilə az_AZ fərqli şablonlardır.

6. 6

   Meta-nın rədd etdiyi mesajlar

   Sorğu Clomni-dən keçib Meta-da rədd olunarsa, mesaj failed statusu alır, səbəb external_error sahəsində yazılır. Ən çox rast gəlinənlər:

   • nömrə WhatsApp-da yoxdur: bazanızı təmizləyin, belə nömrələr keyfiyyət reytinqini salır;
   • şablon parametri uyğun gəlmir: example_parameters ilə tutuşdurun, dəyişənlərin sayı dəqiq olmalıdır;
   • şablon dayandırılıb (PAUSED): Meta şikayət səbəbindən dayandırıb, Business Manager-də yoxlayın;
   • gündəlik limit aşılıb: Meta-nın mesaj limiti (tier) bitib, ertəsi gün davam edin və ya limiti artırın.
7. 7

   Kömək istəyəndə

   Problemi tez tapmaq üçün bunları hazırlayın:

   • account_id və channel_id
   • göndərdiyiniz sorğunun gövdəsi (API açarı olmadan)
   • aldığınız cavab və HTTP kodu
   • mesaj id-si və ya batch_id
   • sorğunun təxmini vaxtı (saat və dəqiqə, saat qurşağı ilə)

   API açarını heç kimə göndərməyin.