Quick Start
Getting Started
Learn the basics of using EzzySMS platform
Sending SMS
Everything about composing and sending messages
Contact Management
Manage your contacts and groups effectively
Billing & Credits
Manage your account balance and payments
Reports & Analytics
Track your SMS campaigns performance
API & Integration
Connect EzzySMS with your applications
SMS Delivery Status Codes
Understanding message delivery status codes helps you track and troubleshoot your SMS campaigns effectively.
Success Status Codes
Your message has been successfully processed by our system and is ready for delivery. This indicates that the message has passed all initial validation checks and has been accepted into our delivery queue.
Your message has been successfully sent to the recipient's mobile network operator. This confirms successful delivery to the carrier, though final delivery to the device may still be in progress.
Your message is currently in the delivery queue and will be sent shortly. This typically occurs during high-traffic periods or when sending to networks with delivery restrictions.
Client Error Status Codes (400s)
Your message has been placed on hold due to risk assessment protocols. This may occur with new accounts, unusual sending patterns, or content that requires additional verification.
The Sender ID you're using is not valid or approved for the destination country. Some countries require pre-registered Sender IDs or have specific formatting requirements.
The phone number format is incorrect or invalid. Ensure you're using the correct international format including country code (e.g., +25671234567).
The phone number type (landline, premium, etc.) is not supported for SMS delivery. Only standard mobile numbers can receive SMS messages.
Your account doesn't have enough credits to send this message. Please add credits to your account to continue sending SMS.
The recipient has previously opted out or is in your blacklist. Messages cannot be sent to blacklisted numbers for compliance reasons.
Unable to find a valid route to deliver the message to the specified destination. This may be due to network coverage issues or unsupported destination.
The message was rejected due to Do Not Disturb (DND) restrictions. The recipient has opted not to receive promotional messages during certain hours or altogether.
Server Error Status Codes (500s)
An unexpected error occurred on our servers while processing your message. This is typically a temporary issue that resolves automatically.
There was an error communicating with our SMS gateway. This could be due to temporary network issues or gateway maintenance.
The SMS gateway rejected your message. This could be due to content restrictions, spam filtering, or temporary gateway policies.
Best Practices for SMS Delivery
Phone Number Validation
Always use international format (+countrycode) and validate numbers before sending.
Optimal Timing
Send messages during business hours to avoid DND restrictions and improve delivery rates.
Content Guidelines
Follow content guidelines and avoid spam keywords to prevent gateway rejections.
Monitor Reports
Regularly check delivery reports to identify and resolve recurring issues quickly.
Frequently Asked Questions
You can start sending SMS with as little as 40 UGX in credits.
You can track message delivery through our Reports section in your dashboard. We provide real-time delivery receipts and detailed analytics for each campaign.
Yes! EzzySMS supports message scheduling. You can schedule individual messages or entire campaigns to be sent at specific dates and times in the future.
We support CSV, Excel (.xlsx), and TXT file formats for contact imports. Make sure your file includes proper headers like 'phone_number' and 'name' for best results.
Yes, we provide a comprehensive REST API with detailed documentation. You can integrate EzzySMS with your applications using our API endpoints for sending messages, managing contacts, and retrieving reports.