Beacons

Add a floating contact launcher connected to a form, docs site, and optional messaging.

A beacon is a lightweight floating launcher. It opens a linked form and can optionally connect to docs and messaging behavior.

Beacon Fields

Field	Description
`form_id`	Form opened by the beacon.
`docs_site_id`	Optional hosted docs site association.
`position`	`bottom-right` or `bottom-left`.
`primary_color`	Hex color for launcher and accents.
`button_label`	Launcher label.
`button_icon`	`chat`, `mail`, `help`, or `custom_svg`.
`greeting_title`	Title shown when opened.
`greeting_text`	Intro text above the form.
`allowed_origins`	Sites allowed to load or submit.
`ai_agent_enabled`	Whether AI can assist from this beacon.
`messages_enabled`	Whether message flows are enabled.
`chat_enabled`	Whether chat is enabled.

bash
curl https://api.rogeriq.com/api/beacons/bcn_123/public

The response includes beacon appearance, linked form schema, Turnstile site key, and FingerprintIQ public key.

Use a beacon when your support entry point should be a structured form rather than the full RogerIQ widget.

html
<script async src="https://api.rogeriq.com/widget/v1/beacon.js"></script><div data-rogeriq-beacon="bcn_123"></div>

The exact embed markup can be copied from the beacon editor. The public config endpoint is stable for custom renderers.

Was this page helpful?