Troubleshooting

Widget does not appear

Check:

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

Expected result: 1.

Then check:

• script URL returns JavaScript
• data-inbox-id is present
• CSP allows https://navi.1it.pro
• no duplicate widget scripts are loaded
• browser console has no runtime errors

Widget sends messages but AI does not answer

Check:

1. /api/webhooks/widget/message returns success.
2. The website inbox has agentIntegrationId.
3. OpenAI integration exists and is active.
4. The OpenAI API key exists.
5. The conversation is not paused.
6. Backend logs do not show AI dispatch failed.

Useful backend log messages:

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

Notion files do not load

Check:

• NOTION_API_KEY belongs to a Notion integration
• the integration has access to the database
• NOTION_DATABASE_ID is correct
• Notion database contains pages
• backend can reach Notion API

Direct refresh breaks /demo or /app

Check web server fallback. Frontend routes must serve index.html.

Bad setup:

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

Good setup:

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

Health checks

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

Expected:

{"status":"ok"}