Documentation

Install, configure, and test your widget — plus operational tips for running safely in production.

Install the widget

  1. Create a widget in the Dashboard and complete the Setup Wizard.
  2. Publish the widget (status: active).
  3. Copy the embed snippet from Install.
  4. Paste it on your website, ideally right before </body>.
<script src="https://YOURDOMAIN.COM/embed/loader.js" data-widget-id="YOUR_WIDGET_ID"></script>

Allowed domains (security)

To prevent misuse of your widget ID, configure allowed domains in the Wizard (supports comma-separated values).

Example: example.com, shop.example.com, mylandingpage.io

Knowledge Base “training”

Add short documents (policies, FAQs, pricing, shipping rules). The assistant will use the most relevant snippets to answer.

For advanced RAG (PDF chunking + embeddings), we can add a Phase 2 module after launch.

Troubleshooting

  • If the widget doesn’t appear: confirm the widget is active and the domain is allowed.
  • If the iframe shows blank: ensure your hosting does not block iframes for /embed.
  • If AI replies don’t work: go to Admin → Settings and run “Test Key”.