Перейти до основного вмісту

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 logs шукайте:

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.