CYBIX DevelopersBack to cybix.app

Install the messenger

One script tag. It renders the launcher, loads your saved settings, and starts a visitor session on first message — no build step and no framework required.

Embed snippet

Paste this before the closing </body> tag.

<script
  src="https://cybix.app/widget.js"
  data-name="Acme Support"
  data-agent="BIX"
  data-color="#081d34"
  data-position="bottom-right"
  defer
></script>

Options

Each option is a data-* attribute. Anything you leave out falls back to the settings saved in your dashboard.

  • data-nameBrand name shown in the header
  • data-agentName of the AI agent (default BIX)
  • data-colorAccent colour as a hex value
  • data-positionbottom-right or bottom-left
  • data-greetingFirst message the visitor sees
  • data-whitelabelSet to 1 to hide the “Powered by” line

Settings API

The widget reads its configuration from your workspace, so branding changes take effect without touching the snippet.

# Read (public — the widget itself calls this)
curl https://cybix.app/api/widget/settings

# Update (agent token required)
curl -X PUT https://cybix.app/api/widget/settings \
  -H "X-Agent-Auth: <token>" -H "Content-Type: application/json" \
  -d '{"brandName":"Acme","accent":"#2e51ed","openingView":"chat"}'

Voice calls

The in-widget voice agent is still in development and stays hidden from visitors regardless of settings. The peer-to-peer video call links under /call/{room} do work today.