Skip to main content
LLM ReadyRaw Markdown for AI agents:billing-and-quotas.mdFull index:llms.txtllms-full.txt

Billing, Credits & Quotas

Firetell uses a transparent two-part billing architecture designed for cloud contact centers and Voice AI workloads:

  1. Workspace Subscription & Agent Seats (monthly or yearly billing cycle) — unlocks platform features, concurrent call capacity, storage retention, and human agent seats.
  2. 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 TypeWhen Credits Are DeductedLedger Attribution
DID Number ProvisioningImmediately 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 CallsUpon call completion based on connected billable duration and destination country prefix rate.Linked to Call ID (call_...)
Autonomous Voice AI MinutesPer 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 & SummariesWhen post-call speech-to-text, speaker diarization, sentiment, and summary generation complete.Linked to Call ID (call_...)
SMS & MMS MessagingPer outbound/inbound carrier message segment.Message delivery ledger entry
Real-Time Balance Webhooks

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 TypeEffect on BalanceDescription
Deposit+ CreditSelf-service credit top-ups completed via online card checkout.
Promo+ CreditPromotional onboarding or plan upgrade bonus credits.
Charge− DebitAutomated per-call, Voice AI, transcription, SMS, or DID purchase/renewal deductions (click the linked Call ID to cross-reference the exact CDR).
Refund+ CreditReversed 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 MetricConsole SectionWhat It Controls
Concurrent CallsSettings → Limits & QuotasMaximum simultaneous active calls (inbound + outbound + Voice AI) across the workspace at any second.
Monthly Included Call MinutesSettings → BillingMonthly platform minute allowance before standard per-minute metering applies.
Voice AI AgentsVoice AgentsMaximum autonomous Voice AI assistants configured in the workspace.
Knowledge BasesKnowledge BasesMaximum RAG knowledge repositories (up to 100 documents per Knowledge Base).
Workspace StorageSettings → Limits & QuotasCombined storage pool for call recordings, uploaded IVR audio files, and Knowledge Base documents.
Call Center Agents & TeamsCall Center → Agents / TeamsMaximum human agent accounts (base seats + add-on seats) and department ring queues.
Extensions & SIP AccountsCall Center → Extensions / SIP AccountsMaximum internal dial extensions (101, 102, …) and hardware IP phone / softphone registrations.
Phone Numbers (DIDs)Phone NumbersMaximum active virtual DIDs and connected BYOC SIP trunk numbers.
Call Flows & Audio PromptsCall Flows / Audio FilesMaximum visual IVR routing graphs and studio prompt files.
SIP Trunk ACLs & GatewaysSIP TrunksMaximum custom Inbound IP ACLs and Outbound Carrier Gateways (system-managed Firetell DID routes do not consume your custom quota).
Workspace API KeysSettings → API KeysMaximum active REST API keys for server-to-server integrations.
Call Recording & RetentionCall Center → RecordingsControls external & internal call recording authorization and automatic retention period (days).
Audit Log RetentionSettings → Audit LogsNumber 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 Unavailable until an active call disconnects or you upgrade your plan's concurrency tier.