Widget Overview
The embeddable RogerIQ widget for docs search, AI answers, messaging, chat, identity, and proactive messages.
Widget Overview
The RogerIQ widget is a customer-facing support surface that runs on your website. It can offer self-service docs search, AI answers, contact messaging, chat, previous conversations, identity, attachments, proactive messages, and event tracking.
Capabilities
| Capability | Description |
|---|---|
| Docs search | Search published knowledge from the widget. |
| AI answers | Answer visitor questions with citations. |
| Messaging | Create support conversations from the widget. |
| Chat | Start live or AI-assisted chat when enabled. |
| Previous messages | Let returning users reopen prior conversations. |
| Identity | Link visitors to contacts through identify. |
| Secure mode | Verify email identity with HMAC signatures. |
| Proactive messages | Trigger targeted messages based on rules. |
| Attachments | Support file and screenshot attachments when enabled. |
| Events | Track page views, custom events, and session data. |
Runtime Hosts
| Resource | URL |
|---|---|
| Script | https://api.rogeriq.com/widget/v1/rogeriq.js |
| Runtime config | https://api.rogeriq.com/api/widget/:projectId/widget/runtime |
| Widget API | https://api.rogeriq.com/api/widget/:projectId/widget/* |
When to Use a Beacon Instead
Use a form beacon when you want a lightweight "contact us" launcher attached to a structured form. Use the full widget when you want docs search, AI answers, messaging, previous conversations, identity, and proactive behavior.