Trigger Rules

Control when your chat widget appears using trigger rules.

Trigger Types

Hunch supports several trigger types:

Trigger	Description
Immediate	Widget appears as soon as the page loads
Delay	Widget appears after a specified time
Scroll	Widget appears after scrolling a percentage of the page
Exit Intent	Widget appears when the mouse moves toward the browser chrome
Manual	Widget only appears when clicked

Configuring Triggers

In your website settings, you can configure:

1. Trigger Type: Select when the widget should appear
2. Delay (seconds): If using delay trigger (1-60 seconds)
3. Scroll Percentage: If using scroll trigger (10-100%)

Immediate Trigger

The widget appears immediately when the page finishes loading. Best for:

• High-intent pages
• Landing pages
• Product pages

Delay Trigger

The widget appears after a specified number of seconds.

{
  "type": "delay",
  "delay": 5
}

Best for:

• Giving visitors time to explore
• Reducing annoyance
• Blog posts and content pages

Scroll Trigger

The widget appears when the visitor scrolls past a certain percentage of the page.

{
  "type": "scroll",
  "scrollPercent": 50
}

Best for:

• Article pages
• Long-form content
• Product detail pages

Exit Intent Trigger

The widget appears when the visitor's mouse moves toward the top of the browser (indicating they might close the tab).

Best for:

• Lead capture
• Cart abandonment recovery
• Special offers

Manual Trigger

The widget only appears when the visitor clicks the chat button. It won't auto-open.

Best for:

• Customer support focus
• Minimal intrusion
• When visitors expect to initiate

Best Practices

• Test different triggers to see what works best for your audience
• Consider using "delay" or "scroll" to avoid interrupting initial page load
• Use exit intent sparingly - it can feel aggressive if overused