betool betool

Documentation

Web chat widget

Chat widget embeddable on any website with a single JS script.

Web chat widget

The chat widget is a JS script you embed on your website (marketing, support, app). It opens a conversation bubble powered by one of your betool pipelines.

Features

  • A single script tag to paste into your <head>. No npm dependency.
  • Public token — revocable at any time from the admin panel. No secret on the client side.
  • Persistent conversations — users pick up where they left off between visits.
  • Multi-pipeline — one site can serve multiple widgets (pre-sales, support, documentation).

Setup

  1. Administration → Chat widgets → New widget.
  2. Give it a name and choose the target pipeline.
  3. Copy the generated snippet:
<script
  src="https://platform.betool.ai/widget/v1/widget.js"
  async
></script>
<script>
  window.addEventListener('load', () => {
    window.BetoolChat.init({
      token: 'pub_wdg_xxxxxxxxxxxxxxxx',
    })
  })
</script>

The widget appears in the bottom-right corner by default.

Customization

From the widget admin panel:

  • Appearance — accent color, position, labels.
  • Behavior — auto-open after X seconds, welcome message.
  • Scope — restrict allowed domains (CORS).

Security

The token is public by design: it scopes a single widget. If someone uses it from an unauthorized domain, the request is rejected server-side. To revoke a compromised widget: Administration → Chat widgets → Revoke.

Limitations

  • No co-browsing yet (the agent cannot see the user's page).
  • The widget does not handle large attachments (>10 MB). For that, use an email pipeline.