Documentation

Usage

Track message usage, monitor limits, and understand agent activity.

Track how your agent is being used. Monitor message counts, understand usage patterns, and stay within your plan limits.

Usage Overview

The workspace sidebar shows a usage panel with:

  • Messages used in the current billing period
  • Messages remaining out of your plan total
  • Reset date — when the quota resets

Message Counting

What Counts as a Message

Each message sent by a visitor to your agent counts as one message. The agent's response does not count separately.

Example

Visitor: "What are your pricing plans?" → 1 message
Agent: [responds with pricing info]
Visitor: "Tell me more about Pro" → 1 message
Agent: [responds with Pro details]

This conversation used 2 messages.

Plan Limits

PlanMessages/Month
Free50
Hobby2,000
Standard12,000
Pro40,000

Messages are shared across all chatbots in your workspace and reset at the start of each billing cycle.

What Happens at the Limit

When you reach your monthly message limit:

  1. Your agent displays a friendly message to visitors
  2. Visitors are told to try again later
  3. You can upgrade immediately for more messages

The agent continues working - it just can't respond until:

  • Your billing cycle resets, or
  • You upgrade to a higher plan

Monitoring Usage

Check usage from the sidebar panel that appears in every workspace page. It shows your current count, remaining messages, and reset date.

Per-Agent Usage

For multiple agents, usage is shared across your workspace:

  • All agents draw from the same pool
  • Check individual agent activity in Chat Logs

Optimizing Usage

High-Traffic Tips

  • Set up rate limiting to prevent abuse
  • Use suggested messages to reduce back-and-forth
  • Ensure training content answers questions clearly

Reducing Message Volume

  • Improve answer quality (fewer follow-up questions)
  • Add Q&A pairs for common questions
  • Configure rate limits per visitor

Upgrading Your Plan

If you regularly hit limits:

  1. Go to Billing in the sidebar
  2. Pick a higher tier and complete checkout
  3. Messages increase immediately

Understanding Usage Patterns

Use Chat Logs alongside the sidebar usage panel to spot patterns:

  • Filter conversations by date range to compare quieter and busier periods
  • Review messages-used pace mid-cycle to decide whether to upgrade before the reset
  • Identify common questions that drive high message volume so you can answer them with Q&A pairs and reduce back-and-forth

Next Steps