Коды ошибок нотификаций
Справочник кодов ошибок, которые могут передаваться в поле 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 | Старый и новый номера уже привязаны к одной учётной записи. | — |