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

Сообщение WhatsApp API не доставлено: причины в порядке проверки

Принятое API сообщение ещё не доставлено: Meta сообщает итог позже, в вебхуке статуса (sent, delivered, read или failed), вместе с кодом ошибки. Проверяйте по порядку: статус failed и его код, окно 24 часа (131047), способ оплаты (131042), шаблон (132001, 132015), получатель (131026, 131049, 131050), затем лимиты номера и подключение.

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

4 statuses

sent (одна галочка), delivered (две), read (две синие) и failed (красный треугольник с ошибкой), как их передают вебхуки статуса.

131047

Прошло больше 24 часов с последнего ответа получателя; Meta советует отправить шаблон.

131026

Не удаётся доставить: номера нет в WhatsApp, получатель не принял новые условия или у него старая версия WhatsApp.

30 days

Время по умолчанию, в течение которого WhatsApp повторяет доставку неполученного служебного или маркетингового шаблона, прежде чем отбросить его; для шаблонов аутентификации это 10 минут.

20 mps

Фиксированная пропускная способность номера, который используется и в приложении WhatsApp Business, и в Cloud API.

Почему принятое сообщение всё равно не приходит?

Ответ API и доставка являются двумя отдельными событиями. При отправке Meta возвращает идентификатор сообщения (message id), как только принимает запрос; дойдёт ли сообщение до телефона клиента, становится известно позже, в вебхуке статуса в поле messages. sent означает, что сообщение покинуло серверы Meta (одна галочка), delivered, что оно дошло до устройства (две), read, что его открыли (две синие), а failed, что его не удалось отправить или доставить. Вам он показывается в массиве errors: code, title и error_data.details. Поэтому сначала не гадайте: найдите статус failed для этого message id и прочитайте его код. Без адреса вебхука статус нигде не сохраняется.

Какие причины и в каком порядке проверять?

От самой частой у только что подключённого номера до самой редкой. Каждая строка называет код Meta, поэтому по статусу failed вы поймёте, какая причина у вашего случая:

  • Окно закрыто: 131047, прошло больше 24 часов с последнего сообщения клиента. Сообщения со свободным текстом требуют открытого окна; отправьте шаблон.
  • Оплата: 131042 или шаблоны молча отбрасываются. С 1 октября 2026 г. служебные сообщения тоже перестают отправляться, когда расходуется 1 000 в месяц без способа оплаты.
  • Шаблон: 132001 не одобрен или неверный язык, 132000 неверное количество переменных, 132012 неверный формат, 132015 приостановлен, 132016 отключён.
  • Получатель: 131026 нет в WhatsApp, старая версия или не приняты условия; 131050 отписался от маркетинговых сообщений; 131049 задержано для поддержания здоровой вовлечённости; маркетинговые шаблоны на номера в США не доставляются.
  • Лимиты: 131048 ограничен после сигналов о спаме, 131056 слишком много сообщений одному человеку, 130429 пропускная способность, 20 сообщений в секунду на номере Coexistence.
  • Аккаунт: 131031 или 368, аккаунт WhatsApp Business Account ограничен или отключён за нарушение правил.
  • Подключение: номер больше не привязан, например после 14 дней без открытия приложения WhatsApp Business.

Как обрабатывать коды, связанные с получателем?

По-разному, потому что одни стоит повторить, а другие нельзя никогда. 131050 означает, что человек решил отписаться от ваших маркетинговых сообщений: Meta советует не повторять отправку, а вебхук user_preferences сообщает, когда человек отписывается или возобновляет получение. 131049 означает, что Meta задерживает маркетинговое сообщение ради здоровой вовлечённости, часто из-за лимита маркетинговых шаблонов на пользователя: Meta советует подождать не меньше 24 часов перед повторной отправкой, потому что раньше она вернёт ту же ошибку. 131026 относится к номерам, которых нет в WhatsApp, к пользователям, не принявшим текущие условия WhatsApp, и к очень старым версиям приложения: сначала проверьте формат номера и код страны, затем свяжитесь с клиентом через другой канал.

Как долго WhatsApp пытается доставить сообщение?

Пока не истечёт время жизни (TTL) сообщения. Если телефон выключен или вне сети, WhatsApp повторяет доставку, а не сбрасывает её сразу: по умолчанию 30 дней для служебных и маркетинговых шаблонов и 10 минут для шаблонов аутентификации. Бизнес может сократить это для каждого шаблона через message_send_ttl_seconds: от 30 секунд до 12 часов для служебных и от 30 секунд до 15 минут для аутентификации. Сообщение, которое не удалось доставить в пределах TTL, отбрасывается. Поэтому сообщение со статусом sent и без delivered через несколько часов обычно ждёт в телефоне клиента, а не потеряно; ставьте короткий TTL на коды и срочные оповещения, чтобы запоздалая доставка никого не сбивала.

Что это значит для ответов ИИ и автоматизаций?

Сначала смотрите запуск, потом статус. На вкладке Runs запуск со статусом Skipped ничего не отправил и объясняет почему: «Прошло больше 24 часов с последнего сообщения клиента», «В этом чате недавно отвечали с телефона» или «Достигнут лимит ответов ИИ для этого чата за этот час». Запуск Done означает, что Meta приняла каждый ответ, но это не доказательство доставки. easyCoexistence не хранит статусы сообщений: при включённых автоматизациях они уходят на URL пересылки, если вы его задали, а в прямом режиме сразу на ваш эндпоинт. Из ChatGPT или Claude попросите ИИ выполнить get_number_health: он вернёт текущий статус, рейтинг качества и последние 15 событий мониторинга, включая блок sending с кодом Meta.

Как настроить

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

Распространённые ошибки

  • Повторная отправка при 131050. Человек отписался от ваших маркетинговых сообщений; новые попытки не доставляются никогда и лишь добавляют негативные сигналы.
  • Считать message id доставленным. Meta сначала принимает сообщение, а сбои сообщает позже, поэтому процесс, который останавливается на id, пропускает все отклонённые сообщения.
  • Отправка ответа со свободным текстом через сутки. Через 24 часа без сообщения клиента принимается только шаблон.
  • Работа без адреса для вебхука. Статусы failed приходят только в вебхуках, поэтому без адреса теряется причина, по которой сообщение не дошло.
Настройка с EasyCoexistence

ИИ может проверить номер из ChatGPT или Claude через get_number_health. От US$ 9 за подключённый номер в месяц, до US$ 0,75 по мере добавления номеров, с бесплатным пробным периодом на 3 дня.

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

Почему сообщение часами показывает одну галочку?

Одна галочка означает статус sent: Meta отправила сообщение, но телефон его не получил, обычно потому что он выключен или не в сети. WhatsApp продолжает повторять доставку, пока не истечёт время жизни шаблона, по умолчанию 30 дней для служебных и маркетинговых.

Почему ответы приходят, а шаблоны нет?

Обычно проблема со способом оплаты в аккаунте WhatsApp Business. Meta доставляет служебные сообщения в пределах бесплатного месячного лимита номера без оплаты, но шаблоны не доставляет. Добавьте карту в разделе Billing & payments.

Можно ли увидеть неотправленные сообщения в приложении WhatsApp Business?

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

Берёт ли Meta плату за недоставленные сообщения?

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

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

Почему сообщение WhatsApp не доставлено: чтение статуса failed и его ошибокСтатус failed значит, что Meta не смогла отправить или доставить сообщение. Разберите массив errors и коды 131047, 131049, 131050 и что делать.Статусы вебхуков WhatsApp: отправлено, доставлено, прочитано, ошибкаКак WhatsApp сообщает о судьбе отправленного сообщения: массив statuses, значения статусов, поля и сопоставление по wamid.Добавьте способ оплаты в аккаунт WhatsApp Business, иначе сервисные сообщения перестанут доставлятьсяБез способа оплаты Meta перестаёт доставлять шаблоны и сервисные ответы сверх 1 000 в месяц. Как добавить способ в Billing & payments и проверить.Шаблон WhatsApp на паузе или отключён: что делатьНизкокачественный шаблон WhatsApp ставится на паузу на 3 часа, затем на 6, после чего отключается. Как понять и что делать дальше.Номер WhatsApp Business с ограничением или блокировкой: как запросить проверкуГде Meta показывает ограничение или блокировку WhatsApp, как нажать Request Review в Business Support Home или в приложении, что исправить и сроки.Коды ошибок WhatsApp Cloud APIВсе коды ошибок WhatsApp Cloud API в одной таблице: значение, необходимость повтора и ссылка на подробное описание.

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

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

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

Проверено по состоянию на