Quickstart
Quick Answer: To install the IteroChat widget and start delivering AI powered support, copy the HTML embed snippet containing your unique
data-widget-keyfrom Settings in your dashboard, and paste it immediately before the closing</body>tag of your website.
By the end of this guide, you will have a working AI chatbot active on your website.
This guide walks you through signing in, copying your widget snippet, and pasting it into your pages so your customers can start chatting. It takes less than 5 minutes and requires no code beyond a single <script> tag.
1. Sign in to your workspace
Open the Iterochat dashboard and sign in with your email and password. Once you're in, you land on the Conversations view, your home base for everything that follows.
How you get here depends on how your account was set up. If your organization was created for you, you'll have received an email invite. Open the invite link, set your name and password, and you're in. If you're starting fresh, create an account first, verify your email, then create your organization. Either way you end up in the same dashboard. See Accounts and roles for the full sign-up, verification, and invite flow.
2. Get your widget key
Go to Settings, then the Website Widget card. There you'll find your Widget Key, a string that starts with wk_. This key identifies your organization, so every conversation that comes through the widget lands in your workspace.
You don't need to copy the key by hand for the next step: it's already baked into the embed snippet below it. The key is just shown separately so you know what it is.
3. Add the widget to your site
In the same Website Widget card, copy the HTML Embed Snippet (use the Copy button on the snippet). Paste it into your site's HTML immediately before the closing </body> tag. The snippet looks like this, with your real key already filled in:
<script
src="https://widget.iterochat.com/widget.js"
data-widget-key="wk_your_key_here"
async>
</script>
That's the whole integration: no build step, no package to install, no other tags. The script loads asynchronously and renders a chat bubble in the bottom-right corner of your page.
Paste it once, sitewide. Put it in your layout, base template, or footer include so it loads on every page rather than copying it page by page.
4. Confirm the widget is live
Open your site in a browser and load any page that has the snippet. The dashboard's Get your AI live checklist detects the widget automatically as soon as the script loads, and the embed step flips to done on its own. No chat message is required.
If you have already installed the snippet but would rather not open your site right now, go to the Get your AI live page in the dashboard and select I've already installed it. That marks the step done immediately.
Once the step is confirmed, click the chat bubble and send a test message to make sure replies are coming through. The AI answers from your knowledge base, so if it has little to say on a brand-new workspace, add some documents first and try again. See Knowledge base.
Next steps
- The chat widget: what your customers experience, languages, and troubleshooting.
- AI configuration: shape the AI's tone, set suggested questions, and control when it hands off to a person.
- Handling conversations: how your team claims escalations and replies live.
- WhatsApp channel, Messenger channel, and Instagram channel: connect messaging apps so those chats land in the same queue.