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

  1. Add the snippet before </body> in your layout or root template so it loads on every page.
  2. Single-page apps: include the tag once in index.html. The widget stays mounted while your router changes views.
  3. 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.support and connect-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.