тправляйте через WhatsApp, если получатель дал согласие на получение сообщений по этому каналу и у него есть активный аккаунт WhatsApp; во всех остальных случаях используйте SMS или переключайтесь на SMS. В облачном API WhatsApp попытка отправить сообщение на номер, который не может его принять, завершится ошибкой 131026, и вы узнаете об этом только из статус-вебхука, а не из ответа на запрос отправки. Надежный алгоритм: фиксируйте согласие клиента на использование конкретного канала при подписке, проверяйте законность использования канала перед отправкой и настраивайте автоматический переход на SMS при получении статуса ошибки WhatsApp. BroadNet объединяет оба канала в рамках единого омниканального API с четко прописанными правилами резервного переключения.
Основные выводы
- Ошибка 131026 означает, что Meta не удалось доставить сообщение. Meta приводит три возможные причины: номер не является WhatsApp-номером, получатель не принял последние условия или получатель использует устаревшую версию WhatsApp.
- Успешный ответ API означает лишь то, что запрос был принят. Статус доставки (отправлено, доставлено, прочитано или ошибка) передается позже через статус-вебхук, при этом в случае ошибки передается массив ошибок.
- Наличие аккаунта WhatsApp не дает права отправлять сообщения: политика Meta требует наличия номера телефона человека и его согласия на получение сообщений от вас.
- Вне 24-часового окна обслуживания клиентов WhatsApp принимает только шаблонные сообщения (в противном случае возникнет ошибка 131047).
- Тип линии — это первый фильтр: отправка SMS на городской или бесплатный номер обычно завершается ошибкой, но плата за сообщение все равно взимается.
- Резервный канал (fallback) лучше всего настраивать как правило в платформе отправки: сначала WhatsApp (если клиент выбрал его), затем SMS при получении статуса ошибки или отсутствии согласия на WhatsApp.
Что означает ошибка WhatsApp 131026?
В справочнике ошибок Cloud API компании Meta, 131026 означает «Не удалось доставить сообщение». Meta приводит три возможные причины: «Номер телефона получателя не является номером WhatsApp», получатель «не принял новые Условия использования и Политику конфиденциальности» или получатель «использует старую версию WhatsApp». Рекомендуемое решение от Meta: попросить человека, «использующего другой способ связи, отличный от WhatsApp», подтвердить, что он может отправить сообщение на ваш бизнес-номер, принять последние условия или обновить приложение.
Другими словами, 131026 — это сигнал маршрутизации, а не ошибка в вашем коде. Для одноразового пароля, уведомления о доставке или напоминания о встрече под методом связи, отличным от WhatsApp, Meta обычно подразумевает SMS, и такие сообщения должны отправляться автоматически, а не после создания обращения в службу поддержки.
Почему наличие ID сообщения не означает, что оно доставлено?
Отправка происходит асинхронно. API принимает запрос и возвращает ID сообщения; последующие события приходят на ваш webhook. Webhook статуса сообщения Meta передает следующие значения:
| Статус | Описание Meta | Что делать |
|---|---|---|
| отправлено | Сообщение было успешно отправлено с серверов Meta | Ожидание доставки или ошибки |
| доставлено | Сообщение было успешно доставлено на устройство пользователя WhatsApp | Резервный канал не требуется |
| прочитано | Сообщение было отображено в открытом чате на устройстве пользователя | Резервный канал не требуется |
| ошибка | Не удалось отправить или доставить сообщение на устройство пользователя | Считайте errors[].code; для срочных сообщений используйте резервный канал SMS |
Статус «ошибка» содержит массив ошибок с числовым кодом, заголовком, полем с подробностями и ссылкой на справочник ошибок. Логируйте код вместе с сообщением: он подскажет, нужно ли повторить попытку, сменить канал или исправить шаблон. Та же логика применима к SMS, где отчет о доставке (DLR) от оператора выполняет роль вебхука статуса.
Можно ли отправить сообщение пользователю в WhatsApp только на основании наличия у него аккаунта?
Нет. Согласно Политике обмена сообщениями WhatsApp Business, вы «можете связываться с людьми в WhatsApp только в том случае, если: (а) они предоставили вам свой номер мобильного телефона или имя пользователя; и (б) вы получили от получателя согласие на получение последующих сообщений или звонков от вас». Вы также обязаны соблюдать любые запросы на прекращение связи, сделанные как в WhatsApp, так и за её пределами.
Таким образом, выбор канала начинается с получения согласия, а не в момент отправки. Уточняйте у клиентов, какие каналы они принимают, сохраняйте этот выбор вместе с меткой времени и отправляйте сообщения только по тем каналам, на которые они дали согласие. Местное законодательство накладывает дополнительные правила: в качестве примера см. наше руководство по маркетингу в PDPL ОАЭ для SMS и WhatsApp.
Как насчет 24-часового окна и ошибки 131047?
Отправка произвольного сообщения WhatsApp разрешена только в течение 24 часов с момента последнего сообщения клиента вам. В противном случае Cloud API возвращает 131047: «С момента последнего ответа получателя на номер отправителя прошло более 24 часов», а решение от Meta — «вместо этого отправить получателю шаблонное сообщение». Узнайте подробнее о том, что такое 24-часовое окно WhatsApp.
Для проектирования системы резервирования (fallback) это означает два разных типа сбоев: 131047 решается переходом на утвержденный шаблон в WhatsApp, а 131026 — сменой канала. Разграничивайте их в своей логике повторных попыток.
Какой канал следует использовать первым?
Единого ответа для всех рынков не существует; это зависит от содержания сообщения и того, на что согласился каждый конкретный клиент. В большинстве случаев применяется набор правил для каждого получателя:
| Ситуация | Первый канал | Резервный канал |
|---|---|---|
| Клиент дал согласие на WhatsApp и уже писал вам ранее | WhatsApp (шаблон вне 24-часового окна) | SMS при ошибке доставки |
| Клиент дал согласие на WhatsApp, истории сообщений пока нет | Шаблон WhatsApp | SMS при ошибке доставки или отсутствии статуса в течение установленного времени |
| Согласие на WhatsApp не зафиксировано | SMS | Голосовой OTP, если поддерживается |
| Предыдущее сообщение WhatsApp не доставлено из-за 131026 | SMS | Попросите клиента подтвердить свой WhatsApp при следующем контакте |
| Номер является фиксированным или бесплатным | Не SMS: обычно такие сообщения не доходят | Голосовой вызов или запрос мобильного номера |
| Клиент дал согласие на RCS, Telegram или Viber | Канал, через который возможна отправка | SMS |
Для анализа по рынкам (где преобладают WhatsApp, RCS или SMS), ознакомьтесь с нашим руководством по каналам SMS vs WhatsApp vs RCS.
Что можно проверить перед отправкой?
Первая проверка касается не приложений, а типа линии. Отправка SMS на городской или бесплатный номер обычно завершается ошибкой, при этом плата за сообщение всё равно взимается. MobileValidate, BroadNet-бренд на стадии закрытого тестирования, определяет тип линии, текущего оператора, а для перенесенных номеров — первоначального оператора; BroadNet HLR Lookup добавляет статус сети в реальном времени, показывая, доступен ли номер в данный момент.
Для клиентов, давших согласие на другие каналы, MobileValidate также может в режиме реального времени проверять, зарегистрирован ли их номер в Telegram, Viber или Zalo, а при массовых задачах — в Signal, iMessage, RCS, LINE или Botim; проверка RCS при наличии возможности сообщает платформу мобильного устройства. Политика допустимого использования ограничивает эти проверки предотвращением мошенничества и выбором каналов для контактов, давших согласие. Полный список проверок доступен mobilevalidate.com. MobileValidate является независимым сервисом и не аффилирован, не поддерживается и не спонсируется платформами, которые он проверяет; их названия используются только для описания охвата проверки.
Для самого WhatsApp надежными сигналами являются те, что предоставляет Meta: собственное согласие клиента, его ответы, а также статус доставки или ошибки вашего последнего сообщения. Сохраняйте результат последнего WhatsApp для каждого клиента и используйте его для управления следующей отправкой.
Как BroadNet обрабатывает резервные каналы (fallback)?
BroadNet является официальным провайдером бизнес-решений Meta и объединяет WhatsApp Business API, SMS, RCS и голос на одной платформе. Омниканальный API принимает один запрос с четко заданными правилами резервной отправки через SMS, WhatsApp, RCS и голос и возвращает унифицированные отчеты, поэтому статус ошибки WhatsApp автоматически превращается в SMS без необходимости написания дополнительного кода в вашем приложении.
- Для одноразовых паролей OTP API обеспечивает автоматический переход на резервные каналы через SMS, WhatsApp, голос и Flash Call; MyOTP.App охватывает SMS, WhatsApp и Telegram через одну учетную запись.
- Установите временной лимит для критически важных сообщений: если статус доставки или ошибки не получен вовремя, отправляйте сообщение по резервному каналу.
- Подготовьте утвержденные шаблоны для каждого типа сообщений, которые могут вам понадобиться за пределами 24-часового окна.
- Приостанавливайте канал для клиента после ошибки 131026 до момента повторного подтверждения, чтобы не оплачивать повторные неудачные попытки.
Чтобы узнать больше о различных сценариях, ознакомьтесь с нашей стратегией многоканального резервирования.
Как выглядит контрольный список маршрутизации для каждого получателя?
- При получении согласия фиксируйте, какие каналы принимает клиент, а также дату и формулировку, с которой он согласился.
- Проверяйте тип линии новых номеров: если это стационарный или бесплатный номер, запрашивайте мобильный номер.
- Выбирайте первый доступный канал на основе согласия и истории клиента, а не только на основе настроек по умолчанию для страны.
- Вне 24-часового окна отправляйте только шаблоны WhatsApp.
- Отслеживайте статус-вебхуки и отчеты о доставке; используйте ошибки и таймауты в качестве триггеров для переключения на резервный канал.
- Для срочных сообщений переключайтесь на SMS и записывайте код ошибки WhatsApp вместе с сообщением.
- Проводите еженедельный анализ ошибок: рост 131026 в одном сегменте обычно указывает на неактуальность номеров или отсутствие согласия.
Часто задаваемые вопросы
Что означает ошибка WhatsApp 131026?
При сообщении «Не удалось доставить сообщение» Meta указывает на три возможные причины: номер не является WhatsApp-номером, получатель не принял последние Условия обслуживания и Политику конфиденциальности или получатель использует устаревшую версию WhatsApp.
Стоит ли повторно отправлять сообщение, если возникла ошибка 131026?
Не стоит пытаться отправить его в WhatsApp сразу же. Вместо этого отправьте срочный контент через SMS и попросите клиента подтвердить свой номер WhatsApp через другой канал связи.
Означает ли ответ 200 от WhatsApp API, что сообщение доставлено?
Нет. Это означает, что запрос был принят. Статус доставки (отправлено, доставлено, прочитано или ошибка) передается через статус-вебхук.
Могу ли я отправить сообщение клиенту в WhatsApp, если знаю, что у него есть аккаунт?
Нет. Политика Meta требует, чтобы пользователь предоставил вам свой номер и дал согласие на получение сообщений от вашего бизнеса в WhatsApp.
Что такое ошибка 131047?
С момента последнего ответа клиента прошло более 24 часов. Вместо произвольного сообщения отправьте сообщение по утвержденному шаблону.
Какой канал должен использоваться в качестве резервного для WhatsApp?
В большинстве случаев — SMS, так как они доставляются на любой мобильный номер. Для одноразовых паролей дополнительным резервным каналом является голосовая связь, если это поддерживается платформой.
Могу ли я проверить номер перед отправкой?
Да, при наличии соответствующих юридических оснований. Сначала проверьте тип линии; для клиентов, давших согласие, MobileValidate может проверить регистрацию в таких приложениях, как Telegram, Viber и RCS, а BroadNet HLR Lookup позволяет получить статус сети в реальном времени.
Как BroadNet отправляет резервное SMS?
Omnichannel API применяет ваши правила резервирования в рамках одного запроса, и OTP API автоматически переключается между SMS, WhatsApp, голосом и Flash Call.
Все нижеперечисленные источники были проверены 27 сентября 2026 года. Ознакомьтесь с нашими редакционными стандартами.
Источники
- Meta для разработчиков — коды ошибок WhatsApp Cloud API (131026, 131047), дата обращения: 27 сентября 2026: developers.facebook.com.
- Meta для разработчиков — справочник вебхуков статуса сообщений, доступ к которому осуществлялся 27 сентября 2026 г.: developers.facebook.com.
- Политика WhatsApp Business Messaging — требования к согласию и отказу от рассылки, доступ к которой осуществлялся 27 сентября 2026 г.: whatsappbusiness.com/policy.
- MobileValidate — справочник услуг и поиск оператора, последнее обновление 25 сентября 2026 г.: mobilevalidate.com/docs/services, mobilevalidate.com/services/carrier-lookup.
- MobileValidate — политика допустимого использования, доступ к которой осуществлялся 27 сентября 2026 г.: mobilevalidate.com/legal/acceptable-use.
