Billing, Credits & Quotas
Firetell uses a transparent two-part billing architecture designed for cloud contact centers and Voice AI workloads:
- Workspace Subscription & Agent Seats (
monthlyoryearlybilling cycle) — unlocks platform features, concurrent call capacity, storage retention, and human agent seats. - Prepaid Credit Wallet (
USD) — pay-as-you-go balance for metered telecom & AI consumption (PSTN call minutes, DID number setup/monthly fees, SMS/MMS segments, AI call transcriptions, and realtime Voice AI model minutes).
Subscriptions & Credit Balance
Navigate to Console → Settings → Billing to manage plans, top up credits, and reconcile accounting records across three dedicated tabs.
1. Subscription & Credit (Settings → Billing → Subscription & Credit)
Workspace Subscription Lifecycle
- Billing Cycles & Add-on Seats: Choose between Monthly and Yearly billing cycles. Plans include a base allocation of agent seats, and you can scale additional human contact center seats on demand as your team grows.
- Subscription Statuses:
Active: All plan quotas, concurrent channels, and retention policies are active.Canceling: Scheduled to terminate at the end of the current billing cycle; full workspace functionality remains active until the end of the paid period.Past Due/Unpaid: Automatic renewal payment failed on your payment method. Update your card promptly to prevent plan downgrade or call routing suspension.Canceled: Subscription has ended; workspace falls back to default tier limits.
Prepaid Credit Wallet
Your workspace maintains a real-time Credit Balance (USD) that funds metered telecom and AI activity:
| Metered Usage Type | When Credits Are Deducted | Ledger Attribution |
|---|---|---|
| DID Number Provisioning | Immediately upon purchasing a virtual phone number (one-time setup fee + first month's rental fee), then monthly on renewal. | DID purchase & monthly renewal |
| Inbound & Outbound PSTN Calls | Upon call completion based on connected billable duration and destination country prefix rate. | Linked to Call ID (call_...) |
| Autonomous Voice AI Minutes | Per connected minute at the selected realtime model's published $rate/min (shown directly in the Voice Agent model picker). | Linked to Call ID (call_...) |
| AI Call Transcription & Summaries | When post-call speech-to-text, speaker diarization, sentiment, and summary generation complete. | Linked to Call ID (call_...) |
| SMS & MMS Messaging | Per outbound/inbound carrier message segment. | Message delivery ledger entry |
Want to trigger internal Slack or PagerDuty alerts if your credit wallet runs low during a high-volume campaign? Subscribe to the workspace.credit.updated event under Console → Settings → Webhooks.
2. Invoices & History (Settings → Billing → Invoices & History)
Every subscription renewal, seat adjustment, and prepaid credit top-up generates an official invoice record:
- View invoice status (
Paid,Open,Void,Refunded), billing period dates, and payment amounts. - Download itemized PDF Invoices & Tax Receipts directly for corporate accounting and expense reconciliation.
3. Credit Transactions (Settings → Billing → Credit Transactions)
The Credit Transactions ledger provides an immutable, searchable audit trail of every balance movement in your workspace:
| Transaction Type | Effect on Balance | Description |
|---|---|---|
Deposit | + Credit | Self-service credit top-ups completed via online card checkout. |
Promo | + Credit | Promotional onboarding or plan upgrade bonus credits. |
Charge | − Debit | Automated per-call, Voice AI, transcription, SMS, or DID purchase/renewal deductions (click the linked Call ID to cross-reference the exact CDR). |
Refund | + Credit | Reversed charges or refunded DID orders. |
Adjustment | + / − | Manual billing reconciliation applied by Firetell Billing Support. |
Workspace Limits & Quotas
Open Console → Settings → Limits & Quotas to inspect real-time resource consumption against your active plan's entitlements.
Complete Entitlement & Quota Reference
| Quota Metric | Console Section | What It Controls |
|---|---|---|
| Concurrent Calls | Settings → Limits & Quotas | Maximum simultaneous active calls (inbound + outbound + Voice AI) across the workspace at any second. |
| Monthly Included Call Minutes | Settings → Billing | Monthly platform minute allowance before standard per-minute metering applies. |
| Voice AI Agents | Voice Agents | Maximum autonomous Voice AI assistants configured in the workspace. |
| Knowledge Bases | Knowledge Bases | Maximum RAG knowledge repositories (up to 100 documents per Knowledge Base). |
| Workspace Storage | Settings → Limits & Quotas | Combined storage pool for call recordings, uploaded IVR audio files, and Knowledge Base documents. |
| Call Center Agents & Teams | Call Center → Agents / Teams | Maximum human agent accounts (base seats + add-on seats) and department ring queues. |
| Extensions & SIP Accounts | Call Center → Extensions / SIP Accounts | Maximum internal dial extensions (101, 102, …) and hardware IP phone / softphone registrations. |
| Phone Numbers (DIDs) | Phone Numbers | Maximum active virtual DIDs and connected BYOC SIP trunk numbers. |
| Call Flows & Audio Prompts | Call Flows / Audio Files | Maximum visual IVR routing graphs and studio prompt files. |
| SIP Trunk ACLs & Gateways | SIP Trunks | Maximum custom Inbound IP ACLs and Outbound Carrier Gateways (system-managed Firetell DID routes do not consume your custom quota). |
| Workspace API Keys | Settings → API Keys | Maximum active REST API keys for server-to-server integrations. |
| Call Recording & Retention | Call Center → Recordings | Controls external & internal call recording authorization and automatic retention period (days). |
| Audit Log Retention | Settings → Audit Logs | Number of days administrative & security events are retained for compliance review. |
What Happens When a Limit Is Reached?
- Configuration Limits (such as Agents, Extensions, Voice AI Agents, or Knowledge Bases): The Console displays a clear quota banner when attempting to create a new resource. Delete unused drafts/resources or click Change Plan to upgrade your tier immediately.
- Live Calling Concurrency: If all concurrent call slots are occupied during a traffic spike, additional inbound or outbound call attempts receive SIP
503 Service Unavailableuntil an active call disconnects or you upgrade your plan's concurrency tier.