> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rogeriq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Beacons

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

# Beacons

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. |

## Public Beacon Config

```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.

## Install

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.