Before you start
Create a BulkSMS API token
Log in to your BulkSMS account and go to Settings > Developers.
Click Create API Token and name it OrbisX Integration.
Copy the Token ID and Token Secret. The secret is only shown once.
Connect BulkSMS in OrbisX
In OrbisX, go to Settings > Admin Settings and search for BulkSMS.
Select BulkSMS as the Default Gateway.
Paste your Token ID and Token Secret.
Enter your BulkSMS Sender Identity: the number or Sender ID your messages come from. It's case-sensitive.
Under Test SMS Sending, enter your mobile number with its country code and click Send Test SMS.
Receive replies (optional)
In the OrbisX BulkSMS settings, copy the link under Incoming SMS Webhook.
In BulkSMS, go to Settings > Advanced > Webhooks and click Create Webhook:
| Field | Value |
|---|---|
| Trigger when | A received message arrives |
| Webhook URL | The OrbisX Incoming SMS Webhook link |
| Invoke with | Many messages (recommended) |
| Alert Email | An admin's email address, to be told if the webhook fails |
Tick Active and click Save.
Customers can only reply to messages sent from a phone number. Messages sent from a name (alphanumeric Sender ID) are one-way.
Troubleshooting
The test SMS fails: check the Token ID and Token Secret, that the Sender Identity matches exactly (including capitals), and that your account has credits.
Messages aren't delivered: look for them under Sent Messages in BulkSMS to see their status.
Replies don't appear in OrbisX: check the reply is in the BulkSMS Inbox, and that the webhook is active and uses the OrbisX link.
All setup and ready to go!
If you have any questions, please contact our support team. Include your account name and put OrbisX in the subject line, and we'll be happy to help.
See also the OrbisX BulkSMS page.