Локальный API платформы WhatsApp Business

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

Сообщения об ошибках и коды статусов

В этом документе вы найдете информацию по следующим темам:

Сведения об устранении ошибок в процессе регистрации на сайте поставщика см. в этой статье.

Коды ошибок клиента WhatsApp Business API

Код ошибкиОписание

400 — ошибка скачивания медиафайла

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

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

Не удалось отправить сообщение из-за одной или нескольких ошибок, связанных со способом оплаты:

  • с аккаунтом WhatsApp не связан платежный аккаунт;
  • превышено ограничение по кредитной линии;
  • кредитная линия (платежный аккаунт) не задана или неактивна;
  • аккаунт WhatsApp Business удален;
  • мы приостановили действие аккаунта;
  • не указан часовой пояс;
  • не указана валюта;
  • запрос MessagingFor (от имени) ожидает подтверждения или отклонен;
  • превышен предел бесплатных сообщений и отсутствует допустимый способ оплаты (это сообщение об ошибке будет использоваться с 1 февраля 2022 г.).

Проверьте настройки оплаты в WhatsApp Manager и повторите попытку.

408 — сообщение недействительно

Не удалось отправить сообщение, поскольку оно слишком долго ожидало подтверждения (более одного дня). Такое может произойти, если клиент WhatsApp Business API был запущен после более чем суточного простоя.


Отправьте сообщение заново.

410 — срок действия сообщения истек

Не удалось отправить сообщение в течение его времени жизни (TTL).

429 — достигнуто ограничение количества обращений

  • Для исходящих сообщений: не удалось отправить сообщение, поскольку за короткое время с этого номера телефона было отправлено слишком много сообщений.
    Отправьте проблемные сообщения заново.

  • Для входящих сообщений: не удалось скачать медиафайл из-за ограничения частоты обращений. Попросите отправить сообщение заново.

430 — сертификат не подписан

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


Скачайте новый сертификат из WhatsApp Manager и заново зарегистрируйте его.

432 — не совпадает ID сертификата

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


Скачайте новый сертификат из WhatsApp Manager и зарегистрируйтесь повторно.

433 — недействительная подпись сертификата

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

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

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


Используйте для ответа сообщение на основе шаблона.

471 — достигнуто ограничение числа спам-обращений

Не удалось отправить сообщение из-за ограничений на количество сообщений, отправляемых с этого номера телефона. Это может быть связано с тем, что слишком большое количество предыдущих сообщений было заблокировано или помечено как спам.


Проверьте свой статус качества в WhatsApp Manager. Дополнительную информацию см. в документации.

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

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


Не отправляйте сообщения этому пользователю.

480 — возможная смена пользователя

Не удалось отправить сообщение, поскольку пользователь с этим номером телефона, возможно, сменился.

500 — общая ошибка

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


Повторите попытку позже.

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

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

1000 — общая ошибка

1001 — слишком длинное сообщение

Длина сообщения превышает 4 096 символов.

1002 — недействительный тип получателя

Действительные типы получателей:

  • individual

1004 — ресурс уже существует

Возможно, произошел конфликт UUID для запроса на загрузку медиафайла, или медиафайл с таким UUID уже существует.

1005 — доступ запрещен

  • Каталог медиаданных недоступен для записи (при запросе на загрузку).
  • Недействительные учетные данные.
  • Ошибка сертификата.
  • Приложение устарело, необходимо обновить версию.
  • Сообщения, содержащие button, для этого аккаунта отключены.
  • Номер уже зарегистрирован в WhatsApp. Информацию о переносе номера телефона из WhatsApp в WhatsApp Business API см. в этом разделе.
  • Если ваша компания отправляет коммерческие сообщения в Индии, все обязательные поля профиля компании и товара должны быть заполнены. Дополнительную информацию см. по ссылке https://www.facebook.com/business/help/1104628230079278.

1006 — ресурс не найден

Файл или ресурс не найден.

1007 — получатель заблокирован (упразднен)

Получатель не внесен в список разрешенных.

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

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


Если вы хотите отправить сообщение со списком, возможно, вы не заполнили часть titleобъекта сообщения section или ID строк (rows).


Если вы хотите отправить сообщение об одном или нескольких товарах, возможно, вы не заполнили поле catalog_id или product_retailer_id. Оба эти поля обязательны для этого типа сообщений.

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

Для параметра указано недопустимое значение (например, неподходящего типа).


Если вы хотите отправить сообщение со списком, возможно, не все строки имеют уникальный ID.


Если вы хотите отправить сообщение об одном товаре, возможно, вы отправили неправильный catalog_id. Вернитесь в Commerce Manager и проверьте его.


Если вы хотите отправить сообщение о нескольких товарах, убедитесь, что значение product_retailer_id уникально для каждого раздела. Также убедитесь, что объекты header и body присутствуют, и им назначено значение.


1010 — ненужный параметр

Указан ненужный параметр.

1011 — служба не готова

1013 — недействительный пользователь

1014 — внутренняя ошибка

  • Не удалось выполнить загрузку, в изображении имеется ошибка (не загрузилось корректно) или не найдена конечная точка.
  • Предоставленный вами хэш не совпадает с последним хэшем пользователя.

1015 — слишком много запросов

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

1016 — система перегружена

Эта ошибка выводится, когда требуется снизить нагрузку на систему.

1017 — не главный основной узел

Запрос, предназначенный для главного основного узла (установка или получение настроек, импорт, экспорт, получение кода, регистрация и т. п.), отправлен на другой узел. Это может произойти из-за внутренних ошибок или неправильной настройки клиента WhatsApp Business API.


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

1018 — не главный узел Coreapp

Запросы поступают на узел Coreapp, не связанный с нужным сегментом и не находящийся в процессе связывания. Это случается в конфигурациях с распределением нагрузки, когда система переключает сегмент на резервный узел.


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

1021 — неправильный пользователь

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

1022 — не настроен URL Webhooks

Не настроен формат обратных вызовов Webhooks для REST API.

1023 — ошибка базы данных

1024 — нужно сменить пароль

Вам необходимо сменить пароль.

1025 — недействительный запрос

Запрос недействителен.

1026 — невозможно получить

Невозможно доставить сообщение. Дополнительную информацию см. в вопросе "Почему доставляются не все сообщения?" в часто задаваемых вопросах.

1028 — необходимо подтвердить системное уведомление user_identity_changed

Вы отправили сообщение пользователю WhatsApp, который, возможно, сменился. Поэтому вы получили системное уведомление user_identity_changed, которое нужно подтвердить.

1031 — аккаунт отправителя заблокирован

Ваш аккаунт заблокирован в результате нарушения политики надлежащего поведения. Вы не можете отправлять сообщения. Подробнее см. в статье о применении политики платформы WhatsApp Business.

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

Количество предоставленных параметров не соответствует ожидаемому.

2001 — шаблон отсутствует

Неактивный статус шаблона или отсутствует шаблон для языка и региона.

2002 — ошибка при получении шаблона

Получателю не удалось скачать шаблон.

2003 — отсутствует пакет шаблонов

Нет шаблонов для определенного языка и региона.

2004 — слишком длинный параметр шаблона

Превышена длина параметра.

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

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

2006 — нарушение правил в отношении пробелов в шаблоне

Нарушены правила в отношении пробелов.

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

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

2008 — неподдерживаемый формат медиафайла в шаблоне

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

2009 — отсутствует обязательный компонент шаблона

В шаблоне нет обязательного компонента.

2010 — недействительный заполненный URL в шаблоне

URL в компоненте кнопки недействителен.

2011 — недействительный номер телефона в шаблоне

Номер телефона в компоненте кнопки недействителен.

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

Формат параметра отличается от формата в созданном шаблоне.

2013 — кнопки в шаблоне не поддерживаются

Кнопки не поддерживаются получателем.

2014 — ожидаемое пространство имен пусто

Такая ошибка возникает, если языковой пакет шаблонов сообщений ещё не скачан.

2015 — недопустимое количество разделов

Запрос на переписку содержит слишком мало или слишком много разделов. Дополнительную информацию см. в описании объекта section.


В запросе должно быть от 1 до 10 объектов section.

2016 — недопустимое количество строк

Количество строк вне допустимых пределов. В сообщениях со списком должен быть как минимум один объект rows на раздел (section).

2017 — нарушены правила в отношении символов

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

2023 — недопустимое количество товаров

Объект section не содержит ни одного товара или общее количество товаров превышает максимально допустимое значение.

2024 — ID каталога не найден

Указанный ID каталога не существует или не связан с вашим аккаунтом WhatsApp Business.

2025 — ID каталога не связан с номером API

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

2026 — товары отсутствуют

Некоторые товары, указанные в запросе, не найдены в каталоге.

2027 — товары не найдены

В указанном каталоге не найдено ни одного товара.

2028 — все товары не прошли проверку соответствия

Только для компаний в Индии.

Эта ошибка возвращается, если компания отправляет сообщение об одном товаре с отсутствующей или неполной информацией о соответствии требованиям электронной торговли.

2029 — некоторые товары не прошли проверку соответствия

Только для компаний в Индии.

Эта ошибка возвращается, если компания отправляет сообщение о нескольких товарах с отсутствующей или неполной информацией о соответствии требованиям электронной торговли.

2030 —- недопустимые товары и товары, которые не прошли проверку соответствия

Только для компаний в Индии.

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

2036 — недопустимая структура заголовка

В структуре объекта header допущена ошибка.

2050 — отсутствует информация о соответствии

Только для компаний в Индии.

Эта ошибка возвращается, если компания не указала информацию о соответствии. См. описание конечной точки Business Compliance.

2060 — шаблон отклонен

Шаблон имеет статус REJECTED, его отправка невозможна.

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

Шаблон имеет статус PAUSED, его отправка невозможна.

2062 — шаблон отключен

Шаблон имеет статус DISABLED, его отправка невозможна.

2064 — неверный ID потока

Поток с указанным ID не существует или не принадлежит вашему бизнес-аккаунту WhatsApp (WABA), либо у него недействительное состояние.

2068 — процесс заблокирован

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

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

2069 — процесс регулируется

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

Коды ошибок Commerce Manager для компаний из Индии см. в Справочном центре для бизнеса.

Коды статусов HTTP

Клиент WhatsApp Business API может использовать следующие коды статусов HTTP:

Код HTTPОписание

2xx

Успех

200

Успех (OK)

201

Создано (для запросов POST)

302

Найдено

4xx

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

400

Запрос недействителен

401

Авторизация не выполнена

403

Запрещено

404

Не найдено

405

Метод не поддерживается

412

Условие не выполнено

420

Достигнуто ограничение числа обращений

429

Слишком много запросов

5xx

Ошибки сервера

500

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

504

Истекло время ожидания