Help for owners
Our text messages through Twilio are not being delivered
Short answer
Twilio gives every message a status. Failed means it never sent. Undelivered means it was sent but a delivery receipt said it did not arrive. Twilio names carrier filtering and handset availability as common causes. Read the error code on the message, because it says which one you have.
Does this sound like your situation?
- Customers say they never got the code or reminder.
- The Twilio log shows undelivered or failed next to the message.
- It works to my own phone and fails to others.
- Messages were fine, then dropped after a certain date.
- Only some mobile networks or countries fail.
Why does this happen?
Failed and undelivered are different problems
Twilio defines failed as a message that never sent, with causes such as queue overflows, account suspensions and media errors. Undelivered means Twilio received a delivery receipt saying it did not arrive, and carrier content filtering and handset availability are common causes.
Confirmed by twilio.com
A filter blocked the message
For error 30007, Twilio says its own filter flagged the message as spam or unwanted, or a wireless carrier blocked it for breaking carrier rules in that country or network. If the traffic follows the policy, Twilio asks for at least three message SIDs showing undelivered with 30007 before contacting support.
Confirmed by twilio.com
US registration was never done
Twilio states that anyone sending messages from an application over a US 10DLC number to US recipients must register for A2P 10DLC, and that registration leads to lower filtering and higher throughput.
Confirmed by twilio.com
The handset cannot receive it
The phone is off, out of coverage or has the number blocked. Twilio lists handset availability among the common causes of undelivered.
Confirmed by twilio.com
Your own app never knew
Twilio sends a status update to your app whenever the status changes, but only if a status callback is set up. Without it, your system treats every send as fine.
Confirmed by twilio.com
What can I do about it today?
- Open the message log in TwilioFind a message that did not arrive. Write down its status, error code and date.
- Compare failed ones with delivered onesSame country? Same network? Same wording? A pattern is the fastest clue.
- Do not resend in a loopRepeating a message to an unreachable or filtered number adds cost and can increase filtering.
- Check the message textLinks shortened by third parties, urgent claims and unusual wording are common reasons a filter reacts. Show the text to whoever manages the account.
- Keep three examplesSave three message IDs with the same error. They are what Twilio support asks for.
When should I bring someone in?
- Codes or order updates are not arriving and customers cannot log in or pay.
- The error mentions registration, compliance or a filtered message.
- Your app does not record delivery status at all.
How do I handle it?
- Group failures by error codeI export the message log and count by status, error code, country and network, so the biggest cause shows first.
- Check registration and sender setupI check that the sender type and any required registration match where the messages go.
- Review wording and linksI read the templates for what filters react to and suggest plain, opt-in based wording.
- Record delivery in your systemA status callback stores the result per message, so the app knows what arrived and can offer another route.
- Add a fallback for critical messagesFor login codes or alerts, I describe a second channel such as email, so one blocked route is not the end.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Does delivered mean the person read it?
No. Delivered means Twilio got confirmation from the carrier and, where available, the handset. It does not mean it was read.
Why does the error code change?
Twilio notes it may change values as it improves error reporting, and advises not to rely on them in code. Use the status.
Do I need to register?
Twilio says it is required for application messages over a US 10DLC number to US recipients. Other countries and number types have other rules.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.