Skip to content
OrbContext
19 pages

Guide

Website widget

Add the chat bubble to any site with one script tag.

The widget is the fastest way to put OrbContext on a website. One script tag adds a chat bubble that answers from your bot's knowledge. There is no backend to write and no secret to protect.

  1. Copy your snippet

    In the dashboard, open your bot and choose Embed. The snippet already contains your bot's public key and the right host for that environment, so copy it exactly rather than typing it. Below, <your-api-host> stands for that host.

    HTML
    <script
      src="https://<your-api-host>/widget.js"
      data-key="pk_live_..."
      async
    ></script>
  2. Allow your domains

    On the same page, list the sites the widget may run on, for example example.com. The public key only works from those origins, so copying it to another site does nothing.

  3. Paste it before the closing body tag

    Reload the page. The bubble appears bottom-right.

Add it to your framework

The script is framework-agnostic: add it once, at the root of your site.

index.html

<body>
  <!-- your page -->
  <script src="https://<your-api-host>/widget.js" data-key="pk_live_..." async></script>
</body>

Widget or API?

Use the widget when you want a ready-made chat on a site. Use the API or SDK when you need your own UI, to run inside an app, to call OrbContext from a workflow, or to manage knowledge programmatically.