SMS Configuration Guide
Overview
CloudOnex Business Suite provides SMS functionality for sending notifications, alerts, and communications to customers. This guide covers SMS configuration, available drivers, and troubleshooting steps.
SMS Drivers Configuration
Nexmo (Vonage)
Prerequisites
- Active Nexmo/Vonage account
- API Key and Secret from Nexmo Dashboard
Configuration Steps
- Navigate to SMS → Settings
- Select "Nexmo" from the driver list
- Configure the following:
- Sender ID: Your company name (max 11 characters) or phone number
- API Key: Your Nexmo API key
- API Secret: Your Nexmo API secret
- Click "Save"
Twilio
Prerequisites
- Twilio account
- Account SID and Auth Token
- Verified Twilio phone number
Configuration Steps
- Go to SMS → Settings
- Select "Twilio" from the driver list
- Enter:
- SID: Your Twilio Account SID
- Token: Your Twilio Auth Token
- From Number: Your Twilio phone number
- Save configuration
Route SMS / Route Mobile
Prerequisites
- Route SMS account
- API credentials
Configuration Steps
- Access SMS → Settings
- Choose "Routesms" as the driver
- Enter the following details:
- HTTP API URL: Your Route SMS API endpoint
- Username: Route SMS username
- Password: Route SMS password
- Save settings
Infobip
Prerequisites
- Infobip account
- API credentials and endpoint
Configuration Steps
- Navigate to SMS → Settings
- Select "Infobip" from drivers
- Configure:
- HTTP API URL: Your Infobip endpoint (e.g., https://xyz.api.infobip.com)
- Username: Infobip username
- Password: Infobip password
- Save configuration
Custom SMS Gateway Integration
Configuration Format
- Select "Custom" as SMS driver
- Configure the HTTP endpoint:
API URL: https://gateway.example.com/send
- Set parameters using placeholders:
to={{to}},from={{from}},message={{message}},username=YourUsername,password=YourPassword
Parameter Guidelines
- Use double equals (==) for parameter assignment
- Separate parameters with commas
- Available placeholders:
- {{to}} - Recipient number
- {{from}} - Sender ID
- {{message}} - SMS content
Testing SMS Configuration
Test Message Steps
- Go to SMS → Settings
- Enter a test phone number
- Click "Send Test SMS"
- Check delivery status
- Verify SMS logs
Troubleshooting Test Messages
If test message fails:
- Verify API credentials
- Check phone number format
- Review error logs
- Confirm account balance
- Test API endpoint accessibility
SMS Features
Bulk SMS
Send messages to multiple recipients:
- Go to SMS → Bulk SMS
- Upload recipient list or select contacts
- Compose message
- Schedule or send immediately
- Monitor delivery status
SMS Templates
Create reusable message templates:
- Navigate to SMS → Templates
- Click "Add New Template"
- Enter template name
- Compose message with variables
- Save template