Notification Rules

Route closed chats to the right people using flexible rules. Each rule decides when to fire (checks), who to notify (recipients), and whether the chat stays in your inbox for follow-up.

How to get there: Go to Setup → Chatbot in the top menu → click your chatbot → Notifications tab.

Overview

Every time a chat closes, Boei evaluates all your notification rules against it. Rules are independent: a single chat can match zero, one, or all of them, and each matching rule sends its own notifications.

A chat that matches no rule is auto-closed silently. You can still find it under Inbox → Filters → Closed.

This replaces the old "Send to You" dropdown, which forced a single global choice. With rules you can, for example, email sales when a lead is captured, ping Slack when the AI struggles, and webhook every chat to your CRM, all in the same bot.

Prerequisites

  • Enable Transcripts must be on (top of the Notifications tab). This is the master toggle for post-chat analysis and notifications.
  • Send to Customer is a separate toggle: it emails the transcript to the visitor and adds an "Email me this conversation" item to the widget menu. It is not affected by rules.

Adding a Rule

Click Add rule to start blank, or pick a template to prefill checks and recipients. Common templates:

  • Email me every lead — fires when the lead form is submitted, emails you
  • Copy every chat to a webhook — sends the transcript JSON to your endpoint, no inbox clutter
  • Ping Slack when bot needs help — fires when the AI escalates or hits low confidence
  • Route chats from /pricing to sales — fires when the chat started on a URL matching your pattern
  • AI-driven templates — a rule with an AI check like "route finance questions to the bookkeeper" or "B2B leads go to sales"

Templates are starting points. You can add, remove, or edit any check or recipient after inserting.

Checks: When a Rule Fires

Add one or more checks per rule. With two or more checks, choose:

  • ALL (AND) — every check must match
  • ANY (OR) — one match is enough

Zero checks means the rule fires on every closed chat.

Structural Checks

These are computed from the chat itself, no AI evaluation, no extra cost.

Check Fires when
Lead form was submitted All required lead flow fields are filled in
Email or phone shared in chat Visitor provided contact info during the conversation, even outside a lead form
AI escalated to a human The bot handed off to a live agent
AI couldn't fully answer AI health score is below 60 (see Health Score Reference)
Chat had at least N messages Message count meets the threshold you set (default 10)
Chat lasted at least N minutes Conversation duration meets the threshold you set (default 5)
Chat started from URL matching Landing page URL matches your pattern (supports * wildcards, e.g. */pricing*, */checkout*)
Visitor is a returning customer Same visitor identifier was seen in a prior conversation
Conversation language is Detected language matches your dropdown choice

AI Check

Describe a condition in plain language and AI evaluates it against the transcript. Examples:

  • "The visitor represents a business, not a private consumer"
  • "The visitor mentioned a budget or timeline"
  • "The visitor is asking about a competitor comparison"

Each AI check costs a small amount of AI credit per closed chat, so use it when structural checks alone can't capture the intent. One AI check per rule is common; adding two is fine but doubles the credit cost per chat.

Recipients: Who Gets Notified

A rule can have any combination of the four recipient types, or none at all (useful when you only want to control inbox visibility).

Recipient What happens
Email Sends the transcript to any email address (yours, a colleague, a shared mailbox, a distribution list). Add multiple email recipients on the same rule if you want a group to see it.
Chat agent Sends the transcript to the agent's account email and auto-assigns the reopened thread to their inbox queue. Pick this over a plain email whenever a specific person owns the reply. The agent must be added under Chat Agents first.
Slack Posts a short summary with a link to the full transcript to the Slack channel. Uses an Incoming Webhook, configured once per bot.
Webhook POSTs the transcript JSON to a URL you choose. Standard for CRM sync, agency data warehouses, or wiring into Zapier/Make. See webhooks for the payload schema.

Auto-Assignment via Chat Agent

The Chat agent recipient does two things that a plain email doesn't:

  1. Delivers the transcript to the agent's account email
  2. Assigns the reopened thread to that agent in the inbox, so it appears in their "assigned to me" queue

If multiple rules on the same chat pick different chat agents, the first agent to be assigned wins; later chat-agent recipients still get the transcript email but the assignment isn't overwritten.

Inbox Follow-up Toggle

Each rule has an Add to my inbox for follow-up checkbox:

  • On — matching chats stay in your inbox as open threads, ready for a human reply
  • Off — the chat sends its notifications and then auto-closes silently

Use "off" for archival or CRM-sync rules where you don't want the inbox to fill up with routine chats.

If a chat matches multiple rules, "on" wins: any single rule with the toggle on keeps the thread visible.

Email Content Options

Per rule, expand Email content options to customize what email recipients see:

  • Subject — override the default subject line (supports variables like the visitor's name)
  • Include full transcript — the full message-by-message conversation. Turn off for a summary-only email.
  • Include customer info — captured email, name, phone, or other lead fields
  • Show "Reply to conversation" button — one-click link back into the inbox to continue the thread
  • Show "Review AI performance" link — link to the analytics view for that chat, useful for AI-tuning workflows

These options only affect email recipients. Slack and webhook payloads are unchanged.

Reordering and Deleting

  • Reorder — drag rules by the grip handle on the left. Order is cosmetic (all rules always evaluate) but keeps the list readable.
  • Delete — click the trash icon on a rule. Deletion is immediate.

Example Setups

Solo founder handling everything

Two rules:

  1. Fires when "Lead form was submitted" → email to your inbox, keep in inbox
  2. Fires when "AI couldn't fully answer" → email to your inbox, keep in inbox

Result: you get notified on real leads and on struggling chats, routine handled-well chats close silently.

Small team with a sales / support split

Three rules:

  1. Fires when "Chat started from URL matching */pricing*" OR "AI check: visitor is evaluating a purchase" → chat agent = your senior sales rep, keep in inbox
  2. Fires when "AI escalated to a human" → chat agent = on-duty support, keep in inbox
  3. Fires on every chat → webhook to your CRM, don't keep in inbox

Result: sales and support each see the chats they care about, CRM gets everything, the inbox stays focused.

Agency running many bots

Two rules per bot:

  1. Fires on every chat → webhook to your central data warehouse, don't keep in inbox
  2. Fires when "Lead form was submitted" → email to the specific client's contact + Slack #client-name

Result: the agency gets full data, the client sees only their leads.

Tips

  • Start with a template, then customize. Templates cover 80% of common setups.
  • Structural checks are free. Prefer them over AI checks when the same condition can be expressed with lead-form / URL / message-count checks.
  • Use "Chat agent" instead of email + manual assignment. One click, no follow-up work.
  • Turn off the inbox toggle for archival / CRM-sync rules. Keeps the inbox focused on chats that actually need a human.
  • A chat with no matching rule is not lost. It's silently closed and still searchable under Inbox → Filters → Closed.