Documentation Index
Fetch the complete documentation index at: https://docs.botbrains.io/llms.txt
Use this file to discover all available pages before exploring further.
Audiences let you segment users so you can deliver different guidance, knowledge, and tool access to different groups. You define an audience once, then attach it to guidance rules or data providers. Conversations that don’t match any audience filter receive guidance set to “Everyone.”
Creating Audiences
- Navigate to Settings → Audiences
- Click Create audience
- Name it descriptively (for example, “Enterprise EU Customers”)
- Build segmentation rules using the query builder
- Save
Combine multiple conditions with AND/OR logic. The root-level group always uses AND logic.
Available Fields
User Attributes
| Field | Examples |
|---|
| Identity | User ID, email, phone, name, external ID |
| Platform IDs | Zendesk ID, Slack ID, WhatsApp ID |
| Metadata | Timezone, locales, external attributes (JSON) |
| Labels | User-assigned labels |
| Activity | Last seen date, account creation date |
| Verification | Email signed, phone signed, external ID signed |
Channel Properties
| Field | Examples |
|---|
| Channel type | Browser, WhatsApp, Zendesk, Slack, API, Salesforce |
| Zendesk | Subdomain, group ID, brand ID, private mode status |
| Slack | Team ID, team name |
| WhatsApp | Phone number |
| Browser | URL, user agent |
Conversation Context
| Field | Examples |
|---|
| Identifiers | Conversation ID, external ID |
| Metrics | Message count, conversation length |
| Timestamps | Created date, updated date, first/last message time |
| Metadata | Integration type, tags, labels |
Time Conditions
| Field | Examples |
|---|
| Date/Time | Current date, current datetime |
| Components | Hour, day of week, day of month, month, year |
| Timezone | Timezone string |
Operators
| Type | Operators |
|---|
| Text | is, isn’t, contains, starts with, ends with, is empty, isn’t empty |
| Number | is, isn’t, less than, greater than, between, is empty |
| boolean | is true, is false |
| Date | is, before, after, between dates, in the last, in the next, is empty |
| Select | is one of, isn’t one of |
| multiselect | contains, contains any of, contains none of, is empty |
| JSON | text is, number is, boolean is, contains, path exists |
Examples
VIP customers:
User External Attributes -> JSON text is -> "tier" = "enterprise"
AND User Labels -> contains any of -> ["vip", "premium"]
(Current Hour -> less than -> 9 OR Current Hour -> greater than -> 17)
AND User Timezone -> contains -> "America"
Channel Type -> is one of -> ["zendesk"]
AND User Created At -> in the last -> 7 days
Where to Use Audiences
Guidance rules. Attach an audience to a guidance rule to scope its instructions and tools to matching conversations. See Instruct AI Agent.
Data providers. Assign a default audience to a data provider so new sources automatically inherit the scope, making knowledge available only to matching users.
Knowledge sources. Scope individual sources to specific audiences so users only see relevant documentation.
