Як працює NaviBot

У NaviBot є три основні шари:

1. Website widget — видимий асистент і chat overlay.
2. Кабінет клієнта — налаштування сайтів, поведінки widget, OpenAI, Knowledge sources, integrations і analytics.
3. Backend-мозок — система в стилі 1Desk, яка зберігає розмови, запускає AI replies, повідомляє операторів і володіє server-side даними.

Runtime flow

1. Сайт завантажує https://navi.1it.pro/widget.js.
2. Widget створює або відновлює visitor session.
3. Він збирає безпечний page context: title, видимі секції, links, FAQ-like text і структуру сторінки.
4. Відвідувач надсилає повідомлення.
5. Backend зберігає повідомлення в conversation.
6. Dispatcher перевіряє, чи має inbox AI agent integration.
7. OpenAI adapter збирає prompt з:
   • site prompt
   • behavior rules
   • live page context
   • вибраних RAG documents
8. Відповідь зберігається і відправляється назад у widget.

Межа продукту

NaviBot — це обличчя на сайті. Backend залишається мозком.

Зона	Відповідальний шар
Widget UI	NaviBot
Character і motion	NaviBot
Page context scan	NaviBot widget
Conversations	Backend у стилі 1Desk
OpenAI routing	Backend integration layer
Knowledge sources	NaviBot cabinet + backend RAG
Human handoff	Inbox/operator flow у стилі 1Desk
Analytics	NaviBot events + backend storage

Що підготувати

Перед запуском потрібні:

• домен цільового сайту
• website inbox у кабінеті
• OpenAI account або managed OPENAI_API_KEY
• перший page map або page context target
• widget embed snippet
• privacy / consent text
• стартовий набір Knowledge sources

Часта проблема

Якщо widget приймає повідомлення, але не відповідає, перевірте, чи підключена OpenAI agent integration до website inbox і чи існує OpenAI key.