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

# Proactive Messages

Trigger targeted widget messages based on page, session, identity, and behavior rules.

# Proactive Messages

Proactive messages let RogerIQ show targeted prompts before a visitor asks for help.

## Use Cases

- announce a docs or product update
- offer help on a pricing or checkout page
- ask for feedback after repeated page views
- guide visitors who appear stuck
- notify active docs readers after a HolyDocs changelog publish

## Rule Types

| Rule | Example |
| --- | --- |
| URL match | Show on any `/pricing` URL. |
| Specific URL | Show only on one page. |
| Last page viewed | Trigger based on the previous page. |
| Page views | Trigger after a count threshold. |
| Repeat page views | Trigger after repeated visits to a page. |
| Time on page | Trigger after a visitor remains on a page. |
| Identify property | Trigger for a known plan or segment. |
| Session data | Trigger based on `session-data`. |
| Exit intent | Trigger before leaving the page. |
| Scroll depth | Trigger after a percentage of the page. |

## Manual Display

```js
RogerIQ("show-message", "msg_123", {
  delay: 1000,
  force: true
});
```

## Events

Proactive messages emit:

- `message-triggered`
- `message-clicked`
- `message-closed`
- `message-answered`

Use proactive messages sparingly. One useful prompt beats a stack of interruptions.