Перейти к основному содержимому

OpenAI и AI-ответы

NaviBot отвечает на сообщения посетителя через backend AI dispatcher. Widget не вызывает OpenAI напрямую.

Обязательные элементы

Чтобы AI отвечал:

  1. Должна существовать OpenAI integration.
  2. Website inbox должен быть подключен к этой OpenAI agent integration.
  3. Integration должна иметь:
    • customer-owned OpenAI API key, или
    • server-side OPENAI_API_KEY для managed mode.
  4. Conversation не должен иметь botPaused = true.

Настройка в кабинете

Откройте:

/app/settings/bots

Затем:

  1. Выберите Customer key или Managed.
  2. Введите OpenAI API key для Customer key.
  3. Выберите model, embedding model и temperature.
  4. Сохраните 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.