Behaviour

Scenarios

The assistant can start the conversation. Here you decide when it does and what it says.

Behaviour

Two modes

The mode is the first decision, because it settles who picks the moment and who writes the words.

  • Let Breezaro decideThe assistant picks the moment itself and writes the message from the content of the page the visitor is on. That page has to be in the knowledge base, otherwise nothing appears.
  • Custom rulesYou build scenarios from conditions and either write the message or let the assistant write it. A scenario with its own text needs no knowledge base at all.
Behaviour

Conditions

A scenario fires when all of its conditions hold at once. They are evaluated on every ask the widget makes.

  • Page addressEquals, contains, or matches a pattern. The value can be a whole address or a path on its own, so /pricing works just as well as https://example.com/pricing; a path on its own ignores the domain. In a pattern an asterisk stands for any text, and the pattern is compared against both the full address and the path, so /pricing* and */pricing* both work. Tracking parameters such as utm_*, fbclid or ref are removed before matching, so a rule written on one of them never fires.ExampleMatches pattern · /pricing*
  • Time on pageHow many seconds the visitor has spent on the current page. Only time while the tab is visible counts; a tab in the background does not add up. The most common second condition, because on its own it separates browsing from interest.ExampleAt least · 20
  • Pages viewedHow many pages the visitor has seen during this visit. Needs no browsing-history consent.ExampleAt least · 4
  • First view this visitTells a first view of a page from a return to it. Requires browsing history to be enabled.ExampleIs · Yes
  • Distinct pages seenHow many different paths matching the pattern the visitor has viewed. Write the path with a wildcard and pick the count: /product/* with a count of 3 means they looked at at least three different products. A lone * means any page, so * with a count of 2 simply means two different pages. Requires browsing history to be on.ExampleAt least · /product/* · 3
Setup

Before you switch a scenario on

Four steps from an empty page to the first bubble.

  1. Choose the Custom rules mode
    Switch the mode in Settings and save. Without it scenarios are not used, even when they are finished.
  2. Create a scenario
    Pick a template, or start blank and add conditions. A sentence builds up under the conditions telling you when the scenario fires.
  3. Try it without publishing
    Expand Try scenarios in the dialog, enter an address and a time on page, and run it. Every condition reports whether it fits. It works on an unsaved scenario too.
  4. Switch it on and check in the browser
    Turn on Reach out to visitors at the top of the page. Without it nothing is sent, whatever the mode or the scenarios say. Then open your site in a new tab. Limits count per visit, so reloading the same page repeatedly will use them up.
Behaviour

Limits

The rails that apply to both modes and keep the assistant from pestering a visitor.

Maximum messages per visit sets how often the bubble may appear during one visit. Minimum gap keeps a pause between them. Offer again after the bubble is dismissed decides whether a closed bubble may come back later in the visit. Excluded addresses rule out pages where an approach is wrong, typically the cart or the checkout: /cart* covers /cart as well as everything under /cart/, and a pattern can carry at most 8 asterisks.

Behaviour

Diagnostics

When a bubble does not appear, the widget can tell you why.

Append ?breezaroDebug=1 to the address of any page with the widget, or set localStorage.breezaro-debug to 1 in the browser, and the console prints [breezaro:proactive] lines for every ask and its outcome.

Behaviour

Credits

Your own text is free, having the assistant write is not.

A message written by the assistant adds one credit to the conversation it starts, and only when the visitor replies. Scenarios with your own text and the welcome bubble cost nothing. Writing one is also capped per day, per bot, by your plan: the assistant composes an opener once per page and language and then reuses it, so the cap limits how much new ground a busy day can cover, not how many bubbles visitors see.