Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cobalt.peoplereign.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Web widget

The web widget is an embeddable chat experience you drop onto any page — a floating bubble that opens a panel, or a full-screen page you link to directly.

​
Embed it

Each web-widget channel has a public key. Add this snippet to your page, before the closing </body> tag, with your channel’s key: 
<script>
  window.cobaltSettings = { channelKey: "wgt_pub_your_channel_key" };
  (function () {
    var s = document.createElement("script");
    s.async = true;
    s.src = "https://widget.cobalt.app/loader.js";
    document.head.appendChild(s);
  })();
</script>
The loader fetches the channel’s configuration — branding, greeting, identity mode — so you can change those in the console without touching the page.

​
Choose how users are identified

Set the channel’s identity mode to match where you’re embedding it:
ModeWho can use itUse when
AnonymousAnyone on the pagePublic or low-sensitivity help, no sign-in required.
SSOSigned-in users via your SSOThe agent needs to know who the user is to act for them.
Embedded tokenUsers your app vouches forYour app already authenticates the user and passes a signed token to the widget.
If the agent performs actions on a user’s behalf, use SSO or an embedded token so requests are tied to a real identity.

​
Brand it

Configure the widget’s appearance on the channel’s settings — no code:
  • Display name and role shown in the header.
  • Avatar image (falls back to a generated initial).
  • Primary color for the launcher and the user’s message bubbles, with an optional header color and a second color for a subtle gradient.
  • Corner radius for the overall shape.
  • Greeting and up to a handful of suggested prompts shown when the conversation is empty.
  • Preferred voice for read-aloud.
Pick a primary color with enough contrast against white text — the widget uses it behind message text and on the send button.

​
Widget and full-screen share a conversation

The same channel can render as the compact widget or as a full-screen page. A user can move between them and keep the same conversation, history, and unsent draft — useful when a quick question turns into a longer session.