Get your embed code
Create a widget key and add one script tag to your website. The chat widget appears immediately, locked to your domain.
Create a widget key
- Open Keys & Embed.
- Click + New under Widget Keys.
- Choose the domain and the agent, add a label, and save.
A widget key looks like pk_…. It is public: it goes into your HTML and only works on the domain it was created for. One key serves one agent; create another key if you want a different agent on another subdomain.
Add the script to your site
Scroll to Embed Code and copy the snippet. It looks like this:
<script src="https://app.ase.support/widget/ase.js" data-key="pk_YOUR_KEY" defer></script>
Paste it just before the closing </body> tag on every page where the widget should appear. Platform-specific instructions are in Install on your platform.
The widget loads in its own Shadow DOM, so your site's CSS does not change its look and the widget does not change your site's.
Check that it works
- Open your site in a private window. The chat bubble appears in the corner you set in Agent Settings.
- Send a message. The answer should come from your knowledge base.
- In the panel, Chat Logs shows the session (if the agent's storage policy is Full).
Troubleshooting
| Bubble does not appear | Clear your site's cache and CDN cache. Check the browser console for a blocked script: a strict Content-Security-Policy must allow app.ase.support. |
|---|---|
| "Domain mismatch" in the console | The key was created for another domain. Create a key for this domain, or check the domain is spelled exactly as in Settings. |
| "Agent is offline" | The agent is deactivated in Agent Settings. Turn it on. |
| Widget appears but answers are generic | The agent has no knowledge base entries assigned. Check Agent Access in Knowledge Base. |
You are live. Next, grow the knowledge base and add intent rules for the questions that come up every day.