OpenAI и AI-ответы
NaviBot отвечает на сообщения посетителя через backend AI dispatcher. Widget не вызывает OpenAI напрямую.
Обязательные элементы
Чтобы AI отвечал:
- Должна существовать OpenAI integration.
- Website inbox должен быть подключен к этой OpenAI agent integration.
- Integration должна иметь:
- customer-owned OpenAI API key, или
- server-side
OPENAI_API_KEYдля managed mode.
- Conversation не должен иметь
botPaused = true.
Настройка в кабинете
Откройте:
/app/settings/bots
Затем:
- Выберите
Customer keyилиManaged. - Введите OpenAI API key для
Customer key. - Выберите model, embedding model и temperature.
- Сохраните OpenAI.
При сохранении OpenAI NaviBot подключает website inboxes, у которых еще нет AI agent.
Почему нет ответа
Частые причины:
- OpenAI integration не создана
- у inbox пустой
agentIntegrationId - в managed mode нет
OPENAI_API_KEY - customer key недействителен
- OpenAI API вернул 401, 429 или quota error
- conversation поставлен на паузу для human handling
- сообщение не дошло до
/api/webhooks/widget/message
Backend diagnostics
В логах backend ищите:
AI dispatch skipped: inbox has no agent integration
AI dispatch skipped: conversation bot is paused
AI dispatch failed
OpenAI error
Security
OpenAI API keys должны храниться в encrypted integration credentials или server environment variables. Не помещайте API keys в public widget config.