Appearance
Module 9 · Protect your numbers
Leer en español: Módulo 9 · Cuida tus números.
Goal: understand your Caller ID inventory (the DIDs you dial from), read the health of each number and know when to rotate one before the carrier labels it as spam. Time: ~6 minutes · You need: to have signed in to the dashboard (Module 1) and at least one registered DID.
1. You bring the numbers; we look after them
In the BYOC model you provide the carrier and the numbers (DIDs). The platform registers, monitors and rotates them out of the pool when needed. Open Caller ID & DIDs in the side menu: your inventory lives there, sorted by number.
Each DID carries:
e164— the number in international format (+13125550184). It is immutable: a different number is a different DID. Call history is never re-attributed.- Status —
active(in rotation),quarantine(you pulled it from the pool on suspicion of spam) orretired. - Attestation — the STIR/SHAKEN level (
A/B/C) that your carrier signs for that number. You read it here; you do not type it: only the platform sets it. - Ownership verification — whether the platform has confirmed the number is yours. A number you register starts as «Not verified — self-declared number»; the platform verifies it and the console then shows the date and the method.
A number that is not verified
Depending on your account's setting, an unverified number keeps working (the platform only watches it) or is refused: a campaign does not dial from it, an SMS from it fails with did_unverified, and the campaign shows it cannot send because its numbers are unverified. Ask support to verify the number.
Numbers are not deleted, they are retired
When you "delete" a DID you are actually retiring it (retired). The rows never leave the record: the from_number of your old calls has to keep resolving for the Litigation Defense Packet (Module 4). A retired number stops dialing, but its evidence survives.
2. Read a number's health
Each DID has a health view calculated from the live call record (the last 30 UTC days by default) — it is not purchased data, it is your own operation:
- Dials — how many times you dialed from that number.
- Answer rate — the answer rate.
- Short-call rate — of the answered calls, how many ended in less than 15 seconds. This is the strongest signal we have on the CDR side that a number smells like spam: the debtor answers, sees the "Spam Likely" label on their screen, and hangs up immediately.
When the denominator is zero, we say "—", not "0%"
If a number has no answered calls yet, the rate is shown empty, never invented. A curve needs at least two days of data to be drawn. We do not fake signal.
3. External reputation: honest about what is missing
The health view reserves a space for the spam score from external feeds (Hiya, TNS and similar). Today that field appears as "pending feed", as null — because we have not integrated a reputation provider yet. When we do, you will see the score there; in the meantime, we do not invent a number.
Your best signal today is the one you already have: the short-call rate from your own CDR.
If a campaign is not dialing because of its numbers
When a campaign's number group has no active number, the numbers are not verified, or they reached the daily use limit, the campaign's row says so in one sentence with a link to the DID registry. The table of causes is in Module 5.
4. The ritual: when to rotate
- Review health weekly, or when a campaign's connect rate drops.
- If a number's short-call rate goes up (debtors who hang up within seconds), put it in quarantine: it leaves the rotation pool immediately — re-resolved on every dialing tick, fail-closed.
- Register fresh numbers to keep the pool healthy. Each plan includes a quota of monitored DIDs (1 / 2 / 3 / 5 depending on your tier — see Module 7); above the quota it is charged per pack.
What you learned
- Your DID inventory: status, attestation (read-only), ownership verification and why the
e164is immutable. - Reading health — and why the short-call rate is your spam alarm.
- That external reputation is pending and is not faked.
- When to put a number in quarantine and how it relates to your plan quota.
Continue with Module 10 — Take calls to decide where a call to your numbers goes.