Skip to content

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) or retired.
  • 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 ​

  1. Review health weekly, or when a campaign's connect rate drops.
  2. 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.
  3. 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 e164 is 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.

Nothing in these docs is legal advice — always confirm compliance posture with your own counsel.