Number Pool Management
Provision, assign, recycle. Your numbers, automated. Your account, protected.
What is Number Pool Management?
A number pool is the shared inventory of tracking phone numbers a pay-per-call platform assigns to website visitors and campaigns. Pool management handles the full lifecycle — provisioning new numbers from a telephony provider, assigning them atomically so two visitors never collide on the same number, releasing them after a cooldown period, and blocking numbers whose provisioning failed so a caller never rings a dead line.
Key Capabilities
- One-click provisioning from the telephony provider: specify an optional 3-digit area code (e.g., 212 for New York) and a number is purchased and added to your pool instantly
- Provisioning health tracking: every number's actual provisioning state is tracked separately from internal lifecycle — unknown, pending, active, purchase_failed, port_pending. Toll-free numbers with async ordering are polled automatically after purchase
- Background health check (every 5 minutes): reconciles pending and active numbers against the telephony provider. Auto-activates confirmed numbers, auto-deactivates numbers that failed provisioning. Orphan detection (hourly) flags numbers on the provider not in your database
- Hard-blocks prevent live-campaign disasters: numbers with non-active provisioning are blocked from pool/campaign assignment, from being activated, and from DNI assignment at runtime. Release and deactivation blocked for numbers assigned to any campaign or pool
- Release vs Delete — two-step safety: release is a soft operation (detach from entities, set inactive) that keeps the number in the system. Delete permanently removes from both the provider and database
- Four-status lifecycle: Available, Assigned, Cooldown, and Disabled — with provisioning status badges (green/yellow/red) in the numbers table
- Atomic number assignment using PostgreSQL row-level locking (SELECT FOR UPDATE SKIP LOCKED) to prevent double-assignment when multiple calls arrive simultaneously
- Automatic session expiry and number recycling: stale visitor sessions are batch-expired, and numbers return to the pool after a configurable cooldown period
Key Benefit
Never run out of tracking numbers, never double-assign them, and never route a live campaign through a broken number. The pool manages itself — and if a number fails provisioning on the provider, the system catches it before a caller ever rings dead air.
Real-World Use Case
TV Commercial Traffic Spike
A campaign receives a traffic spike from a TV commercial. 200 visitors hit the landing page in 60 seconds. The DNI system assigns tracking numbers from the pool atomically — no collisions, no double-assignments. As visitors leave and sessions expire, numbers cool down for 5 minutes and then return to the available pool for the next wave.
Frequently Asked Questions
Stop Leaving Revenue on the Table
Join hundreds of businesses who switched to CallMatrix and cut their call routing costs by 40%.