Устранение неполадок
Общие проблемы и способы их решения. Для каждой проблемы начинайте с первого предложенного исправления — это наиболее вероятная причина.
Виджет не отображается на моем сайте
- Проверьте панель управления — откройте URL вашей панели напрямую. Если она не загружается, возможно, сервер недоступен — свяжитесь со своим аккаунт-менеджером.
- Проверьте
data-bot-id— ID бота в коде вставки должен совпадать с фактическим слагом вашего бота. Проверьте в Dashboard → Embed. - Проверьте
data-backend-url— должен включать протокол (https://) и правильный домен. - Проверьте консоль браузера — откройте DevTools (F12) → Console на предмет ошибок JavaScript.
Виджет отображается, но бот не отвечает
- Проверьте индикатор состояния LLM — если он красный, OpenRouter отключен. Перейдите в Settings → AI Engine и переподключитесь.
- Убедитесь, что модель выбрана — в выпадающем списке должна быть выбрана AI-модель.
- Проверьте базу знаний — если она пуста, бот может отвечать обобщенно или не отвечать вовсе. Добавьте контент в Knowledge Base.
История чата не сохраняется при перезагрузке страницы
- LocalStorage должен быть включен — виджет сохраняет данные сессии в localStorage браузера. Приватный режим или режим инкогнито могут блокировать это.
- ID бота должен быть одинаковым — если
data-bot-idразличается на разных страницах, виджет воспринимает их как разных ботов с раздельной историей.
Не работает пользовательский домен
- Подождите обновления DNS — изменения могут занять от 5 до 30 минут.
- Проверьте A-запись — проверьте панель управления вашего DNS-провайдера, чтобы подтвердить, что A-запись указывает на IP вашего сервера.
- Попробуйте обновить SSL — перейдите в Settings → Custom Domain → Renew SSL.
- Пользователям Cloudflare — убедитесь, что режим SSL установлен на Full (Strict).
- Свяжитесь со своим аккаунт-менеджером, если проблема сохраняется после обновления DNS.
Настройки не сохраняются
- Проверьте индикатор состояния БД — он должен быть зеленым в верхней части страницы.
- Обновите страницу — настройки кэшируются; обновление страницы принудительно считывает данные заново.
- Свяжитесь со своим аккаунт-менеджером, если индикатор БД красный.
Панель управления загружается, но не показывает данные
- Проверьте индикаторы состояния — если DB или VEC горят красным, возможно, бэкенд-сервисам требуется внимание.
- Обновите страницу — данные могли не загрузиться при первом посещении.
- Свяжитесь со своим аккаунт-менеджером, если индикаторы остаются красными.
Тест интеграции не проходит
- Проверьте учетные данные — API-ключи, пароли SMTP, URL-адреса вебхуков должны быть актуальными.
- Проверьте Activity Logs — отфильтруйте логи по модулю Integrations для получения подробных сообщений об ошибках.
- Проверьте внешний сервис — убедитесь, что эндпоинт вебхука, SMTP-сервер или API доступны.
Бот отвечает обобщенно (игнорирует базу знаний)
- Проверьте Sync Jobs — файлы или URL могут все еще находиться в процессе обработки. Дождитесь статуса Completed.
- Обновите базу знаний — перейдите в Knowledge Base и нажмите Refresh.
- Проверьте системный промпт — противоречивые инструкции в Settings → Model Behavior могут перекрывать поиск по базе знаний.
- Добавьте FAQ — для критически важных вопросов добавьте FAQ с точным ответом. FAQ имеют приоритет.
Сообщения WhatsApp не приходят
- Проверьте статус сервиса WhatsApp — перейдите в Settings → WhatsApp и убедитесь, что сервис имеет статус Running.
- Проверьте проверку состояния API — индикатор статуса должен быть зеленым.
- Проверьте сессию QR-кода — если соединение разорвано, отсканируйте QR-код повторно.
- Свяжитесь со своим аккаунт-менеджером, если сервис не запускается.
Низкая производительность
- Переключитесь на более быструю AI-модель — Gemini Flash или Claude Haiku для меньшей задержки. См. AI Models.
- Уменьшите max tokens — ограничьте длину ответа в Settings → Model Behavior.
- Очистите базу знаний — удалите устаревшие документы, чтобы ускорить поиск.
- Добавьте FAQ — ответы на частые вопросы через FAQ вообще не задействуют AI-модель, что происходит мгновенно.
- Свяжитесь со своим аккаунт-менеджером, если медлительность сохраняется — серверу может потребоваться обновление ресурсов.
Все еще нужна помощь?
- Проверьте Activity Logs в панели управления на наличие сообщений об ошибках.
- Свяжитесь со своим аккаунт-менеджером, описав проблему и приложив скриншоты ошибок, которые вы видите.