Install the widget

ForeverChat installs with one snippet. No SDK, no build step, no runtime dependencies on your site — it works on plain HTML and every framework.

1. Find your app ID

Sign in and open Settings → Installation. Copy your app ID (it looks like fc_xxxxxxxxxxxxxxxx). Each website in your account has its own app ID.

2. Paste the snippet

Add this just before the closing </body> tag on every page where you want chat to appear, replacing fc_YOUR_APP_ID with your real app ID.

HTML — before </body>

<!-- ForeverChat -->
<script>
  window.ForeverChat = { appId: "fc_YOUR_APP_ID" };
</script>
<script async src="https://gateway-381807041351.us-east4.run.app/widget.js"></script>

Why two script tags? The first defines your configuration; the second loads the tiny async loader (well under 15 KB gzipped) so it never blocks your page.

3. Verify it’s live

Reload your site — the launcher button appears in the corner you configured. Back in Settings → Installation, the install-detected pill flips to “Detected” the first time the widget boots. Hit Re-check if you don’t see it yet.

Identifying signed-in users (optional)

If visitors log in to your site, you can tell ForeverChat who they are so conversations are tied to a real, verified person. Identity is only trusted when the signature is a valid HMAC — never send an unsigned identity from the browser alone.

HTML — identified visitor

<script>
  window.ForeverChat = {
    appId: "fc_YOUR_APP_ID",
    identity: {
      externalId: "user_123",
      name: "Ada Lovelace",
      email: "ada@example.com",
      signature: "SERVER_GENERATED_HMAC" // see the Identity & HMAC guide
    }
  };
</script>
<script async src="https://gateway-381807041351.us-east4.run.app/widget.js"></script>

Generate the signature on your server. The signature must be computed server-side with your website’s secret. See the Identity & HMAC guide for the exact formula.

Platform-specific guides

Not editing raw HTML? Use the guide for your platform: Google Tag Manager, WordPress, or Shopify.