Діагностика

Widget не з'являється

Перевірте:

document.querySelectorAll('script[src*="widget.js"]').length

Очікуваний результат: 1.

Потім перевірте:

• script URL повертає JavaScript
• data-inbox-id присутній
• CSP дозволяє https://navi.1it.pro
• немає duplicate widget scripts
• у browser console немає runtime errors

Widget надсилає повідомлення, але AI не відповідає

Перевірте:

1. /api/webhooks/widget/message повертає success.
2. Website inbox має agentIntegrationId.
3. OpenAI integration існує і active.
4. OpenAI API key існує.
5. Conversation не paused.
6. Backend logs не показують AI dispatch failed.

Корисні backend logs:

AI dispatch skipped: inbox has no agent integration
AI dispatch skipped: conversation bot is paused
AI dispatch failed
OpenAI error

Notion files не завантажуються

Перевірте:

• NOTION_API_KEY належить Notion integration
• integration має доступ до database
• NOTION_DATABASE_ID коректний
• Notion database містить pages
• backend може звернутися до Notion API

Refresh ламає /demo або /app

Перевірте web server fallback. Frontend routes мають віддавати index.html.

Поганий setup:

location = /demo {
  proxy_pass http://backend:4000;
}

Добрий setup:

location / {
  try_files $uri $uri/ /index.html;
}

Health checks

docker exec navibot-backend wget -qO- http://localhost:4000/api/health

Очікувано:

{"status":"ok"}