Skip to main content
Users represent the people who interact with your AI agent. botBrains tracks each person across channels and over time, building profiles that enable personalized support and customer insights.

​
How botBrains Tracks Users

botBrains automatically creates user records as people interact with your AI.

​
Identification

You can identify users by email address, phone number, or an external ID from your own systems (CRM, auth, databases). botBrains tracks anonymous users by device and session until they identify themselves. botBrains tracks whether the owner has verified (signed) their email address or phone number, giving you higher confidence for security-sensitive operations.

​
Attributes

AttributeDescription
NameFirst and last name
Email / PhoneContact info with verification status
TimezoneDetected from device or explicitly set
LanguagesPreferred communication languages
Last SeenTimestamp of most recent interaction
External AttributesCustom key-value data from your systems (subscription tier, account status, etc.)
Pass external attributes through the API or integrations to enrich profiles with business data like subscription level, account status, or purchase history.
User Profile Example
{
  "id": "usr_abc123",
  "first_name": "Sarah",
  "last_name": "Chen",
  "email": "sarah.chen@example.com",
  "email_signed": true,
  "phone": "+14155551234",
  "phone_signed": false,
  "external_id": "cust_789xyz",
  "timezone": "America/Los_Angeles",
  "locales": ["en-US", "zh-CN"],
  "last_seen_at": "2025-11-29T18:45:00Z",
  "external_attributes": {
    "subscription_tier": "enterprise",
    "account_status": "active",
    "signup_date": "2023-06-15"
  }
}

​
Managing Users

Search and filter. Search across names, emails, phone numbers, and external IDs. Filter by labels or restrict to identifiable users only. Edit profiles. Update user information directly in the UI or sync data programmatically through the API. Label users. Apply labels like vip-customer or enterprise-user to organize users for filtering in analytics, exports, and audience targeting. View conversations. Each profile shows the user’s complete conversation history with full message content and timestamps. Export. Filter to the segment you need and export as CSV or JSON for compliance, CRM sync, or analysis in other tools.
The UI blurs personal information (emails, external IDs) by default and reveals it on hover, preventing accidental exposure in screenshots or screen shares.

​
Next Steps