Help Center / Embed widget

Embed the chat widget

Add the AI Toruk widget to any website with a single script tag. The widget loads configuration from the console using your chatbot public key.

Install the snippet

From your chatbot settings, copy the embed code and paste it before </body> on every page where the chat should appear:

<script src="https://console.aitoruk.com/widget.js" data-key="YOUR_PUBLIC_KEY" defer></script>

Replace the script host with your console URL if you use a custom deployment.

Domain security

Set the chatbot website URL to the domain where the widget is installed. When domain checking is enabled, chat API requests must originate from that host (via Origin or Referer header) to prevent unauthorized use of your public key.

Customization

Widget colors, position, launcher text, and welcome message are controlled from chatbot settings. Plan features may require an upgrade to remove "Powered by" branding or enable lead capture in the widget.

WordPress & WooCommerce

Add the snippet via a custom HTML block, theme footer, or a header/footer plugin. For WooCommerce-specific features, connect your store under WooCommerce integration.

Troubleshooting

• Widget not appearing — Confirm the script is on the page, the bot is active, and no ad blocker is blocking the script.
• Chat errors — Verify the website URL matches the embedding domain and your trial or subscription is active.
• Stale content — Republish after knowledge changes; the widget fetches fresh config on load.