Metering
ZENIA tracks chat message usage at two levels: workspace-wide, across all your domains, and per-domain, for each individual website. This helps you understand where your monthly quota is being used.
Counting
How message counting works
1. Each visitor question sent through the chat widget counts as 1 message when it is processed successfully.
2. The AI's response does not count as a separate message.
3. Failed messages are not normally deducted from your quota.
4. Counters reset at the start of each new monthly usage period.
2. The AI's response does not count as a separate message.
3. Failed messages are not normally deducted from your quota.
4. Counters reset at the start of each new monthly usage period.
Usage
Where to see your usage
| Page | What it shows |
|---|---|
| Overview | Workspace messages this month and website count, with progress bars where available |
| Domains | Compact usage banner with message and website meters where available |
| Domain Detail > Overview | Domain-specific messages this month, plus workspace-wide usage for context |
| Account > My Plan | Current plan, available limits, usage bars, and included features |
| Account > Usage | Workspace-wide monthly message history, where usage history is available |
| Domain Detail > Usage history | Per-domain monthly message history, where domain history is available |
Realtime
Automatic updates
Usage counters can update automatically on open dashboard pages when supported usage updates are received. Some changes may appear only after the next fetch, page refresh, or dashboard reload.
Limits
What happens at the limit?
When your workspace reaches the monthly message limit, new visitor messages may be blocked until the limit resets or the workspace moves to a plan with a higher limit.
For visitors - The chat widget may show a message explaining that the monthly message limit has been reached.
For you - The dashboard can show the current usage state so you can review the plan limit and decide whether to change plans.
To resolve - Review your current plan and available options from the account area.
For visitors - The chat widget may show a message explaining that the monthly message limit has been reached.
For you - The dashboard can show the current usage state so you can review the plan limit and decide whether to change plans.
To resolve - Review your current plan and available options from the account area.
Breakdown
Per-domain breakdown
Each domain can have its own message count. On the Domain Detail > Overview tab, you may see two meters:
Domain messages - How many messages this specific domain has processed during the current usage period.
All domains - Your workspace-wide total across all domains. This is the total checked against the workspace plan limit.
Domain messages - How many messages this specific domain has processed during the current usage period.
All domains - Your workspace-wide total across all domains. This is the total checked against the workspace plan limit.
History
Usage history
In addition to current-period counters, ZENIA can show historical usage trends where usage history is available. You can review usage from two places:
| Location | What it shows |
|---|---|
| Account > Usage tab | A workspace-wide monthly usage chart and summary table, where account usage history is available. |
| Domain Detail > Usage history panel | A per-domain monthly usage view, where domain usage history is available. |
Relay flow
How limits are enforced
ZENIA checks message usage against the workspace plan limit before accepting new chat messages. This helps keep usage aligned with the plan selected for the workspace.
Message relay flow
Visitor → Indexer (quota check) → chat.buildbot.ro (AI/LLM)
↑
Blocked if over limitStorage
Usage records
Usage information is maintained for workspace-level and domain-level views:
| Level | Period | Purpose |
|---|---|---|
| Workspace usage | Monthly usage period | Tracks total message usage across all domains in the workspace |
| Domain usage | Monthly usage period | Tracks message usage for an individual domain |
Events
Usage updates
The dashboard can show usage information in several ways:
| Update type | Where it appears | Purpose |
|---|---|---|
| Current domain usage | Domain detail pages | Shows current-period usage for one domain |
| Workspace usage update | Open dashboard pages, where supported | Refreshes workspace-wide counters after supported usage changes |
| Domain usage update | Open domain pages, where supported | Refreshes per-domain counters after supported usage changes |
| Limit notice | Dashboard or widget, where applicable | Explains when a message or website limit has been reached |
| Workspace usage history | Account usage area | Shows historical workspace message usage where available |
| Domain usage history | Domain detail area | Shows historical message usage for one domain where available |
FAQ
FAQ
Q: Does the AI's reply count?
A: No. The visitor's question is the message that counts toward usage.
Q: What if the AI fails?
A: Failed messages are not normally counted. Usage is intended to increment only after a message is processed successfully.
Q: When does the counter reset?
A: Counters reset at the start of each new monthly usage period.
Q: Can old usage data be viewed?
A: Where usage history is available, go to Account > Usage to see workspace usage history. On Domain Detail, expand the Usage history panel to see per-domain trends.
Q: Are connection failures counted?
A: If a message cannot be processed because of a connection or service failure, it is not normally counted.
A: No. The visitor's question is the message that counts toward usage.
Q: What if the AI fails?
A: Failed messages are not normally counted. Usage is intended to increment only after a message is processed successfully.
Q: When does the counter reset?
A: Counters reset at the start of each new monthly usage period.
Q: Can old usage data be viewed?
A: Where usage history is available, go to Account > Usage to see workspace usage history. On Domain Detail, expand the Usage history panel to see per-domain trends.
Q: Are connection failures counted?
A: If a message cannot be processed because of a connection or service failure, it is not normally counted.