Справочник кодов ошибок, которые могут передаваться в поле error_code webhook-нотификаций (message.status, client.phone.changed и др.). Для каждого кода указан мессенджер, в котором он может возникнуть: Telegram, MAX, оба, либо «—» для ошибок, не связанных с конкретным мессенджером.
Доставка
Код
Описание
Мессенджер
TOKEN_INVALID
Токен бота недействителен или отозван мессенджером. Проверьте токен в настройках бота.
Telegram · MAX
BAD_REQUEST
Мессенджер отклонил запрос из-за некорректных параметров сообщения.
Telegram · MAX
RATE_LIMIT
Превышен лимит частоты отправки мессенджера. Сообщение будет повторено с задержкой.
Telegram · MAX
WEBHOOK_CONFLICT
Конфликт webhook Telegram: другой сервер уже установил webhook для этого бота.
Telegram
NETWORK_ERROR
Сетевая ошибка при обращении к API мессенджера (обрыв соединения, недоступность).
Telegram · MAX
DNS_ERROR
Не удалось разрешить доменное имя API мессенджера.
Telegram · MAX
SSL_ERROR
Ошибка TLS/SSL при установке защищённого соединения с API мессенджера.
Telegram · MAX
TIMEOUT
Превышено время ожидания ответа от API мессенджера.
Telegram · MAX
CONNECTION_CLOSED
Соединение с API мессенджера было закрыто до получения ответа.
Telegram · MAX
PROXY_ERROR
Ошибка исходящего прокси.
Telegram · MAX
CONFIG_MISSING
Не задан URL webhook мессенджера в настройках платформы.
Telegram · MAX
DELIVERY_FAILED
Общая ошибка доставки сообщения. Причина не классифицирована или неизвестна.
Telegram · MAX
Получатель
Код
Описание
Мессенджер
USER_BLOCKED_BOT
Получатель заблокировал бота. Telegram: HTTP 403 «bot was blocked by the user»; MAX: chat.denied. Доставка завершается без повторных попыток.
Telegram · MAX
USER_NOT_FOUND
Получатель не найден (не зарегистрирован в мессенджере).
Telegram · MAX
USER_INACTIVE
Получатель неактивен или недоступен в мессенджере.
Telegram · MAX
DIALOG_SUSPENDED
Диалог приостановлен: MAX вернул error.dialog.suspended (получатель заблокировал бота или действует ограничение модератора).
MAX
Смена номера
Код
Описание
Мессенджер
PHONE_NEVER_EXISTED
Номер никогда не был зарегистрирован ни в одном мессенджере.
—
PHONE_ALREADY_INACTIVE
Номер уже неактивен.
—
PHONE_MULTIPLE_CLIENTS
Номер привязан к нескольким разным учётным записям.
—
PHONE_NOT_LINKED
Номер не привязан ни к одной учётной записи.
—
PHONE_NOT_IN_BOT
Новый номер никогда не был зарегистрирован ни в одном мессенджере.
—
PHONE_NOT_ACTIVE
Новый номер неактивен.
—
MIGRATION_SAME_CLIENT
Старый и новый номера уже привязаны к одной учётной записи.