First steps — quick diagnostic checklist
Before diving into specific issues, check these common causes first:Quick-reference issue table
Message status definitions
“Undelivered” vs “Failed”
Error code reference
Common delivery error codes
Registration and compliance error codes
T-Mobile specific filtering
T-Mobile is the most aggressive carrier for content filtering. Common T-Mobile blocks:Common delivery issues
Messages not sending at all
Verify the phone number is active
Check A2P registration status
Check SMS credits / account balance
Check the error code
Verify the recipient's number
Check for DND/opt-out
Messages marked as delivered but not received
A “Delivered” status means the carrier accepted the message — but the recipient may still not see it.Messages going to spam on carrier networks
Even successfully delivered messages can be silently filtered:Contact replied STOP but wants messages again
When a contact replies STOP, they are automatically added to the DND list. To resubscribe:- The contact can text START, YES, or UNSTOP to your number
- Or you can manually remove the DND flag from their contact record under Contact > DND Settings > uncheck SMS
Character limits and message segments
GSM-7 vs Unicode encoding
SMS messages are sent in segments. The character limit per segment depends on the encoding:Characters that trigger Unicode encoding
How segments are counted
MMS file limits and supported formats
Delivery receipts and read receipts
DLR limitations
- Delivery receipts confirm the message reached the carrier network, not necessarily the recipient’s device
- Some carriers do not return delivery receipts (message shows as “Sent” indefinitely)
- Pre-paid phone plans may not support DLR
- International messages have less reliable DLR
Number suspended or flagged
What triggers suspension
- Multiple spam complaints from recipients
- Sending to a high percentage of invalid numbers
- Violating carrier content policies (SHAFT content, debt collection without consent, etc.)
- Failing to honor opt-out requests
- Billing delinquency
Number status indicators
How to request reinstatement
Identify the violation
Fix the root cause
Submit a reinstatement request
International SMS issues
Sender ID requirements by region
Two-way SMS not working
If you can send messages but are not receiving inbound replies:Verify number capabilities
Check inbound message routing
Review webhook configuration
Check for conversation assignment
Test with a different carrier
Message queuing and delays
Messages may experience delays due to:How to test SMS delivery
Send to your own phone
Test across carriers
Test with links
Test with media
Verify opt-out flow
Escalating delivery issues to support
If you have exhausted the troubleshooting steps above, contact HoopAI support with the following information:Frequently asked questions
Why do my messages show 'Sent' but never 'Delivered'?
Why do my messages show 'Sent' but never 'Delivered'?
Why am I being charged for multiple segments?
Why am I being charged for multiple segments?
Can I send SMS to landline numbers?
Can I send SMS to landline numbers?
Why are my messages being filtered by T-Mobile?
Why are my messages being filtered by T-Mobile?
How do I know if my number is blocked?
How do I know if my number is blocked?
What is the difference between error 30003 and 30005?
What is the difference between error 30003 and 30005?
Can I send SMS without A2P 10DLC registration?
Can I send SMS without A2P 10DLC registration?
Why did my message cost 3x what I expected?
Why did my message cost 3x what I expected?
How long are messages queued before they expire?
How long are messages queued before they expire?
Can I recall or delete a sent message?
Can I recall or delete a sent message?
A contact says they did not reply STOP, but they are blocked. What do I do?
A contact says they did not reply STOP, but they are blocked. What do I do?
Why are my messages being sent from a different number than expected?
Why are my messages being sent from a different number than expected?