Ошибки SMS и мессенджеров

На этой странице перечислены ошибки, которые отправка SMS или сообщения в мессенджер может показать на вкладке Ошибки в Статистика сообщения, и что делать с каждой из них. Ошибки, которые может показать любая платформа, например Phone Number Not Found или Skip Push, описаны на странице Как читать вкладку «Ошибки».

Как ошибки SMS и мессенджеров отображаются на вкладке «Ошибки»

Вкладка Ошибки группирует неудачные отправки по платформам. В каждой строке указано название ошибки с кодом в скобках, например Invalid To Phone Number (1001).

Поиск ошибки

Ищите ошибку по названию и коду вместе. Один и тот же код может обозначать разные ошибки, потому что Pushwoosh проверяет сообщение на нескольких этапах. Например, Skip Push (1011) и Send Quota Exceeded (1011) — это разные ошибки.

Большинство ошибок приходит от вашего SMS-провайдера или мессенджера. Pushwoosh относит их к категории Ошибка провайдера независимо от причины. Что означает каждая категория, см. в разделе Категории ошибок.

Что не отображается на вкладке «Ошибки»

На вкладке отображаются только ошибки, возвращенные в момент, когда Pushwoosh отправляет сообщение. Следующие случаи в ней не отображаются:

Сбои после того, как провайдер или мессенджер принял сообщение. Например, сбой у мобильного оператора. Отправка считается принятой.
Некоторые временные сбои. К ним относится большинство сетевых ошибок. Pushwoosh повторяет такие отправки. В WhatsApp сетевая ошибка не повторяется и отображается как Internal Service Error (10006).
Подписчики, пропущенные из-за отсутствия маркетингового согласия. Pushwoosh исключает их из аудитории до отправки, поэтому они не считаются ошибками.

Ошибки SMS

Эти ошибки приходят от вашего SMS-провайдера или связаны с настройками SMS в вашем проекте. Какие ошибки вы увидите, зависит от провайдера. Например, Twilio сообщает об отказе от рассылки, неверном номере и отправителе, не разрешенном для страны, как Bad Request (1006), а не как более конкретные ошибки ниже.

Проблемы с номером телефона

Эти ошибки вызваны номером телефона получателя, а не настройкой провайдера.

Ошибка	Описание	Что делать
Invalid To Phone Number (1001)	Номер телефона не удается распознать, или в нем нет кода страны. Pushwoosh отписывает номер от SMS.	Храните номера телефонов в международном формате с кодом страны, например `+14155550100`, и зарегистрируйте номер заново.
Unsubscribed Recipient (1002)	Человек отписался от ваших сообщений через мобильного оператора, или номер находится в списке блокировки вашего провайдера. После отказа через оператора Pushwoosh отписывает номер от SMS и фиксирует отказ.	Не отправляйте маркетинговые сообщения на этот номер. См. Отказы, которые Pushwoosh фиксирует автоматически. Если человек не отказывался от рассылки, проверьте список блокировки в панели управления провайдера.

Аккаунт и настройка провайдера

Эти ошибки означают, что SMS-провайдер отклонил запрос из-за аккаунта, учетных данных, отправителя или сообщения.

Ошибка	Описание	Что делать
Bad Request (1006)	Провайдер отклонил запрос. В Twilio сюда также относятся отказ человека от рассылки через мобильного оператора, неверный или не мобильный номер и отправитель, не разрешенный для страны получателя.	Проверьте номер получателя и отправителя для этой страны в панели управления провайдера. Если человек отказался от рассылки, прекратите отправлять ему сообщения.
No Permission For Region (1003)	Страна получателя не разрешена для этого проекта или провайдера, либо учетные данные провайдера или отправитель не настроены в конфигурации SMS.	Проверьте учетные данные провайдера и номер отправителя в конфигурации SMS. Если они верны, обратитесь в службу поддержки Pushwoosh, чтобы уточнить, в какие страны проект может отправлять SMS.
Invalid To From Combination (1012)	Ваш ID отправителя не может отправлять сообщения в страну получателя, или ID отправителя не задан в конфигурации SMS.	Уточните в панели управления провайдера, какого отправителя использовать для этой страны.
Permission Denied (1015)	Провайдер не принял ваши учетные данные.	Сверьте учетные данные в конфигурации SMS с панелью управления провайдера.
Forbidden (1007)	Провайдер отклонил запрос или подключение, например из-за неверных учетных данных, или подключение SMS не настроено.	Сверьте учетные данные в конфигурации SMS с панелью управления провайдера.
Account Is Inactive (1014)	Ваш аккаунт у SMS-провайдера приостановлен.	Восстановите аккаунт у провайдера.
Not Found (1008)	Провайдер не нашел аккаунт или отправителя, указанных в запросе.	Проверьте настройки аккаунта и отправителя в панели управления провайдера.
Invalid MMS Attachment (1016)	Провайдер отклонил вложенный файл из-за его формата или размера.	Прикрепите файл меньшего размера в формате, который поддерживает ваш провайдер.
Internal Service Error (10006)	Для SMS эта ошибка также может означать, что отправка SMS не включена для вашего аккаунта.	Обратитесь в службу поддержки Pushwoosh.

Лимиты отправки

Эта ошибка означает, что отправка уперлась в лимит на количество SMS, а не в проблему с сообщением.

Ошибка	Описание	Что делать
Send Quota Exceeded (1011)	Проект достиг дневного лимита SMS, или провайдер ограничил отправку. Pushwoosh устанавливает дневной лимит SMS при настройке SMS для проекта.	Обратитесь в службу поддержки Pushwoosh по поводу дневного лимита SMS. Разбивайте крупные рассылки на несколько дней.

Сбои провайдера

Эти ошибки означают, что провайдеру не удалось обработать сообщение или он вернул ответ, который Pushwoosh не смог прочитать.

Ошибка	Описание	Что делать
Unknown Error (1000), Converting Error (1004), Provider Unknown Error (1009), Provider Internal Error (1010)	Провайдер вернул ошибку, которую Pushwoosh не распознает, или произошел сбой на его стороне. Converting Error также может означать, что настройки провайдера в конфигурации SMS заполнены не полностью.	Сравните количество этих ошибок с предыдущими отправками похожего объема. Если их становится больше или они повторяются при каждой отправке, обратитесь в службу поддержки Pushwoosh.

Ошибки Viber

Помимо ошибок, которые может показать любая платформа, отправки в Viber могут показывать эти две. Pushwoosh отправляет сообщения Viber через MStat, используя учетные данные MStat из вашей конфигурации SMS.

Если у подписчика вообще нет контакта Viber в проекте, отправка завершается ошибкой Push Token Not Found (1007) — одной из ошибок, которые может показать любая платформа.

Ошибка	Описание	Что делать
No Device For Push Token (10002)	Контакт Viber подписчика сохранен без номера телефона.	Зарегистрируйте номер подписчика для Viber заново. См. Регистрация контактов Viber.
Internal Service Error (10006)	Отсутствуют учетные данные MStat или ID аккаунта, содержимое сообщения недопустимо, или MStat отклонил сообщение. Вкладка Ошибки не показывает, что именно.	Убедитесь, что MStat настроен с действительными учетными данными в конфигурации SMS, и проверьте содержимое сообщения. Если и то и другое в порядке, обратитесь в службу поддержки Pushwoosh.

Ошибки WhatsApp

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

Сообщения вне 24-часового окна

Сообщение в свободной форме, то есть отправленное без одобренного шаблона, доходит до человека только в течение 24 часов после его последнего сообщения на ваш бизнес-номер. За пределами этого окна отправка завершается одной из этих ошибок.

Ошибка	Описание	Что делать
Re Engagement Message (1030)	Человек не писал на ваш бизнес-номер в последние 24 часа.	Отправьте одобренный шаблон вместо текста в свободной форме.
Processing Error (1035)	Pushwoosh пропустил сообщение в свободной форме, потому что 24-часовое окно уже закрылось.	Отправьте одобренный шаблон вместо текста в свободной форме.

Ошибки получателя

Эти ошибки вызваны получателем или тем, как часто вы ему пишете.

Ошибка	Описание	Что делать
Recipient Invalid Phone Number (1011)	Номер получателя совпадает с вашим бизнес-номером.	Исключите свой бизнес-номер из аудитории.
Accounts Pair Rate Limit Hit (1059)	Вы отправили слишком много сообщений одному и тому же человеку за короткое время.	Увеличьте интервалы между сообщениями одному и тому же человеку.

Ошибки шаблона и контента

Эти ошибки означают, что Meta отклонила шаблон или содержимое сообщения.

Ошибка	Описание	Что делать
Template Does Not Exist (1037)	Шаблона нет на выбранном языке, или он еще не одобрен.	Проверьте шаблон и его языки в WhatsApp Manager, затем выберите одобренный шаблон в пресете.
Template Param Count Mismatch (1036)	Количество значений переменных не совпадает с количеством переменных в шаблоне.	Заполните в пресете все переменные шаблона.
Template Parameter Format Mismatch (1040)	Значение переменной имеет неверный формат.	Сверьте значения переменных с шаблоном в WhatsApp Manager.
Template Hydrated Text Too Long (1038)	После подстановки переменных текст получается слишком длинным.	Сократите значения переменных или текст шаблона.
Template Format Character Policy Violated (1039)	Содержимое шаблона нарушает политику WhatsApp.	Отредактируйте шаблон в WhatsApp Manager и снова отправьте его на одобрение.
Template Is Paused (1041)	Meta приостановила шаблон из-за низкого качества. Это не то же самое, что Silent Hours (1041), см. Как читать вкладку «Ошибки».	Используйте другой одобренный шаблон или улучшите этот в WhatsApp Manager.
Template Is Disabled (1042)	Meta приостанавливала шаблон слишком много раз и отключила его навсегда.	Создайте новый шаблон и используйте его в пресете.
Request Invalid Parameter (1010), Request Missing Required Parameter (1009), Parameter Value Is Not Valid (1020), Generic User Error (1053)	Значение в сообщении отсутствует или недопустимо.	Проверьте пресет: шаблон, переменные, кнопки и вложение.
Unsupported Message Type (1032)	WhatsApp не поддерживает этот тип сообщения.	Измените тип контента в пресете.
Media Upload Error (1034)	Meta не удалось загрузить вложенный медиафайл.	Используйте файл по публичному URL с `https` в формате, который поддерживает WhatsApp.

Ошибки аккаунта и качества

Эти ошибки означают, что Meta ограничила ваш WhatsApp Business Account или бизнес-номер. Устраните их в WhatsApp Manager, как описано в разделе Как исправить заблокированного или ограниченного отправителя.

Ошибка	Описание	Что делать
Temporarily Blocked For Policies Violations (1005)	Meta заблокировала аккаунт за нарушение своих правил.	Проверьте статус аккаунта в WhatsApp Manager.
Account Has Been Locked (1017)	Meta заблокировала аккаунт за нарушение правил или не смогла проверить данные в запросе.	Проверьте статус аккаунта в WhatsApp Manager.
Account Is Restricted From Messaging In This Country (1016)	Аккаунт не может отправлять сообщения пользователям в этой стране.	Проверьте ограничения аккаунта в WhatsApp Manager.
Spam Rate Limit Hit (1008)	Meta ограничивает количество сообщений с этого номера, потому что многие предыдущие сообщения были заблокированы или отмечены как спам.	Проанализируйте контент и аудиторию последних сообщений, затем уменьшите объем отправок.
Business Eligibility Payment Issue (1028)	Возникла проблема со способом оплаты аккаунта.	Проверьте способ оплаты в WhatsApp Manager.
Provided Number Needs Display Name Approval (1027)	Отображаемое имя вашего бизнес-номера еще не одобрено.	Дождитесь одобрения или измените отображаемое имя в WhatsApp Manager.
Business Phone Number Is Deleted (1024)	Ваш бизнес-номер был удален.	Подключите активный номер в конфигурации WhatsApp.
Account In Maintenance Mode (1035)	Аккаунт находится в режиме обслуживания. Это не та же ошибка, что Processing Error (1035) в разделе Сообщения вне 24-часового окна.	Повторите попытку позже.

Ошибки настройки и разрешений

Эти ошибки означают, что подключение между Pushwoosh и вашим WhatsApp Business Account не работает. Переподключите WhatsApp Business Account в Settings > Configure Platforms > WhatsApp, как описано в разделе Конфигурация WhatsApp.

Ошибка	Описание	Что делать
Access Token Expired (1003)	Срок действия токена доступа подключения истек.	Переподключите аккаунт.
Authentication Failed (1002), Permission Denied (1013), API Permission (1014), API Method (1015), Access Denied (1023)	Meta не приняла подключение, или не хватает разрешения.	Переподключите аккаунт и предоставьте все запрашиваемые разрешения.
Incorrect Certificate (1029)	Бизнес-номер зарегистрирован неправильно.	Проверьте бизнес-номер в WhatsApp Manager, затем переподключите аккаунт.
Internal Service Error (10006)	В настройке WhatsApp отсутствует бизнес-номер или токен доступа, либо Pushwoosh не смог связаться с Meta или прочитать ее ответ.	Проверьте настройку WhatsApp и при необходимости переподключите аккаунт. Если ошибка повторяется, обратитесь в службу поддержки Pushwoosh.

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

Эти ошибки означают, что вы отправляли быстрее, чем Meta разрешает для вашего приложения или аккаунта.

Ошибка	Описание	Что делать
Rate Limit Hit (1058)	Достигнута пропускная способность вашего номера по сообщениям.	Снизьте скорость отправки или разбейте отправку на небольшие партии.
API Too Many Calls (1056), Rate Limit Issues (1057)	Приложение или аккаунт достигли лимита запросов.	Снизьте скорость отправки или разбейте отправку на небольшие партии.

Временные ошибки Meta

Эти ошибки означают, что на стороне Meta произошел сбой или она вернула ответ, который Pushwoosh не распознает.

Ошибка	Описание	Что делать
API Unknown (1018), API Service (1019), Something Went Wrong (1022), Service Unavailable (1025), Server Temporary Unavailable (1046)	Временная ошибка на стороне Meta.	Отправьте сообщение позже. Если ошибка повторяется, обратитесь в службу поддержки Pushwoosh, указав дату сообщения и Код сообщения.
Unknown Error (1000), Cannot Process Sending (1012)	Meta вернула ошибку, которую Pushwoosh не распознает, или ответ, который он не смог прочитать.	Если ошибка повторяется, обратитесь в службу поддержки Pushwoosh, указав дату сообщения и Код сообщения.

Ошибки Telegram

Отправки в Telegram показывают две собственные ошибки.

Ошибка	Описание	Что делать
Chat Unavailable (410007)	Человек заблокировал или удалил бота, чат не найден, или аккаунт Telegram деактивирован. Pushwoosh отписывает человека от Telegram.	Исправлять нечего. Человек не может получать сообщения от бота.
Invalid Authentication Info (401002)	Токен бота отсутствует или недействителен. Эта ошибка также появляется, когда ID чата Telegram у подписчика недействителен (в этом случае Pushwoosh отписывает этого подписчика), или когда Pushwoosh не смог связаться с Telegram, чтобы проверить токен.	Проверьте токен бота в конфигурации Telegram.

Ошибки Facebook Messenger

Эти ошибки приходят от Meta, когда Pushwoosh отправляет сообщение от имени вашей страницы Facebook.

Ошибка	Описание	Что делать
Outside Allowed Window (403004)	Человек не писал вашей странице в последние 24 часа, а у сообщения нет тега сообщения. Pushwoosh не исключает таких людей из аудитории, поэтому каждая такая отправка завершается этой ошибкой.	За пределами 24-часового окна отправляйте сообщения с тегом сообщения. См. Использование тега сообщения за пределами 24-часового окна.
Recipient Unavailable (410005)	Человек не может получать сообщения от вашей страницы. Pushwoosh отписывает человека от Facebook Messenger.	Исправлять нечего.
Invalid Authentication Info (401002)	Page ID или Page Access Token отсутствует, или Meta не приняла токен.	Укажите действительные Page ID и Page Access Token в конфигурации Facebook Messenger.
No Permission (403003)	У вашего Meta App нет разрешения, необходимого для этой отправки.	Проверьте разрешения Messenger для вашего Meta App в панели управления Meta App.
Invalid Request Parameter (400001)	Сообщение пустое или содержит недопустимое значение.	Проверьте содержимое сообщения.
Internal Server Error (5009999)	Meta вернула ошибку, которую Pushwoosh не распознает.	Если ошибка повторяется, обратитесь в службу поддержки Pushwoosh, указав дату сообщения и Код сообщения.

Ошибки Kakao

Большинство ошибок Kakao приходит от сервиса обмена сообщениями KakaoTalk. Pushwoosh показывает каждую из них под собственным названием; ниже они сгруппированы по тому, что нужно проверить.

Ошибка	Описание	Что делать
Missing User Code (4001200), Missing Secret Key (4001201)	Учетные данные KakaoTalk не заполнены.	Укажите USER CODE и SECRET KEY в конфигурации Kakao.
Invalid Authentication Info (401002), Invalid Token (401005), Token Expired (401006), Missing Authorization Header (401004), No Permission (403003), Unregistered Account (4001100)	Сервис не принял токен доступа или ваш аккаунт.	Проверьте USER CODE и SECRET KEY в конфигурации Kakao. Если они верны, обратитесь в службу поддержки Pushwoosh.
Unauthorized IP Address (4031101)	Сервис не принимает запросы с адреса, с которого отправляет Pushwoosh.	Обратитесь в службу поддержки Pushwoosh.
Insufficient Balance (4001102)	На вашем аккаунте обмена сообщениями KakaoTalk закончился баланс.	Пополните баланс аккаунта обмена сообщениями KakaoTalk.
Unit Price Not Found (5001103)	У сервиса нет цены за единицу для этого сообщения в вашем аккаунте.	Обратитесь в службу поддержки Pushwoosh.
Unauthorized Sender Key (4001104), Missing Sender Key (4001301), Missing Sender Number (4001208), Invalid Sender Number Not Registered (400667), Invalid Sender Number Policy Violation (400668)	Профиль отправителя или номер отправителя не зарегистрирован или не разрешен.	Проверьте профиль отправителя и номер отправителя в вашем аккаунте обмена сообщениями KakaoTalk.
Template Code Not Found (4001105), Missing Template Code (4001303)	Код шаблона в сообщении отсутствует или не соответствует зарегистрированному шаблону.	Убедитесь, что в сообщении используется одобренный шаблон Kakao.
Recipient Opted Out (400090)	Человек отказался от ваших сообщений в KakaoTalk.	Не отправляйте маркетинговые сообщения этому человеку.
Missing Recipient Number (4001202), Invalid Recipient Number Format (4001204), Recipient Number Too Long (4001203), Missing Country Code (4001210), Invalid Country Code Format (4001212)	Номер телефона получателя отсутствует или имеет неверный формат.	Храните номера телефонов в международном формате с кодом страны и зарегистрируйте номер заново.
Missing Message Body (4001206), Message Body Too Long (4001207), Title Too Long (4001205), Header Too Long (4001306), Invalid Request Parameter (400001) и другие ошибки с названиями … Too Long или Invalid …	Часть сообщения отсутствует, слишком длинная или содержит недопустимое значение.	Исправьте поле, названное в ошибке, в пресете KakaoTalk или в сообщении.
Internal Server Error (5009999)	На стороне сервиса произошел сбой, или он вернул ошибку, которую Pushwoosh не распознает.	Если ошибка повторяется, обратитесь в службу поддержки Pushwoosh, указав дату сообщения и Код сообщения.

Ошибки LINE

Большинство ошибок LINE соответствуют HTTP-статусу, который вернул LINE Messaging API.

Ошибка	Описание	Что делать
Unable To Get Channel ID (1011), Unable To Get Channel Secret (1012)	Channel ID или Channel secret не заполнен.	Укажите оба значения в конфигурации LINE.
Authentication Failed (1003)	LINE не принял токен доступа для канала, например потому что channel secret был изменен.	Сверьте Channel ID и Channel secret с LINE Developers Console.
Duplicate Post (1006)	LINE отклонил запрос как дубликат или потому что каналу не разрешено использовать эту часть Messaging API.	Проверьте тариф и разрешения вашего LINE Official Account. Если они в порядке, обратитесь в службу поддержки Pushwoosh.
Profile Not Found (1005), Access Not Available (1007)	Получатель или запрошенный ресурс больше недоступен в LINE.	Для этого получателя исправлять нечего.
Bad Request (1002)	LINE отклонил запрос.	Проверьте содержимое сообщения и пресет LINE.
Payload Too Large (1008)	Сообщение больше, чем допускает LINE.	Уменьшите сообщение или его медиафайлы.
Unsupported Media Type (1009)	LINE не поддерживает тип вложенного файла.	Прикрепите файл в формате, который поддерживает LINE.
Too Many Requests (1010)	Канал достиг ограничения скорости запросов LINE или месячного лимита сообщений.	Снизьте скорость отправки или проверьте лимит сообщений в тарифе вашего LINE Official Account.
Internal Server Error (1001), Unknown Error (1000)	На стороне LINE произошел сбой, или LINE вернул ошибку, которую Pushwoosh не распознает.	Отправьте сообщение позже. Если ошибка повторяется, обратитесь в службу поддержки Pushwoosh.