ВойтиНачать бесплатный пробный период
Meta Tech Provider

Коды ошибок WhatsApp Cloud API

Здесь собраны все коды ошибок WhatsApp Cloud API, которые мы документируем, в одной таблице с объяснением каждого и указанием, поможет ли повторная отправка. В большинстве случаев нет: ошибка предсказуема, поэтому тот же запрос снова завершится так же, а цикл повторов превратит неверный запрос в ограничение частоты запросов.

EasyCoexistence непрерывно отслеживает подключение и записывает события Meta об аккаунте и рейтинге качества в хронологию подключения.

Не храним сообщения по умолчаниюBusiness App + Cloud APIMCP для Claude и ChatGPTПодключение за 2 минуты

Запрос

КодЧто означаетПовторная отправка
100Параметр не поддерживается, написан с ошибкой или имеет неверный формат.Нет
131008Обязательный параметр вообще не передан.Нет
131009Параметр передан, но эндпоинт отклоняет его значение.Нет
131021Отправитель и получатель имеют один и тот же номер.Нет
131051Тип сообщения не поддерживается, часто это ограничение Coexistence.Нет
131052Meta не удалось скачать медиафайл, отправленный клиентом.Нет
131053Meta не удалось загрузить отправленный вами медиафайл. Размер, формат или доступность.Нет

Шаблон

КодЧто означаетПовторная отправка
132000Количество параметров не совпадает с шаблоном.Нет
132001Шаблона с таким сочетанием названия и языка не существует.Нет
132007Шаблон нарушает правила обмена сообщениями. Перепишите его и отправьте повторно.Нет
132012Формат параметра не соответствует тому, что задано в шаблоне.Нет
132015Шаблон приостановлен после снижения качества. Временно.Подождать
132016Шаблон отключён навсегда. Он не вернётся.Нет

Окно и получатель

КодЧто означаетПовторная отправка
13104724-часовое окно обслуживания клиентов закрыто. Отправьте шаблон.Нет
131026Получатель вообще не может получить сообщение.Нет
131050Человек отказался от сообщений. Обходного пути нет, и так задумано.Нет
130497Отправка сообщений в эту страну ограничена для вашего аккаунта.Нет

Регистрация и PIN-код

КодЧто означаетПовторная отправка
131045Номер никогда не регистрировался для отправки сообщений через Cloud API.Нет
133010Номер не зарегистрирован. Регистрацию нужно завершить.Нет
133006Номер нужно подтвердить, прежде чем его можно будет зарегистрировать.Нет
133005Неверный PIN-код двухэтапной проверки. Прекратите угадывать.Нет
133008Слишком много попыток ввода PIN-кода. Регистрация заблокирована на время.Подождать

Доступ и аккаунт

КодЧто означаетПовторная отправка
190Токен доступа истёк или был аннулирован.Нет
368Аккаунт ограничен после нарушения правил.Нет
131031Аккаунт ограничен или его данные не совпадают с данными Meta.Нет
131042Проблема с оплатой в бизнес-аккаунте блокирует отправку.Нет
131049Meta заблокировала сообщение, чтобы защитить экосистему.Нет

Ограничения частоты

КодЧто означаетПовторная отправка
130429Достигнут лимит пропускной способности аккаунта по сообщениям.Подождать
131048Сработало ограничение против спама. Причина в качестве, а не в объёме.Нет
131056Слишком много сообщений между вашим номером и одним получателем.Нет
80007Аккаунт достиг лимита вызовов управления. Обычно из-за частых опросов (polling).Подождать

Временные сбои

КодЧто означаетПовторная отправка
131016Один из сервисов Meta временно недоступен.Да
131000Неклассифицированный сбой. Повторите один раз, затем обращайтесь в поддержку с trace id.Да

Синхронизация в режиме Coexistence

КодЧто означаетПовторная отправка
2593107Превышен лимит синхронизации истории чатов.Нет
2593108Синхронизация была запущена вне 24-часового окна синхронизации.Нет

Как читать столбец повторной отправки

В нём три значения, и ошибочный выбор между ними является самой дорогой ошибкой во всей этой справке.

«Нет» означает, что ошибка предсказуема. Не сработал запрос, шаблон или состояние получателя, поэтому повторная отправка того же запроса даст ту же ошибку и потратит пропускную способность, которая пригодится позже. «Да» означает, что ошибка произошла на стороне Meta и экспоненциальная задержка действительно её устраняет. «Подождать» означает, что причина реальна, но временна: это ограничение или блокировка, которые снимаются сами. Повторная отправка до этого момента ничего не даст и может продлить действие условия.

Почему большинство этих ошибок нельзя устранить повторной отправкой

Потому что платформа возвращает конкретные коды, а не общие ошибки. Неверный параметр, несуществующий шаблон, закрытое окно обмена сообщениями и получатель, отказавшийся от рассылки, известны уже в момент ответа. Поэтому Meta называет причину, а не возвращает расплывчатую ошибку.

  • Проблема в запросе не исчезает со второй попытки.
  • Проблема шаблона находится в самом шаблоне, и запрос не может её изменить.
  • Проблема окна или отказа от рассылки связана с состоянием получателя, а не с вашим.
  • Ограничение аккаунта является решением, а повторная отправка не является апелляцией.

Что записывать при появлении одной из этих ошибок

Достаточно данных, чтобы установить причину без воспроизведения ошибки. Именно это отличает исправление за пять минут от дня догадок.

  • Полный ответ с ошибкой, включая идентификатор трассировки, который запрашивает поддержка Meta.
  • Тело запроса в отправленном виде, а не в предполагаемом. Разница между ними обычно и есть ошибка.
  • Идентификатор номера телефона, чтобы отличить проблему одного номера от проблемы всего аккаунта.
  • Время, чтобы сопоставить ошибку с состоянием подключения в этот момент.

Коды, которые существуют только в Coexistence

Таких кодов два. Они сбивают с толку, потому что похожи на обычные ошибки отправки. 2593107 и 2593108 относятся к синхронизации истории чатов. На этом этапе при первом подключении номера копируются недавние разговоры из приложения WhatsApp Business.

Это не ошибки обмена сообщениями и не признак сбоя подключения. Если синхронизация превышает ограничение или выполняется вне разрешённого окна, номер остаётся подключённым и продолжает нормально отправлять сообщения, но истории копируется меньше ожидаемого. Если принять это за сломанное подключение, можно отключить номер и начать заново, потеряв ещё больше истории вместо её восстановления.

Часто задаваемые вопросы

Какие ошибки нужно повторять?

131016 и 131000, с экспоненциальной задержкой. 130429, 132015 и 133008 исчезают сами, если подождать. Все остальные ошибки предсказуемы.

Означает ли код ошибки, что мой номер отключён?

Обычно нет. Большинство этих ошибок связаны с запросом, шаблоном или получателем. Проблемы подключения отображаются как вебхуки аккаунта и рейтинга качества, а не как ошибки отправки.

Что такое идентификатор трассировки?

Это идентификатор в ответе с ошибкой, который помогает поддержке Meta найти конкретный запрос. Записывайте его при каждой ошибке: без него обращение нельзя обработать.

Одинаковы ли эти коды у всех провайдеров?

Да. Они приходят из Cloud API Meta, поэтому одинаковы у любого провайдера, подключившего номер. Провайдер может изменить только то, насколько понятно они до вас доходят.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный периодВ течение 3 дней ничего не списывается. Отмена в любое время.

Читайте дальше

СправочникОшибка WhatsApp 131047: сообщение для повторного контактаОшибка 131047 означает, что с последнего сообщения этого клиента прошло более 24 часов.СправочникОшибка WhatsApp 100: недопустимый параметрКод 100 означает, что запрос содержит параметр, который Meta не принимает: он не поддерживается, указан с ошибкой или имеет неверную структуру для этого эндпоинта.СправочникОшибка WhatsApp 131016: сервис недоступенОшибка 131016 означает временную недоступность сервиса на стороне Meta.СправочникНомер перестал работать: как выяснить причинуКогда подключённый номер перестаёт работать, причина почти никогда не в коде.СправочникПоля вебхука WhatsApp и их маршрутизацияАккаунт WhatsApp Business отправляет события как именованные поля.РуководствоCoexistence в WhatsApp: приложение и API на одном номереCoexistence это официальный режим Meta для одновременной работы приложения WhatsApp Business и Cloud API на одном номере.