Custom HTML and other platforms
Install ASE on any website that can load a script tag: static sites, custom PHP, React, Next.js, Vue, Laravel and more.
Before you start
You need a widget key for this site. Create one under Keys & Embed after adding your domain; the embed code shown there is the snippet used below:
<script src="https://app.ase.support/widget/ase.js" data-key="pk_YOUR_KEY" defer></script>
Steps
- Add the snippet before
</body>in your layout or root template so it loads on every page. - Single-page apps: include the tag once in
index.html. The widget stays mounted while your router changes views. - Deploy and open the site in a private window.
Check
- Open the site in a private window; the chat bubble appears in the corner you chose in Agent Settings.
- Send a test question. If the answer is generic, assign a knowledge base category to the agent under Agent Access.
- If nothing appears, see troubleshooting.
Notes
- Content-Security-Policy: allow
script-src https://app.ase.supportandconnect-src https://app.ase.support. - Want the chat inside the page instead of a floating bubble? Use the Page Embed plugin.
- Advanced options (pinning an agent, custom API base) are in widget options.
A native Custom HTML extension that installs the widget without touching theme files is in development. The script method above is the supported way today and will keep working.