NeuronChat

Справочник ошибок

Когда в интерфейсе или в виджете появляется сообщение об ошибке, в ответе API часто есть поля code и ссылка doc. Ниже — что означает каждый код и как исправить ситуацию без поддержки.

auth_required

HTTP 401 · Нужна авторизация

Войдите в аккаунт, чтобы продолжить.

Почему так бывает

  • Запрос выполнен без действующей сессии или с истёкшим входом.
  • Часть API доступна только владельцу клиента (кабинет).

Что сделать

  1. Откройте страницу входа и авторизуйтесь под своим email.
  2. Если вы уже вошли — обновите страницу или выйдите и войдите снова.

BLOCKED_CONTENT

HTTP 429 · Сообщение отклонено политикой безопасности

Текст не проходит модерацию по правилам платформы.

Почему так бывает

  • В сообщении обнаружены запрещённые темы или шаблоны (см. ответ API).

Что сделать

  1. Сформулируйте вопрос нейтрально, без запрещённых слов и ссылок на нежелательные услуги.
  2. Если это ложное срабатывание — переформулируйте или обратитесь в поддержку с примером текста.

bot_disabled

HTTP 403 · Агент отключён

Чат-бот для этого аккаунта выключен.

Почему так бывает

  • В настройках клиента флаг активности агента выключен.

Что сделать

  1. Кабинет → настройки агента или виджет — включите агента и сохраните.

client_not_found

HTTP 404 · Клиент или виджет не найден

Указанный клиент не существует или был удалён.

Почему так бывает

  • В запросе передан неверный идентификатор клиента (виджета).
  • В кабинете обращение идёт к чужому или устаревшему clientId.

Что сделать

  1. В разделе «Виджет» скопируйте актуальный код установки с правильным clientId.
  2. Проверьте, что виджет вставлен с того же проекта, что и ваш аккаунт.

email_already_registered

HTTP 400 · Email уже зарегистрирован

Пользователь с таким email уже есть в системе.

Почему так бывает

  • Регистрация требует уникальный email.

Что сделать

  1. Войдите через страницу входа или восстановите пароль.
  2. Используйте другой email для нового аккаунта.

email_not_verified

HTTP 403 · Email не подтверждён

Вход по паролю возможен только после подтверждения почты.

Почему так бывает

  • Регистрация не завершена: не введён код из письма.

Что сделать

  1. Зарегистрируйтесь снова и введите код из письма в течение 15 минут.
  2. Если письма нет — проверьте «Спам» и настройки SMTP на сервере.

INJECTION

HTTP 429 · Подозрение на prompt injection

Сообщение похоже на попытку изменить инструкции бота.

Почему так бывает

  • Обнаружены типичные фразы вроде «игнорируй предыдущие инструкции», «забудь правила», служебные теги и т.п.

Что сделать

  1. Задайте обычный вопрос по продукту или услуге без команд к модели.

internal_error

HTTP 500 · Внутренняя ошибка

Что-то пошло не так на сервере.

Почему так бывает

  • Не классифицированная ошибка.

Что сделать

  1. Повторите запрос позже; если не помогает — поддержка.

LIMIT_REACHED

HTTP 429 · Лимит диалогов по тарифу

Исчерпан месячный лимит диалогов на текущем тарифе.

Почему так бывает

  • Каждый новый разговор (новая сессия чата) увеличивает счётчик.
  • Лимит задаётся тарифом; при триале может действовать лимит как у тарифа «Бизнес».

Что сделать

  1. Откройте «Тарифы» и повысьте план или дождитесь сброса счётчика (раз в ~30 дней от даты сброса).
  2. После оплаты лимиты обновляются без ожидания конца календарного месяца.

mail_not_configured

HTTP 503 · Почта не настроена

Сервер не может отправить письмо: не заданы параметры SMTP.

Почему так бывает

  • В окружении не указаны SMTP_HOST и EMAIL_FROM (и при необходимости логин/пароль).

Что сделать

  1. Задайте переменные SMTP_HOST, SMTP_PORT, EMAIL_FROM; при требовании сервера — SMTP_USER, SMTP_PASS, SMTP_SECURE.
  2. В режиме разработки без SMTP смотрите лог сервера: код может быть выведен в консоль.

mail_send_failed

HTTP 502 · Не удалось отправить письмо

SMTP-сервер отклонил отправку или сеть недоступна.

Почему так бывает

  • Неверные учётные данные, блокировка провайдера, лимиты или TLS.

Что сделать

  1. Проверьте логи приложения и настройки почтового ящика/сервиса.
  2. Для порта 587 обычно SMTP_SECURE=false (STARTTLS); для 465 — SMTP_SECURE=true.

no_knowledge

HTTP 400 · Нет базы знаний

Не загружены документы, FAQ и обход сайта.

Почему так бывает

  • Агенту нечем опираться при ответах.

Что сделать

  1. Раздел «База знаний»: загрузите документы, FAQ, запустите обход сайта или заполните бриф.

phone_invalid

HTTP 400 · Некорректный номер телефона

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

Почему так бывает

  • Неверный формат, опечатка или номер не из зоны +7.

Что сделать

  1. Укажите мобильный в формате +7… или 8… / 9… — как в подсказке формы.

phone_required

HTTP 400 · Не указан телефон

Поле телефона обязательно для этого шага.

Почему так бывает

  • Для завершения профиля или заявки требуется номер.

Что сделать

  1. Заполните телефон в форме и сохраните снова.

phone_template_not_allowed

HTTP 400 · Тестовый или шаблонный номер

Такой номер нельзя использовать для регистрации.

Почему так бывает

  • Обнаружен известный «заглушечный» или повторяющийся шаблон (например, одинаковые цифры).

Что сделать

  1. Укажите реальный контактный номер, на который можно связаться с вами.

phone_zone_ru_kz

HTTP 400 · Нужен номер России или Казахстана

Допускаются только номера зоны +7 (РФ и КЗ).

Почему так бывает

  • Продукт ориентирован на эту зону нумерации.

Что сделать

  1. Введите номер с кодом +7 или выберите другой способ связи, если он доступен в форме.

promo_exhausted

HTTP 400 · Промокод исчерпан

Достигнут лимит использований.

Почему так бывает

  • У промокода ограниченное число активаций.

Что сделать

  1. Используйте другой код или тариф без промокода.

promo_expired

HTTP 400 · Промокод истёк

Срок действия промокода уже прошёл.

Почему так бывает

  • У промокода есть дата окончания.

Что сделать

  1. Запросите новый промокод у поддержки или оформите оплату без скидки.

promo_not_active

HTTP 400 · Промокод ещё не активен

Дата начала действия промокода ещё не наступила.

Почему так бывает

  • В настройках промокода задана будущая дата «с».

Что сделать

  1. Подождите даты старта или используйте другой промокод.

promo_not_found

HTTP 400 · Промокод не найден

Такого промокода нет в системе.

Почему так бывает

  • Опечатка в коде или промокод ещё не создан в админке.

Что сделать

  1. Проверьте написание (регистр не важен).
  2. Уточните действующий код у поддержки.

promo_plan_mismatch

HTTP 400 · Промокод не для этого тарифа

Промокод привязан к другому тарифу.

Почему так бывает

  • В настройках промокода указано ограничение по тарифу.

Что сделать

  1. Выберите тариф, для которого действует промокод, или оплатите без кода.

promo_subscription_only

HTTP 400 · Это промокод на подписку

Его нужно активировать отдельной кнопкой, а не при оплате.

Почему так бывает

  • Тип промокода SUBSCRIPTION не совместим с созданием платежа.

Что сделать

  1. Используйте раздел с активацией подарочной подписки по промокоду.

prompt_invalid

HTTP 400 · Системный промпт не задан

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

Почему так бывает

  • Для ответов агенту нужен осмысленный системный промпт.

Что сделать

  1. Настройки агента → основные настройки — заполните системный промпт (от 10 символов) и сохраните.

RATE_LIMIT

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

С вашей стороны слишком частые сообщения в чат.

Почему так бывает

  • Защита от злоупотреблений: за короткий интервал допускается ограниченное число запросов.

Что сделать

  1. Подождите около минуты и отправьте сообщение снова.
  2. Не используйте скрипты или автоотправку в тот же чат.

registration_otp_expired

HTTP 400 · Код устарел

Срок действия кода подтверждения истёк.

Почему так бывает

  • Прошло больше 15 минут с момента отправки письма.

Что сделать

  1. Запросите новый код на странице регистрации.

registration_otp_invalid

HTTP 400 · Неверный код

Код из письма не подошёл или пароль не совпадает с шагом регистрации.

Почему так бывает

  • Опечатка в коде, истёк срок действия кода или неверный пароль при подтверждении.

Что сделать

  1. Введите 6 цифр из последнего письма без пробелов.
  2. Нажмите «Отправить код снова» и дождитесь нового письма.
  3. Убедитесь, что пароль совпадает с тем, что вы ввели на первом шаге.

registration_resend_cooldown

HTTP 429 · Слишком частая отправка

Повторная отправка письма с кодом пока недоступна.

Почему так бывает

  • Между письмами выдерживается пауза, чтобы защитить почту от спама.

Что сделать

  1. Подождите около минуты и нажмите «Отправить код снова».
  2. Проверьте папку «Спам» и входящие за последние минуты.

server_error

HTTP 500 · Внутренняя ошибка

Сервис временно не смог обработать запрос.

Почему так бывает

  • Сбой базы, сети или непредвиденное исключение на сервере.

Что сделать

  1. Обновите страницу и повторите через несколько минут.
  2. Если повторяется — напишите в поддержку с временем и действием.

SQL_INJECTION

HTTP 429 · Сообщение отклонено

Текст похож на SQL-инъекцию и не принимается.

Почему так бывает

  • В сообщении есть конструкции, характерные для атак на базы данных.

Что сделать

  1. Уберите из текста SQL-подобные фрагменты и повторите вопрос обычным языком.

subscription_required

HTTP 403 · Нужна подписка для виджета

На бесплатном тарифе без триала виджет недоступен.

Почему так бывает

  • Тариф FREE без активного триала не включает публичный виджет.

Что сделать

  1. Оформите подписку или активируйте триал в разделе «Тарифы».

telegram_same_bot_notifications

HTTP 400 · Один и тот же бот для чата и уведомлений

Токен бота уведомлений совпадает с ботом-агентом.

Почему так бывает

  • Технически один бот не может одновременно быть «агентом в диалоге» и «ботом только для заявок».

Что сделать

  1. Создайте второго бота в @BotFather для уведомлений о заявках.
  2. Укажите его токен на странице уведомлений; агентский токен оставьте в интеграции мессенджеров.

validation_failed

HTTP 400 · Данные формы не прошли проверку

Проверьте поля по подсказкам ниже.

Почему так бывает

  • Одно или несколько полей не соответствуют формату или ограничениям.

Что сделать

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

website_invalid_url

HTTP 400 · Некорректный URL

Строка не является допустимой ссылкой.

Почему так бывает

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

Что сделать

  1. Скопируйте адрес из браузера (с https://) и вставьте в поле.

website_placeholder

HTTP 400 · Тестовый или служебный домен

Нельзя использовать example.com, localhost и подобные адреса.

Почему так бывает

  • Эти домены зарезервированы для документации и не являются сайтом компании.

Что сделать

  1. Укажите реальный домен вашего сайта в продакшене.

website_protocol_invalid

HTTP 400 · Нужен http или https

Разрешены только протоколы http и https.

Почему так бывает

  • Указан другой протокол (ftp, file и т.д.).

Что сделать

  1. Замените ссылку на https://…

website_required

HTTP 400 · Не указан URL сайта

Введите адрес сайта компании.

Почему так бывает

  • Поле URL пустое, а для шага требуется значение.

Что сделать

  1. Укажите полный адрес, например https://example.ru

widget_disabled

HTTP 403 · Виджет / агент выключен

Агент отключён в настройках.

Почему так бывает

  • Флаг активности клиента выключен.

Что сделать

  1. Включите агента в кабинете и повторите проверку виджета.