Коды ошибок: что означают и что делать

Каждое сообщение об ошибке в интерфейсе заканчивается кодом в скобках — например «(IB-RATE-LIMITED)». Код называет класс отказа и ничего больше: в нём нет ни адресов, ни токенов, ни идентификаторов вашего проекта, поэтому его можно спокойно показать на скриншоте и назвать поддержке.

Найдите свой код ниже. Если кода в сообщении нет — обновите страницу: старая версия интерфейса могла остаться в кэше браузера.

IB-WEBHOOK-UNREACHABLE

Мессенджер не смог достучаться до нашего адреса приёма событий. Бот при этом остаётся подключённым, но входящие сообщения до воронки не доходят.

Что делать:

  1. Откройте «Каналы» в проекте и нажмите «Проверить» на карточке бота — диагностика покажет, какая из четырёх стадий красная: «Токен и аккаунт», «Разрешения», «Webhook», «Тестовое сообщение».
  2. Если красная стадия — «Webhook», откройте настройки бота и нажмите «Обновить» рядом с адресом webhook. Мы переустановим адрес заново.
  3. Если после переустановки диагностика по-прежнему красная, напишите в поддержку и назовите этот код.

IB-CHANNEL-UNREACHABLE

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

Повторные попытки выполняются автоматически, ничего перенастраивать не нужно. Если сообщения не идут дольше десяти-пятнадцати минут, напишите в поддержку с этим кодом — так мы сразу поймём, о каком отказе речь.

IB-RATE-LIMITED

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

Что делать:

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

IB-BALANCE-EMPTY

На тарифе закончился оплаченный объём — отправлять сообщения дальше нечем.

Откройте «Биллинг» в проекте: там видно текущий план, израсходованные лимиты и кнопку оплаты. После оплаты действие можно повторить сразу, переподключать каналы не нужно.

IB-SESSION-EXPIRED

Вход в аккаунт перестал действовать. Обычно продление происходит незаметно и код вы не увидите; он появляется, когда продлить не удалось — например браузер долго был офлайн или сессию отозвали на странице безопасности.

Войдите заново. Несохранённые изменения в редакторе воронки останутся: черновик автосохраняется, и после входа вы вернётесь к нему.

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

IB-CLIENT-BLOCKED-BOT

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

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

IB-ROLE-DENIED

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

Попросите владельца проекта открыть «Команда» и выдать вам роль с нужным правом. Какая роль что может — в статье «Команда: роли и permissions».

IB-ORIGIN-REJECTED

Запрос отклонён защитой от подделки: браузер прислал его так, будто он пришёл с чужого сайта.

Что делать:

  1. Обновите страницу и повторите действие — чаще всего вкладка просто провисела открытой слишком долго.
  2. Если повторяется, проверьте расширения браузера, которые вмешиваются в заголовки запросов, и режим «инкогнито» с отключёнными cookie.
  3. Убедитесь, что открыт наш обычный адрес, а не копия страницы через сторонний прокси или переводчик.

IB-INVALID-INPUT

Сервер проверил введённые данные и не принял их. Отказ пришёл до сохранения — ничего не испортилось.

Ошибка чинится в самой форме, а не переходом куда-то ещё: поле с проблемой подсвечено, а под ним написано, что именно не так. Чаще всего это лишний пробел в начале или конце, телефон в неожиданном формате, адрес без «https://» или значение длиннее допустимого.

IB-SERVER-UNAVAILABLE

Ошибка на нашей стороне: запрос дошёл, но обработать его не удалось.

Подождите минуту и повторите. Если повторяется — откройте страницу статуса: там видно, идёт ли работа по сбою. Если на странице статуса всё зелёное, а код возвращается, напишите в поддержку и укажите время до минуты и что вы делали.

IB-OFFLINE

Запрос вообще не дошёл до сервера — оборвалось соединение из браузера.

Что делать:

  1. Проверьте интернет и откройте любую другую страницу.
  2. Выключите VPN или, наоборот, включите — часть провайдеров ограничивает доступ к отдельным сервисам.
  3. Проверьте блокировщики рекламы и корпоративный прокси: они умеют резать фоновые запросы, оставляя саму страницу видимой.

IB-UNKNOWN

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

Повторите действие. Если код появится снова, напишите в поддержку и приложите скриншот целиком: код в описании, время и то, что вы делали, — по ним мы найдём запись в журнале.

IB-UNRECOGNIZED

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

Это отличается от IB-UNKNOWN: там причины не было совсем, здесь она есть и её видно. Скопируйте текст сообщения вместе с кодом и отправьте в поддержку — по нему заводится новый разбор.

Что приложить к обращению

  • Код ошибки целиком, как он написан в скобках.
  • Время с точностью до минуты и часовой пояс.
  • Что вы делали: страница, кнопка, какой канал или воронка.
  • Скриншот всего окна, а не одного сообщения — по нему видно и контекст, и версию интерфейса.