Usage Counters & Overage

Usage Counters Overview

Under Billing > Usage (/billing), Operator displays real-time resource meters backed by usageCounters in the database: - Conversations: Total customer dialogue threads initiated this billing cycle. - Voice Minutes: Cumulative telephone audio duration in seconds, converted to minutes. - Knowledge Articles: Total active documents and website crawl pages stored in the Knowledge Base.

Limit Enforcement Modes

Controlled by usageLimitBehavior in src/lib/billing/plans.ts: - UPGRADE_REQUIRED (Starter & Professional): When an organization reaches 100% of its conversation or voice minute quota, the system sends an email notification and prompts staff to upgrade. New incoming requests can be paused until upgraded. - OVERAGE (Business Tier): Operations continue uninterrupted; excess usage is calculated at transparent per-minute and per-conversation overage rates appended to the next monthly invoice.

Invoices & Payment Records

All transactional records are logged in invoices and payments: - Review paid invoices, download PDF receipts, and audit transaction IDs. - If a renewal payment fails, the subscription enters a 3-day grace period (gracePeriodDaysRemaining) before restricting advanced AI features.