Phone Numbers and Communications Credits
SMS and IVR both need a real sending number. That number now lives on the same Communications Credits wallet as message and minute usage — one balance, three things it can pay for.
If your package prices monthly phone-number rent, Quali-Fi shows that rent on the number. If it does not, you can still purchase and use numbers; the purchase dialog will say monthly rent is not enabled.
Where to find it
Organization admins: Admin Settings → Telephony.
The page has two lists:
- Phone numbers — search inventory (country, optional area code, optional pattern) and Purchase
- Owned numbers — every number on the organization, with status, billing badge, monthly rent, next renewal, and Release
Communications Credits also appear on Admin Settings → Billing. Use Add there to top up the shared wallet.
Purchase a number
Open Admin Settings → Telephony.
Choose a country. Add an area code or pattern if you care about the digits.
Click Search numbers, then Purchase on the row you want.
Read the purchase dialog and confirm.
When monthly rent is on your package, the dialog is specific:
- Monthly rent at the current package price
- The purchase month is free
- First charge is the 1st of the next calendar month, in UTC, from Communications Credits
- You do not need a wallet balance to buy the number today
If a later renewal cannot be paid, outbound sending on that number pauses for 30 days, then the number is released. Inbound can keep working during that 30-day window.
Owned numbers and billing status
Each owned number shows a billing badge:
| Status | Meaning |
|---|---|
| Active | Number can send. Rent is current, or billing is not enabled on the package. |
| Outbound suspended | Renewal failed. This number cannot send SMS or place IVR calls until you top up and the renewal retries. |
| Pending release | The 30-day unpaid window ended, or you released it. Quali-Fi is returning it to the provider. |
| Release failed | Provider release did not finish. Try again, or contact Quali-Fi support. Do not assume the number is gone. |
Next renewal and Release deadline use UTC month boundaries, so the calendar day matches the billing day even if you are in the Americas.
Campaigns skip suspended numbers in a multi-number pool. If every selected number is suspended, the send cannot go out.
Release a number
Release on an owned Twilio number removes it from the organization and from the telephony provider. Inbound and outbound on that number stop.
You cannot undo this. Buying “the same” number later is not guaranteed.
Warning
Release is permanent. Confirm you are finished with STOP handling, inbound replies, and any live SMS or IVR campaigns that still list this number.
MFA / verified external caller IDs are not part of this rent lifecycle. Those stay under caller-ID setup for IVR.
Communications Credits wallet
SMS usage, IVR usage, and phone-number rent draw from one shared wallet.
Included SMS and IVR allowances stay as their own counters. Rent does not eat those included units.
Top up from Admin Settings → Billing → Communications Credits → Add. After a successful top-up, Quali-Fi retries unpaid renewals and can restore outbound on numbers that were only suspended for lack of funds.
Tips
- Buy numbers before you build the campaign, not on send day. Search results change.
- If outbound suddenly fails on one number and others still send, look at the billing badge before you rewrite the message.
- Numbers purchased outside Quali-Fi can send immediately. Inbound replies and STOP still need the SMS webhook pointed at Quali-Fi — ask your administrator if replies look dead.