Trigger Settings
Configure when and how your outreach messages are triggered based on visitor behavior and conditions.
Starter Events
Choose when your outreach should begin monitoring for trigger conditions.
Session Start
Triggers when a visitor begins a new session on your website.
Triggers immediately when a new session begins.
Triggers after a delay once the session starts. Useful for welcoming visitors after they've been on your site for a moment, or for follow-up messages.
Page View
Triggers when a visitor navigates to a new page on your website.
Triggers immediately when a visitor views a page that matches your conditions.
Triggers after a delay once a matching page view occurs. This timer starts at the moment of page view and will count down no matter what the visitor does. It will not reset, even if the visitor navigates to other pages or leaves the site.
- Page View with delay: The timer starts from the first matching page view and continues even if the visitor navigates elsewhere
- Time on page: The timer resets every time the visitor navigates to a new page. It only counts time spent on the current page.
Custom Event
Triggers based on custom events you send from your application.
Matches events with the exact name you specify. This option respects the frequency setting below — for example, if frequency is set to "Send once", the outreach will only fire once even if the event is sent multiple times.
Matches events with the exact name you specify, but ignores the frequency setting — the outreach will fire every time this event is received, regardless of frequency limits. This is useful for manual triggers like a "Show tour" button, where the visitor should always be able to re-trigger the outreach.
Yaplet.trackEvent('customEvent', { name: 'your-custom-event' });
Page Rules
Define which pages should trigger your outreach message.
Configure conditions for the current page URL using text matching operators. Available operators include:
- Equals / Not equals — exact URL match
- Contains / Does not contain — substring match
- Starts with / Ends with — prefix or suffix match
- Matches pattern — wildcard matching using
*(e.g./blog/*matches all blog pages,/*/editmatches any edit page) - Matches regex — full regular expression matching (case insensitive)
You can combine multiple conditions with AND (all must match) or OR (any must match) logic, and nest groups for more complex rules.
Time on Page
Set conditions based on how long a visitor spends on a specific page.
Triggers when a visitor has been on the current page for longer than the specified time.
- Page View with delay: The timer starts from the first matching page view and continues even if the visitor navigates elsewhere
- Time on page: The timer resets every time the visitor navigates to a new page. It only counts time spent on the current page.
Visitor Rules
Set conditions based on visitor attributes and behavior history.
Visitor Information
- Country: Filter by visitor's geographic location
- Email: Match based on visitor's email address
- Name: Filter by visitor's name
- External ID: Match against your own user identification system
- Plan: Filter based on subscription or plan type
- Value: Match against custom value fields
Behavior History
- Last seen: Filter visitors based on when they were last active
- First seen: Target visitors based on when they first visited
- Session count: Set conditions based on how many times they've visited
- Banned: Exclude banned visitors from receiving messages
Widget Context
- Widget: Target visitors interacting with specific chat widgets
Frequency Settings
Control how often visitors receive your outreach messages.
Each visitor receives the message only one time, ever.
Visitors can receive the message every time the trigger conditions are met.
Limit how many times each visitor can receive the message (specify the number).
Visitors can receive the message a limited number of times within a rolling time window (specify both count and days).