Перейти к содержанию

Устранение неполадок

Общие проблемы и способы их решения. Для каждой проблемы начинайте с первого предложенного исправления — это наиболее вероятная причина.


Виджет не отображается на моем сайте

  1. Проверьте панель управления — откройте URL вашей панели напрямую. Если она не загружается, возможно, сервер недоступен — свяжитесь со своим аккаунт-менеджером.
  2. Проверьте data-bot-id — ID бота в коде вставки должен совпадать с фактическим слагом вашего бота. Проверьте в Dashboard → Embed.
  3. Проверьте data-backend-url — должен включать протокол (https://) и правильный домен.
  4. Проверьте консоль браузера — откройте DevTools (F12) → Console на предмет ошибок JavaScript.

Виджет отображается, но бот не отвечает

  1. Проверьте индикатор состояния LLM — если он красный, OpenRouter отключен. Перейдите в Settings → AI Engine и переподключитесь.
  2. Убедитесь, что модель выбрана — в выпадающем списке должна быть выбрана AI-модель.
  3. Проверьте базу знаний — если она пуста, бот может отвечать обобщенно или не отвечать вовсе. Добавьте контент в Knowledge Base.

История чата не сохраняется при перезагрузке страницы

  1. LocalStorage должен быть включен — виджет сохраняет данные сессии в localStorage браузера. Приватный режим или режим инкогнито могут блокировать это.
  2. ID бота должен быть одинаковым — если data-bot-id различается на разных страницах, виджет воспринимает их как разных ботов с раздельной историей.

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

  1. Подождите обновления DNS — изменения могут занять от 5 до 30 минут.
  2. Проверьте A-запись — проверьте панель управления вашего DNS-провайдера, чтобы подтвердить, что A-запись указывает на IP вашего сервера.
  3. Попробуйте обновить SSL — перейдите в Settings → Custom Domain → Renew SSL.
  4. Пользователям Cloudflare — убедитесь, что режим SSL установлен на Full (Strict).
  5. Свяжитесь со своим аккаунт-менеджером, если проблема сохраняется после обновления DNS.

Настройки не сохраняются

  1. Проверьте индикатор состояния БД — он должен быть зеленым в верхней части страницы.
  2. Обновите страницу — настройки кэшируются; обновление страницы принудительно считывает данные заново.
  3. Свяжитесь со своим аккаунт-менеджером, если индикатор БД красный.

Панель управления загружается, но не показывает данные

  1. Проверьте индикаторы состояния — если DB или VEC горят красным, возможно, бэкенд-сервисам требуется внимание.
  2. Обновите страницу — данные могли не загрузиться при первом посещении.
  3. Свяжитесь со своим аккаунт-менеджером, если индикаторы остаются красными.

Тест интеграции не проходит

  1. Проверьте учетные данные — API-ключи, пароли SMTP, URL-адреса вебхуков должны быть актуальными.
  2. Проверьте Activity Logs — отфильтруйте логи по модулю Integrations для получения подробных сообщений об ошибках.
  3. Проверьте внешний сервис — убедитесь, что эндпоинт вебхука, SMTP-сервер или API доступны.

Бот отвечает обобщенно (игнорирует базу знаний)

  1. Проверьте Sync Jobs — файлы или URL могут все еще находиться в процессе обработки. Дождитесь статуса Completed.
  2. Обновите базу знаний — перейдите в Knowledge Base и нажмите Refresh.
  3. Проверьте системный промпт — противоречивые инструкции в Settings → Model Behavior могут перекрывать поиск по базе знаний.
  4. Добавьте FAQ — для критически важных вопросов добавьте FAQ с точным ответом. FAQ имеют приоритет.

Сообщения WhatsApp не приходят

  1. Проверьте статус сервиса WhatsApp — перейдите в Settings → WhatsApp и убедитесь, что сервис имеет статус Running.
  2. Проверьте проверку состояния API — индикатор статуса должен быть зеленым.
  3. Проверьте сессию QR-кода — если соединение разорвано, отсканируйте QR-код повторно.
  4. Свяжитесь со своим аккаунт-менеджером, если сервис не запускается.

Низкая производительность

  1. Переключитесь на более быструю AI-модель — Gemini Flash или Claude Haiku для меньшей задержки. См. AI Models.
  2. Уменьшите max tokens — ограничьте длину ответа в Settings → Model Behavior.
  3. Очистите базу знаний — удалите устаревшие документы, чтобы ускорить поиск.
  4. Добавьте FAQ — ответы на частые вопросы через FAQ вообще не задействуют AI-модель, что происходит мгновенно.
  5. Свяжитесь со своим аккаунт-менеджером, если медлительность сохраняется — серверу может потребоваться обновление ресурсов.

Все еще нужна помощь?

  • Проверьте Activity Logs в панели управления на наличие сообщений об ошибках.
  • Свяжитесь со своим аккаунт-менеджером, описав проблему и приложив скриншоты ошибок, которые вы видите.