Платформа WhatsApp Business > Облачный API

Коды ошибок облачного API

Облачный API создан на основе Graph API. Если вы не знаете, как обрабатывать ответы на ошибки в Graph API, ознакомьтесь с соответствующей документацией.

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

Заголовки кодов, которые не имеют выделенного свойства в полезной нагрузке ответа на ошибку API, указываются как часть значения message. Однако мы рекомендуем не полагаться на заголовки при обработке ошибок, поскольку со временем они будут упразднены.

Получение сообщений об ошибках: синхронное и асинхронное

Ошибки облачного API возвращаются либо синхронно в виде ответа Graph API, либо асинхронно через Webhooks, а иногда и обоими способами.

При работе с облачным API для обработки ошибок рекомендуется отслеживать как ответ Graph API, так и Webhooks messages. Если вы подписаны на поле Webhooks messages, для поддерживаемых асинхронных типов ошибок вы будете получать уведомления по мере возникновения ошибок.

Webhooks и синтаксис ответов с сообщением об ошибке

Ошибки облачного API могут передаваться в перечисленных ниже объектах Webhooks.

Облачный API

entry.changes.value.errors
entry.changes.value.messages.errors

Локальный API

errors

Синтаксис ответа с сообщением об ошибке

{
  "error": {
    "message": "<MESSAGE>",
    "type": "<TYPE>",
    "code": <CODE>,
    "error_data": {
        "messaging_product": "whatsapp",
        "details": "<DETAILS>"
    },
    "error_subcode": <ERROR_SUBCODE>
    "fbtrace_id": "<FBTRACE_ID>"
  }
}

Содержимое ответа с сообщением об ошибке

Свойство	Тип значения	Описание
`code`	Целое число	Код ошибки. Мы рекомендуем вам выстраивать логику обработки ошибок своего приложения вокруг кодов ошибок, а не подкодов или кодов статуса ответа HTTP.
`details`	Строка	Описание ошибки и наиболее вероятной причины ее появления. Также может содержать информацию о том, как устранить эту ошибку, например какой параметр недействителен или какие значения являются приемлемыми.
`error_subcode`	Целое число	Больше не используется. Не будет возвращаться в ответах в версии 16.0 и более поздних. Подкод Graph API. Не все ответы содержат подкод, поэтому мы рекомендуем выстраивать логику обработки ошибок вокруг свойств и `code` и `details`.
`fbtrace_id`	Строка	ID трассировки, который вы можете указать при обращении в прямую поддержку. Этот ID может помочь нам устранить возникшую ошибку.
`message`	Строка	Комбинация кода ошибки и его заголовка. Пример: `(#130429) Rate limit hit`.
`messaging_product`	Строка	Продукт для обмена сообщениями. Это всегда будет строка `whatsapp` для ответов облачного API.
`type`	Строка	Тип ошибки.

Пример ответа

{
  "error": {
    "message": "(#130429) Rate limit hit",
    "type": "OAuthException",
    "code": 130429,
    "error_data": {
        "messaging_product": "whatsapp", 
        "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time"
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

Коды ошибок

Ошибки авторизации

Код	Описание	Возможные решения	Код статуса HTTP
`0` Исключение аутентификации	Нам не удалось аутентифицировать пользователя приложения.	Часто это означает, что ��рок действия указанного маркера доступа истек или этот маркер стал недействительным, либо пользователь изменил настройку, чтобы запретить всем приложениям доступ к своим данным. Мы рекомендуем вам получить новый маркер доступа.	`401` Не выполнена авторизация
`3` Метод API	Проблема с возможностями или разрешениями.	Чтобы убедиться, что вашему приложению предоставлены разрешения, которые запрашиваются конечной точкой, используйте отладчик маркера доступа. См. раздел Устранение неполадок.	`500` Внутренняя ошибка сервера
`10` Разрешение отменено	Разрешение не предоставлено или отозвано.	Используйте отладчик маркера доступа, чтобы убедиться, что вашему приложению предоставлены разрешения, которые запрашиваются конечной точкой. См. раздел Устранение неполадок. Убедитесь, что номер телефона, используемый для настройки открытого ключа компании, занесен в список разрешений.	`403` Запрещено
`190` Истек срок действия маркера доступа	Срок действия вашего маркера доступа истек.	Получите новый маркер доступа.	`401` Не выполнена авторизация
`200-299` Разрешение для API	Разрешение не предоставлено или отозвано.	Используйте отладчик маркера доступа, чтобы убедиться, что вашему приложению предоставлены разрешения, которые запрашиваются конечной точкой. См. раздел Устранение неполадок.	`403` Запрещено

Ошибка регулирования

Код	Описание	Возможные решения	Код статуса HTTP
`4` Слишком много вызовов API	Приложение достигло ограничения количества вызовов API.	Загрузите приложение на панели приложений и см. статью Ограничение числа обращений на уровне приложения, чтобы проверить, достигло ли приложение установленного для него ограничения количества вызовов. Если ограничение достигнуто, повторите попытку позже или уменьшите частоту или количество запросов API, выполняемых приложением.	`400` Неправильный запрос
`80007` Проблемы с ограничением числа обращений	Аккаунт WhatsApp Business достиг установленного для него ограничения числа обращений.	См. Ограничения числа обращений для аккаунта WhatsApp Business. Повторите попытку позже или уменьшите частоту или количество запросов API, выполняемых приложением.	`400` Неправильный запрос
`130429` Достигнут лимит обращений	Облачный API достиг максимальной пропускной способности для сообщений.	Приложение достигло ограничения пропускной способности для API. См. статью Пропускная способность. Повторите попытку позже или уменьшите частоту отправки сообщений приложением.	`400` Неправильный запрос
`131048` Достигнут лимит сообщений, помеченных как спам	Не удалось отправить сообщение: на количество сообщений, отправляемых с этого номера телефона, установлены ограничения. Это может быть связано с тем, что слишком много предыдущих сообщений было заблокировано или помечено как спам.	Проверьте свой статус качества в WhatsApp Manager и ознакомьтесь с документом Показатель качества и ограничения на количество обращений для получения дополн��тельной информации.	`400` Неправильный запрос
`131056` Достигнут лимит обращений для пары (бизнес-аккаунт, аккаунт потребителя)	Слишком много сообщений отправлено с номера телефона отправителя на один и тот же номер получателя за короткое время.	Подождите некоторое время и повторите эту операцию, если вы намереваетесь отправить сообщения на тот же самый номер телефона. При этом вы можете отправлять сообщения на другой номер без ожидания.	`400` Неправильный запрос
`133016` Превышено ограничение на количество регистраций и отмены регистраций аккаунтов	Сбой регистрации или отмены регистрации, поскольку для этого номера телефона в течение короткого периода времени было предпринято слишком много попыток.	Номер телефона компании блокируется, потому что для него достигнуто предельное количество попыток регистрации или отмены регистрации. Повторите попытку после разблокировки номера. См. раздел "Ограничения" в документе Регистрация.	`400` Неправильный запрос

Ошибки целостности

Код Описание Возможные решения Код статуса HTTP

Код	Описание	Возможные решения	Код статуса HTTP
`368` Временно заблокировано из-за нарушений политик	Аккаунт WhatsApp Business, связанный с приложением, заблокирован или деактивирован из-за нарушения политики платформы.	Информацию о нарушениях политики и способах их устранения см. в документе Соблюдение политики.	`403` Запрещено
`131031` Аккаунт заблокирован	Аккаунт WhatsApp Business, связанный с приложением, заблокирован или деактивирован из-за нарушения политики платформы, либо нам не удалось проверить данные в запросе и сравнить их с набором данных в аккаунте WhatsApp Business (например, PIN-код двухшаговой проверки, указанный в запросе, является неверным).	Инфо��мацию о нарушениях политики и способах их устранения см. в документе Соблюдение политики. Вы также можете использовать Health Status API, который может предоставить дополнительные аналитические сведения о причинах блокировки аккаунта.	`403` Запрещено

368

Временно заблокировано из-за нарушений политик

Аккаунт WhatsApp Business, связанный с приложением, заблокирован или деактивирован из-за нарушения политики платформы.

Информацию о нарушениях политики и способах их устранения см. в документе Соблюдение политики.

403

Запрещено

131031

Аккаунт заблокирован

Аккаунт WhatsApp Business, связанный с приложением, заблокирован или деактивирован из-за нарушения политики платформы, либо нам не удалось проверить данные в запросе и сравнить их с набором данных в аккаунте WhatsApp Business (например, PIN-код двухшаговой проверки, указанный в запросе, является неверным).

Инфо��мацию о нарушениях политики и способах их устранения см. в документе Соблюдение политики.

Вы также можете использовать Health Status API, который может предоставить дополнительные аналитические сведения о причинах блокировки аккаунта.

403

Запрещено

Другие ошибки

Код Описание Возможные решения Код статуса HTTP

Код	Описание	Возможные решения	Код статуса HTTP
`1` API неизвестен	Недопустимый запрос или ошибка сервера.	Чтобы посмотреть информацию о статусе API, перейдите на страницу статуса платформы WhatsApp Business. Если перебои в работе сервера отсутствуют, ознакомьтесь со справкой по конечной точке и убедитесь, что запрос имеет правильный формат и соответствует всем требованиям конечной точки.	`400` Неправильный запрос
`2` Служба API	Временно недоступна из-за вынужденной остановки или чрезмерной нагрузки.	Перед повторной попыткой проверьте информацию о статусе API на странице статуса платформы WhatsApp Business.	`503` Служба недоступна
`33` Недействительное значение параметра	Номер телефона компании удален.	Убедитесь, что номер телефона компании указан правильно.	`400` Неправильный запрос
`100` Недействительный параметр	Запрос содержит один или несколько неподдерживаемых или неправильно написанных параметров.	Чтобы определить, какие параметры поддерживаются и каким должно быть их написание, обратитесь к справке по конечной точке. Убедитесь, что используется действительный открытый 2048-битный ключ в формате PEM. Проверьте, совпадают ли что ID регистрируемого номера телефона и ID номера телефона, сохраненного ранее. Ваш параметр не должен превышать ограничение по длине для этого типа.	`400` Неправильный запрос
`130472` Номер пользователя участвует в эксперименте	Сообщение не было отправлено в рамках эксперимента.	См. информацию об отправке маркетинговых сообщений в рамках эксперимента.	`400` Неправильный запрос
`131000` Произошла ошибка	Не удалось отправить сообщение из-за неизвестной ошибки. При настройке открытого ключа компании не удалось вычислить подпись или вызвать конечную точку GraphQL, либо конечная точка GraphQL вернула ошибку.	Повторите попытку. Если устранить ошибку не удается, оформите запрос в прямой поддержке.	`500` Внутренняя ошибка сервера
`131005` Доступ запрещен	Разрешение не предоставлено или отменено.	Используйте отладчик маркера доступа, чтобы убедиться, что вашему приложению предоставлены разрешения, которые запрашиваются конечной точкой. См. раздел Устранение неполадок.	`403` Запрещено
`131008` Не указан обязательный параметр	В запросе отсутствует обязательный параметр.	См. справку конечной точки, чтобы определить, какие параметры необходимы.	`400` Неправильный запрос
`131009` Недействительное значение параметра	Одно или несколько значений параметров недействительны.	Чтобы определить, какие значения поддерживаются для каждого параметра, см. справку по конечной точке. Чтобы узнать, как добавить номер телефона в аккаунт WhatsApp Business, см. статью Номера телефонов.	`400` Неправильный запрос
`131016` Служба недоступна	Служба временно недоступна.	Перед повторной попыткой проверьте информацию о статусе API на странице статуса платформы WhatsApp Business.	`500` Внутренняя ошибка сервера
`131021` Получатель не может быть отправителем	Номера телефонов отправителя и получателя совпадают.	Сообщения можно отправлять только на номера, не совпадающие с номером отправителя.	`400` Неправильный запрос
`131026` Невозможно доставить сообщение	Невозможно доставить сообщение. Возможные причины: Номер телефона получателя отсутствует в WhatsApp. Отправка шаблона категории "Аутентификация" пользователю WhatsApp с кодом страны +91 (Индия). В настоящее время шаблоны категории "Аутентификация" нельзя отправлять пользователям WhatsApp в Индии. Получатель не принял новые версии Пользовательского соглашения и Политики конфиденциальности. Получатель использует старую версию WhatsApp. Он должен использовать версию WhatsApp не ниже следующей: Android: 2.21.15.15; SMBA: 2.21.15.15; iOS: 2.21.170.4; SMBI: 2.21.170.4; KaiOS: 2.2130.10; веб-версия: 2.2132.6. Сообщение не было доставлено для создания высококачественного пользовательского опыта. См. статью Ограничения количества сообщений с шаблоном типа "Маркетинг" на пользователя.	Свяжитесь с пользователем вне WhatsApp и попросите его: подтвердить, что он может отправлять сообщения на ваш рабочий номер телефона WhatsApp; подтвердить, что он принял наши действующие условия предоставления услуг (пользователь должен выбрать Настройки > Справка или Настройки > Информация о приложении, после чего откроется окно, в котором он сможет принять наши действующие условия или политики, если он ещё этого не сделал); установить WhatsApp последней версии.	`400` Неправильный запрос
`131042` Соответствие компании правилам: проблема с платежами	Возникла ошибка, связанная с вашим способом оплаты.	См. статью О биллинге для аккаунта WhatsApp Business и убедитесь, что биллинг настроен правильно. Распространенные проблемы: Платежный аккаунт не связан с аккаунтом WhatsApp Превышено ограничение по кредитной линии Кредитная линия (платежный аккаунт) не задана или неактивна Аккаунт WhatsApp Business удален Аккаунт WhatsApp Business заблокирован Не указан часовой пояс Не указана валюта Запрос MessagingFor (от имени) ожидает подтверждения или отклонен Превышен предел бесплатных сообщений и отсутствует допустимый способ оплаты	`400` Неправильный запрос
`131045` Неверный сертификат	Не удалось отправить сообщение из-за ошибки регистрации номера телефона.	Перед повторной попыткой зарегистрируйте номер телефона.	`500` Внутренняя ошибка сервера
`131047` Сообщение для повторного вовлечения клиента	Более 24 часов прошло с того момента, как получатель в последний раз отправил сообщение на номер отправителя.	Вместо этого отправьте получателю сообщение от имени компании, используя шаблон сообщения.	`400` Неправильный запрос
`131051` Неподдерживаемый тип сообщения	Тип сообщения не поддерживается.	Перед повторной отправкой сообщения поддерживаемого типа см. статью Сообщения, чтобы узнать, какие типы сообщений поддерживаются.	`400` Неправильный запрос
`131052` Ошибка ска��ивания медиафайла	Не удается скачать отправленный пользователем медиафайл.	Не удалось скачать медиафайл по одной или нескольким причинам, например потому что этот тип файла не поддерживается. Чтобы узнать, почему не удалось скачать медиафайл, проверьте значение `error.error_data.details`. Попросите пользователя WhatsApp отправить вам медиафайл другим способом, не через WhatsApp.	`400` Неправильный запрос
`131053` Ошибка загрузки медиафайла	Не удается загрузить используемый в сообщении медиафайл.	Не удалось загрузить медиафайл по одной или нескольким причинам (например, потому что этот тип файла не поддерживается). Чтобы узнать, почему не удалось загрузить медиафайл, проверьте значение `error.error_data.details`. Рекомендуем проверить все медиафайлы, которые вызывают ошибки, и убедиться, что они действительно поддерживаются. Например, в UNIX можно запустить из командной стро��и функцию проверки файлов, чтобы определить тип MIME файла: `file -I rejected-file.mov` После этого вы можете проверить, указан ли этот тип MIME в нашем списке поддерживаемых типов медиафайлов. Информацию о том, как повысить надежность отправки медиафайлов, см. в разделах, посвященных HTTP-кэшированию и загрузке медиафайлов.	`400` Неправильный запрос
`131057` Аккаунт в режиме обслуживания	Бизнес-аккаунт находится в режиме обслуживания.	Аккаунт WhatsApp Business находится в режиме обслуживания. Одна из возможных причин — в аккаунте идет процесс увеличения производительности.	`500` Неправильный запрос
`132000` Не совпадает количество параметров в шаблоне	Количество значений переменных параметров, указанных в запросе, не соответствует количеству переменных параметров, определенных в шаблоне.	См. статью Руководство по шаблонам сообщений и убедитесь, что запрос содержит все значения переменных параметров, которые определены в шаблоне.	`400` Неправильный запрос
`132001` Шаблон отсутствует	Шаблон на указанном языке отсутствует или не был одобрен.	Убедитесь, что ваш шаблон был одобрен и что имя и язык шаблона указаны правильно. Обязательно следуйте руководству по шаблонам сообщений.	`404` Не найдено
`132005` Слишком длинный заполненный текст шаблона	Переведенный текст слишком длинный.	Воспользуйтесь WhatsApp Manager и проверьте, был ли ваш шаблон переведен. См. статью Оценка качества и статус шаблона.	`400` Неправильный запрос
`132007` Нарушение правил в отношении символов форматирования в шаблоне	Содержимое шаблона нарушает политику WhatsApp.	См. статью Причины отклонения, чтобы выяснить возможные причины нарушения.	`400` Неправильный запрос
`132012` Не совпадает формат параметра в шаблоне	Значения переменных параметров имеют неверный формат.	Значения переменных параметров в запросе не указаны в формате, обозначенном в шаблоне. См. статью Рекомендации по использованию шаблонов сообщений.	`400` Неправильный запрос
`132015` Работа шаблона приостановлена	Работа шаблона приостановлена из-за низкого качества, поэтому его нельзя использовать в сообщении.	Отредактируйте шаблон, чтобы повысить его качество, и повторите попытку после одобрения.	`400` Неправильный запрос
`132016` Шаблон отключен	Работа шаблона слишком много раз приостанавливалась из-за низкого качества, поэтому шаблон отключен навсегда.	Создайте новый шаблон с другим содержимым.	`400` Неправильный запрос
`132068` Процесс заблокирован	Процесс заблокирован.	Исправьте процесс.	`400` Неправильный запрос
`132069` Процесс регулируется	Процесс регулируется, и за последний час через этот процесс уже было отправлено 10 сообщений.	Исправьте процесс	`400` Неправильный запрос
`133000` Аннулирование регистрации не завершено	Предыдущая попытка аннулировать регистрацию не удалась.	Аннулируйте регистрацию номера повторно перед регистрацией.	`500` Внутренняя ошибка сервера
`133004` Сервер временно недоступен	Сервер временно недоступен.	Перед повторной попыткой проверьте информацию о статусе API на странице статуса платформы WhatsApp Business и значение `details` в ответе.	`503` Служба недоступна
`133005` Несовпадение PIN-кода двухшаговой проверки	Неверный PIN-код двухшаговой проверки.	Убедитесь, что в запросе указан правильный PIN-код двухшаговой проверки. Чтобы сбросить PIN-код двухшаговой проверки: Отключите двухшаговую проверку. Отправьте запрос POST, содержащий новый PIN-код, к конечной точке Номер телефона.	`400` Неправильный запрос
`133006` Необходимо повторное подтверждение номера телефона	Перед регистрацией номер телефона необходимо подтвердить.	Подтвердить номер телефона перед его регистрацией.	`400` Неправильный запрос
`133008` Слишком много попыток угадать PIN-код двухшаговой проверки	Для этого номера телефона предпринято слишком много попыток угадать PIN-код двухшаговой проверки.	Повторите попытку спустя время, которое указано для значения `details` в ответе.	`400` Неправильный запрос
`133009` PIN-код двухшаговой проверки угадан слишком быстро	PIN-код двухшаговой проверки был введен слишком быстро.	Перед повторной попыткой проверьте значение `details` в ответе.	`400` Неправильный запрос
`133010` Номер телефона не зарегистрирован	Номер телефона не зарегистрирован на платформе WhatsApp Business.	Перед повторной попыткой зарегистрируйте номер телефона.	`400` Неправильный запрос
`133015` Подождите несколько минут, прежде чем пытаться зарегистрировать этот номер телефона	Номер телефона, который вы пытаетесь зарегистрировать, был недавно удален, и процесс удаления ещё не завершён.	Подождите 5 минут, прежде чем отправлять повторный запрос.	`400` Неправильный запрос
`135000` Общая ошибка пользователя	Не удалось отправить сообщение из-за неизвестной ошибки с вашими параметрами запроса.	См. справку конечной точки, чтобы определить, запрашиваете ли вы конечную точку с использованием правильного синтаксиса. Обратитесь в службу поддержки клиентов, если вы по-прежнему получаете этот код ошибки в ответе.	`400` Неправильный запрос

1

API неизвестен

Недопустимый запрос или ошибка сервера.

Чтобы посмотреть информацию о статусе API, перейдите на страницу статуса платформы WhatsApp Business. Если перебои в работе сервера отсутствуют, ознакомьтесь со справкой по конечной точке и убедитесь, что запрос имеет правильный формат и соответствует всем требованиям конечной точки.

400

Неправильный запрос

2

Служба API

Временно недоступна из-за вынужденной остановки или чрезмерной нагрузки.

Перед повторной попыткой проверьте информацию о статусе API на странице статуса платформы WhatsApp Business.

503

Служба недоступна

33

Недействительное значение параметра

Номер телефона компании удален.

Убедитесь, что номер телефона компании указан правильно.

400

Неправильный запрос

100

Недействительный параметр

Запрос содержит один или несколько неподдерживаемых или неправильно написанных параметров.

Чтобы определить, какие параметры поддерживаются и каким должно быть их написание, обратитесь к справке по конечной точке.

Убедитесь, что используется действительный открытый 2048-битный ключ в формате PEM.

Проверьте, совпадают ли что ID регистрируемого номера телефона и ID номера телефона, сохраненного ранее.

Ваш параметр не должен превышать ограничение по длине для этого типа.

400

Неправильный запрос

130472

Номер пользователя участвует в эксперименте

Сообщение не было отправлено в рамках эксперимента.

См. информацию об отправке маркетинговых сообщений в рамках эксперимента.

400

Неправильный запрос

131000

Произошла ошибка

Не удалось отправить сообщение из-за неизвестной ошибки.

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

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

500

Внутренняя ошибка сервера

131005

Доступ запрещен

Разрешение не предоставлено или отменено.

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

403

Запрещено

131008

Не указан обязательный параметр

В запросе отсутствует обязательный параметр.

См. справку конечной точки, чтобы определить, какие параметры необходимы.

400

Неправильный запрос

131009

Недействительное значение параметра

Одно или несколько значений параметров недействительны.

Чтобы определить, какие значения поддерживаются для каждого параметра, см. справку по конечной точке. Чтобы узнать, как добавить номер телефона в аккаунт WhatsApp Business, см. статью Номера телефонов.

400

Неправильный запрос

131016

Служба недоступна

Служба временно недоступна.

Перед повторной попыткой проверьте информацию о статусе API на странице статуса платформы WhatsApp Business.

500

Внутренняя ошибка сервера

131021

Получатель не может быть отправителем

Номера телефонов отправителя и получателя совпадают.

Сообщения можно отправлять только на номера, не совпадающие с номером отправителя.

400

Неправильный запрос

131026

Невозможно доставить сообщение

Невозможно доставить сообщение. Возможные причины:

Номер телефона получателя отсутствует в WhatsApp.
Отправка шаблона категории "Аутентификация" пользователю WhatsApp с кодом страны +91 (Индия). В настоящее время шаблоны категории "Аутентификация" нельзя отправлять пользователям WhatsApp в Индии.
Получатель не принял новые версии Пользовательского соглашения и Политики конфиденциальности.
Получатель использует старую версию WhatsApp. Он должен использовать версию WhatsApp не ниже следующей:
- Android: 2.21.15.15;
- SMBA: 2.21.15.15;
- iOS: 2.21.170.4;
- SMBI: 2.21.170.4;
- KaiOS: 2.2130.10;
- веб-версия: 2.2132.6.
Сообщение не было доставлено для создания высококачественного пользовательского опыта. См. статью Ограничения количества сообщений с шаблоном типа "Маркетинг" на пользователя.

Свяжитесь с пользователем вне WhatsApp и попросите его:

подтвердить, что он может отправлять сообщения на ваш рабочий номер телефона WhatsApp;
подтвердить, что он принял наши действующие условия предоставления услуг (пользователь должен выбрать Настройки > Справка или Настройки > Информация о приложении, после чего откроется окно, в котором он сможет принять наши действующие условия или политики, если он ещё этого не сделал);
установить WhatsApp последней версии.

400

Неправильный запрос

131042

Соответствие компании правилам: проблема с платежами

Возникла ошибка, связанная с вашим способом оплаты.

См. статью О биллинге для аккаунта WhatsApp Business и убедитесь, что биллинг настроен правильно.

Распространенные проблемы:

Платежный аккаунт не связан с аккаунтом WhatsApp
Превышено ограничение по кредитной линии
Кредитная линия (платежный аккаунт) не задана или неактивна
Аккаунт WhatsApp Business удален
Аккаунт WhatsApp Business заблокирован
Не указан часовой пояс
Не указана валюта
Запрос MessagingFor (от имени) ожидает подтверждения или отклонен
Превышен предел бесплатных сообщений и отсутствует допустимый способ оплаты

400

Неправильный запрос

131045

Неверный сертификат

Не удалось отправить сообщение из-за ошибки регистрации номера телефона.

Перед повторной попыткой зарегистрируйте номер телефона.

500

Внутренняя ошибка сервера

131047

Сообщение для повторного вовлечения клиента

Более 24 часов прошло с того момента, как получатель в последний раз отправил сообщение на номер отправителя.

Вместо этого отправьте получателю сообщение от имени компании, используя шаблон сообщения.

400

Неправильный запрос

131051

Неподдерживаемый тип сообщения

Тип сообщения не поддерживается.

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

400

Неправильный запрос

131052

Ошибка ска��ивания медиафайла

Не удается скачать отправленный пользователем медиафайл.

Не удалось скачать медиафайл по одной или нескольким причинам, например потому что этот тип файла не поддерживается. Чтобы узнать, почему не удалось скачать медиафайл, проверьте значение error.error_data.details.

Попросите пользователя WhatsApp отправить вам медиафайл другим способом, не через WhatsApp.

400

Неправильный запрос

131053

Ошибка загрузки медиафайла

Не удается загрузить используемый в сообщении медиафайл.

Не удалось загрузить медиафайл по одной или нескольким причинам (например, потому что этот тип файла не поддерживается). Чтобы узнать, почему не удалось загрузить медиафайл, проверьте значение error.error_data.details.

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

Например, в UNIX можно запустить из командной стро��и функцию проверки файлов, чтобы определить тип MIME файла:

file -I rejected-file.mov

После этого вы можете проверить, указан ли этот тип MIME в нашем списке поддерживаемых типов медиафайлов.

Информацию о том, как повысить надежность отправки медиафайлов, см. в разделах, посвященных HTTP-кэшированию и загрузке медиафайлов.

400

Неправильный запрос

131057

Аккаунт в режиме обслуживания

Бизнес-аккаунт находится в режиме обслуживания.

Аккаунт WhatsApp Business находится в режиме обслуживания. Одна из возможных причин — в аккаунте идет процесс увеличения производительности.

500

Неправильный запрос

132000

Не совпадает количество параметров в шаблоне

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

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

400

Неправильный запрос

132001

Шаблон отсутствует

Шаблон на указанном языке отсутствует или не был одобрен.

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

404

Не найдено

132005

Слишком длинный заполненный текст шаблона

Переведенный текст слишком длинный.

Воспользуйтесь WhatsApp Manager и проверьте, был ли ваш шаблон переведен. См. статью Оценка качества и статус шаблона.

400

Неправильный запрос

132007

Нарушение правил в отношении символов форматирования в шаблоне

Содержимое шаблона нарушает политику WhatsApp.

См. статью Причины отклонения, чтобы выяснить возможные причины нарушения.

400

Неправильный запрос

132012

Не совпадает формат параметра в шаблоне

Значения переменных параметров имеют неверный формат.

Значения переменных параметров в запросе не указаны в формате, обозначенном в шаблоне. См. статью Рекомендации по использованию шаблонов сообщений.

400

Неправильный запрос

132015

Работа шаблона приостановлена

Работа шаблона приостановлена из-за низкого качества, поэтому его нельзя использовать в сообщении.

Отредактируйте шаблон, чтобы повысить его качество, и повторите попытку после одобрения.

400

Неправильный запрос

132016

Шаблон отключен

Работа шаблона слишком много раз приостанавливалась из-за низкого качества, поэтому шаблон отключен навсегда.

Создайте новый шаблон с другим содержимым.

400

Неправильный запрос

132068

Процесс заблокирован

Процесс заблокирован.

Исправьте процесс.

400

Неправильный запрос

132069

Процесс регулируется

Процесс регулируется, и за последний час через этот процесс уже было отправлено 10 сообщений.

Исправьте процесс

400

Неправильный запрос

133000

Аннулирование регистрации не завершено

Предыдущая попытка аннулировать регистрацию не удалась.

Аннулируйте регистрацию номера повторно перед регистрацией.

500

Внутренняя ошибка сервера

133004

Сервер временно недоступен

Сервер временно недоступен.

Перед повторной попыткой проверьте информацию о статусе API на странице статуса платформы WhatsApp Business и значение details в ответе.

503

Служба недоступна

133005

Несовпадение PIN-кода двухшаговой проверки

Неверный PIN-код двухшаговой проверки.

Убедитесь, что в запросе указан правильный PIN-код двухшаговой проверки.

Чтобы сбросить PIN-код двухшаговой проверки:

Отключите двухшаговую проверку.
Отправьте запрос POST, содержащий новый PIN-код, к конечной точке Номер телефона.

400

Неправильный запрос

133006

Необходимо повторное подтверждение номера телефона

Перед регистрацией номер телефона необходимо подтвердить.

Подтвердить номер телефона перед его регистрацией.

400

Неправильный запрос

133008

Слишком много попыток угадать PIN-код двухшаговой проверки

Для этого номера телефона предпринято слишком много попыток угадать PIN-код двухшаговой проверки.

Повторите попытку спустя время, которое указано для значения details в ответе.

400

Неправильный запрос

133009

PIN-код двухшаговой проверки угадан слишком быстро

PIN-код двухшаговой проверки был введен слишком быстро.

Перед повторной попыткой проверьте значение details в ответе.

400

Неправильный запрос

133010

Номер телефона не зарегистрирован

Номер телефона не зарегистрирован на платформе WhatsApp Business.

Перед повторной попыткой зарегистрируйте номер телефона.

400

Неправильный запрос

133015

Подождите несколько минут, прежде чем пытаться зарегистрировать этот номер телефона

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

Подождите 5 минут, прежде чем отправлять повторный запрос.

400

Неправильный запрос

135000

Общая ошибка пользователя

Не удалось отправить сообщение из-за неизвестной ошибки с вашими параметрами запроса.

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

400

Неправильный запрос