Ошибки WhatsApp API: 401, 403, 404, 422 и ошибки Meta

Обновлено: 27 сентября 2026 · 7 мин чтения

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

Шаги

1. 1

   401 и 403

   • 401 Invalid API key: нет заголовка Authorization или ключ неверный. Возьмите ключ в панели заново («Profile Settings» › «API access»).
   • 403 You are not authorized to send from this inbox: владелец ключа не состоит в этом канале. Используйте ключ администратора или добавьте агента в канал. Массовая отправка тоже работает только с ключом администратора.
2. 2

   404

   • No inbox with id X in this account: channel_id неверный или относится к другому аккаунту.
   • No message with id X: id сообщения неверный или относится к другому аккаунту.
   • Результат массовой отправки через 7 дней возвращает 404.
3. 3

   422: сам запрос

   • channel_id is required: в теле нет channel_id.
   • Either text or template is required: не передан ни текст, ни шаблон.
   • conversation_status must be one of: ...: допустимы только resolved, open или pending.
   • recipients must be a non-empty array: при массовой отправке список получателей пуст.
   • A batch can hold at most 1000 recipients: разбейте список на части по 1000.
4. 4

   422: канал, окно, шаблон, номер

   • The 24-hour messaging window ... is closed: окно закрыто, добавьте fallback_template или отправьте шаблон.
   • Inbox X is not a WhatsApp inbox: указанный канал не WhatsApp.
   • This API requires a WhatsApp Cloud API inbox: канал подключён по QR, шаблоны есть только в Cloud API.
   • No approved template named '...': неверное название шаблона или код языка, либо шаблон не синхронизирован с Clomni.
   • Invalid phone number: ...: в номере не от 8 до 15 цифр или пропущен код страны.
5. 5

   Шаблон «не найден»

   Причин две: шаблон ещё не APPROVED или не синхронизирован с Clomni. В панели на вкладке «Configuration» канала WhatsApp нажмите «Sync Templates» и проверьте через GET /v1/accounts/{account_id}/whatsapp/templates.

   Код языка берите точно из поля language там же: az и az_AZ это разные шаблоны.

6. 6

   Сообщения, которые отклонила Meta

   Если запрос прошёл через Clomni, но Meta его отклонила, сообщение получает статус failed, а причина записывается в поле external_error. Самые частые случаи:

   • номера нет в WhatsApp: почистите базу, такие номера снижают рейтинг качества;
   • параметр шаблона не подходит: сверьте с example_parameters, число переменных должно совпадать точно;
   • шаблон приостановлен (PAUSED): Meta остановила его из-за жалоб, проверьте в Business Manager;
   • превышен дневной лимит: лимит сообщений Meta (tier) исчерпан, продолжите на следующий день или увеличьте лимит.
7. 7

   Когда просите помощи

   Чтобы быстро найти проблему, подготовьте:

   • account_id и channel_id
   • тело отправленного запроса (без ключа API)
   • полученный ответ и HTTP-код
   • id сообщения или batch_id
   • примерное время запроса (часы и минуты, с часовым поясом)

   Никому не отправляйте ключ API.