SMS Settings
The SMS Settings page configures the SMS gateway that Supracontrol uses to send text message notifications to users and custom phone numbers.
Path: Settings → SMS (under System Settings)
SMS service mode
| Option | Description |
|---|---|
| Disabled | SMS delivery is turned off. No SMS messages will be sent regardless of notification settings |
| Supracontrol Service | Use the managed SMS service provided by Supracontrol (available on qualifying deployments). No custom configuration required |
| Custom | Configure your own SMS provider credentials. Use this to connect Supracontrol to a third-party SMS gateway |
Custom SMS fields
These fields appear when the service mode is set to Custom. Supracontrol uses a Twilio-compatible API for custom SMS delivery.
| Field | Required | Description |
|---|---|---|
| Account SID | Yes | Your SMS provider Account SID (unique identifier for your account). For Twilio, this is found in your Twilio Console dashboard |
| Auth Token | Yes | The authentication token for your SMS provider account. Treat this like a password - keep it secure |
| Sender Phone | Yes | The phone number in international format (e.g. +12025551234) or alphanumeric sender ID that will appear as the sender on outgoing SMS messages. Must be a number provisioned in your SMS provider account |
Testing the configuration
After filling in your custom credentials:
Click Test
Click the Test button. A dialog opens asking for a test phone number.
Enter a number and confirm
Enter a valid mobile number in international format (e.g. +385912345678) and confirm. Supracontrol will attempt to send a test SMS to that number.
Check the phone
Check the phone for the test message to confirm delivery.
Saving the configuration
Click the Save button to apply the settings. The Save button is disabled when no changes have been made.
Notes on sender IDs
- International format phone numbers (e.g.
+12025551234) work globally - Alphanumeric sender IDs (e.g.
SupraAlert) are supported in many countries but not all - check your SMS provider’s documentation for supported regions - Some countries (notably the USA) do not support alphanumeric sender IDs - use a numeric phone number for those recipients
Troubleshooting
| Problem | Likely cause | Solution |
|---|---|---|
| Test SMS not received | Incorrect credentials | Verify the Account SID and Auth Token in your provider’s dashboard |
| Invalid phone number error | Wrong format | Ensure the sender and test numbers are in full international format (+ followed by country code) |
| Messages sent but not received | Number not verified | For trial accounts (e.g. Twilio trial), you may need to verify recipient numbers in the provider dashboard |
| Provider not connecting | Network/firewall | Ensure the Supracontrol server can reach the SMS provider API endpoint |