Phone number problems
About a 2-minute read.
If attaching a number to a campaign didn't work, it's almost always one of a handful of situations. Most come from the carrier provisioning system, not from AgentMessage.
The campaign isn't fully approved yet
By far the most common one. You're attaching a number to a campaign that's been filed but isn't fully approved across the carriers. Standard use cases usually approve together; carrier-reviewed use cases approve one carrier at a time.
Fix: wait until the campaign shows fully approved, then attach. Retrying every few hours is harmless. For carrier-reviewed use cases, full approval can take days to weeks.
The number is already on another campaign
A number can be attached to only one campaign at a time.
Fix: detach it from its current campaign first, then attach it to the new one. See Attach phone numbers.
The number can't carry 10DLC traffic
A few number types aren't eligible:
- Non-US numbers, 10DLC is US-only.
- Toll-free numbers, these use a separate verification process, not 10DLC.
- Short codes, separate registration program.
Fix: use a standard US 10-digit number from your account.
A transient carrier delay
Sometimes the carrier provisioning system is briefly unavailable or still propagating a fresh assignment. Symptoms: an attach that should work fails momentarily, or a message sent immediately after attaching doesn't deliver.
Fix: wait a few minutes and retry. Most assignments take effect within minutes, but carrier registries can take longer to fully sync. If it's still failing after a couple of hours, it's not transient, open a ticket.
The brand or campaign is suspended
If a carrier has suspended the brand or campaign, you can't attach numbers to it.
Fix: see Suspensions.
Anything else
Provisioning errors occasionally have causes that aren't in the list above. If you hit one, contact support with:
- a screenshot of the exact error,
- the phone number and campaign you were attaching,
- the time it happened.
We can look up the specific provisioning attempt on the carrier side and tell you what happened. (We'd rather you send us the real error than try to decode a carrier error code yourself, the codes shift, and we have the underlying record.)