SMS Troubleshooting
Table of Contents
Prerequisites Understanding SMS Delivery Challenges Common SMS Delivery Roadblocks Carrier-Related Obstacles Platform Configuration Issues Comprehensive Troubleshooting Strategy Diagnostic Checklist Diagnostic Testing Error Code Quick Reference Best Practices for Reliable SMS DeliveryPrerequisites
- SMS is an add-on service and must be enabled for the user.
- Enabling SMS after the service has been added, in the Advanced UC Softphone, in the Hosted PBX and UC Hospitality Portal, must be done by a user with Office Manager or higher credentials.
- Enabling SMS for Microsoft Teams after the SMS service has been added requires Reseller Access to the Microsoft Teams Phone Connector portal, and the Microsoft Global Admins' approval of the deployment of the Teams SMS App as a tab in Microsoft Teams.
SMS messaging is a critical communication tool for businesses, but delivery failures can disrupt communication and create significant frustration. Whether you're using a hosted PBX for your business or hotel, Microsoft Teams Phone Connector, or the UC Advanced softphone app, understanding the complex landscape of SMS delivery is essential for maintaining seamless communication.
Helpful Articles:
Hosted PBX: SMS For Call Queues
Microsoft Teams Phone Connector: SMS Articles
Advanced UC Softphone: Troubleshooting
UC Hospitality: UC Hospitality Portal - Inventory Section
Understanding SMS Delivery Challenges
SMS transmission involves a complex journey from sender to recipient, with multiple potential points of failure. The delivery process typically encompasses five key stages:
- User Input: Initial message creation
- System Authentication: Verifying sender credentials
- SMS Routing: Carrier gateway transmission
- Delivery Confirmation: Response tracking
- Reporting: Logging message status
Common SMS Delivery Roadblocks
Carrier-Related Obstacles
- Spam filtering and blocked keywords
- Unregistered DIDs (Direct Inward Dialling)
- Carrier rate limiting
- Incorrect SMS routing configurations
Platform Configuration Issues
- Unmapped carrier trunks
- Unlinked sender DIDs
- Expired or mismatched authentication tokens
Comprehensive Troubleshooting Strategy
Diagnostic Checklist
- Verify SMS capabilities on your DID. SMS is an add-on service that requires the user to have SMS provisioned.
- Confirm user SMS provisioning
- Ensure app registration and login
Diagnostic Testing
- Send test messages to known working numbers
- Test internal user messaging
- Review call detail records (CDRs)
- Temporarily disable network proxies
Error Code Quick Reference
| Error Code | Meaning |
|---|---|
| 30003 | Unreachable destination handset |
| 30006 | Carrier message rejection |
| 21610 | Recipient unsubscribed |
Best Practices for Reliable SMS Delivery
- Ensure that the number has SMS enabled
- Use E.164 number formatting
- Enable verbose logging during setup
- Test on multiple network types
- Document working configurations
- Keep software and firmware updated
Persistent issues often require deeper technical investigation. Please don't hesitate to contact support if you need assistance.