Сообщение WhatsApp API не доставлено: причины в порядке проверки
Принятое API сообщение ещё не доставлено: Meta сообщает итог позже, в вебхуке статуса (sent, delivered, read или failed), вместе с кодом ошибки. Проверяйте по порядку: статус failed и его код, окно 24 часа (131047), способ оплаты (131042), шаблон (132001, 132015), получатель (131026, 131049, 131050), затем лимиты номера и подключение.
easyCoexistence круглосуточно следит за каждым подключённым номером, пишет на почту, когда Meta прекращает доставку, разрывает связь или снижает качество, и без изменений пересылает вебхуки статусов Meta в вашу систему.
sent (одна галочка), delivered (две), read (две синие) и failed (красный треугольник с ошибкой), как их передают вебхуки статуса.
Прошло больше 24 часов с последнего ответа получателя; Meta советует отправить шаблон.
Не удаётся доставить: номера нет в WhatsApp, получатель не принял новые условия или у него старая версия WhatsApp.
Время по умолчанию, в течение которого WhatsApp повторяет доставку неполученного служебного или маркетингового шаблона, прежде чем отбросить его; для шаблонов аутентификации это 10 минут.
Фиксированная пропускная способность номера, который используется и в приложении 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.
Как настроить
- 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.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- 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 приходят только в вебхуках, поэтому без адреса теряется причина, по которой сообщение не дошло.
ИИ может проверить номер из 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 Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на