Notification Rules

Notification rules tell FloatMessage when to ping you via web push as soon as a high-intent visitor lands on your site. They run automatically in the background — no need to keep the dashboard open.

Pair them with web push notifications so the alerts reach your phone or desktop in real time.

Setup

Open Dashboard → Chat → Settings → Notifications.
Subscribe to web push if you haven't already (the dashboard will prompt).
Click + Add rule, pick a rule type, and set its value.
Toggle the rule on and save. Repeat for as many rules as you need.

Whenever a visitor matches at least one enabled rule, FloatMessage sends a single push notification with the visitor's label (name / email / fallback) and the matching rule descriptions.

Rule types

Type	Value	Matches when…
`page_match`	URL or pattern (`*` wildcard supported)	Visitor's page URL contains the value, or matches the wildcard pattern.
`country_match`	2-letter ISO country code (e.g. `US`)	Visitor's detected country (CF-IPCountry header) equals the value.
`visit_count`	Number (e.g. `3`)	Visitor has visited at least N times.
`new_visitor`	(no value)	First time FloatMessage has seen this visitor.

Rules are OR-combined — a visitor matching any single enabled rule fires a notification. Disabled rules are skipped.

Example rules

[
  { "id": "r1", "type": "page_match", "value": "/pricing", "enabled": true },
  { "id": "r2", "type": "page_match", "value": "/checkout/*", "enabled": true },
  { "id": "r3", "type": "country_match", "value": "US", "enabled": true },
  { "id": "r4", "type": "visit_count", "value": "5", "enabled": true },
  { "id": "r5", "type": "new_visitor", "value": "", "enabled": false }
]

With this configuration you'd get pinged every time:

A visitor lands on the pricing page.
A visitor reaches any URL under /checkout/.
A visitor from the US arrives.
A returning visitor reaches their 5th session.

New-visitor alerts are off here, so brand-new visits don't flood your phone unless they also match one of the other rules.

Notification format

When at least one rule matches, FloatMessage builds a single push notification:

Title: Visitor alert: jane@example.com
Body:  on /pricing, from US, 5 visits
URL:   /dashboard/chat

Tapping the notification opens your chat dashboard so you can see the visitor and reach out immediately.

Tips

Be selective. A rule that matches every visitor (e.g. new_visitor on a busy site) will spam your phone. Use page or country rules to focus on the highest-intent traffic.
Wildcards work. /blog/* matches any URL whose path begins with /blog/.
Combine with proactive chat. A notification is the start of a conversation — when you get one, jump into the dashboard and send a proactive message via broadcast or directly from the visitor list.