Skip to content

SMS Setup

Mythradon uses the Twilio SMS Gateway to send SMS messages. In order to send SMS messages from Mythradon your system administrator needs to setup the following:

Twilio Account Setup

  • Navigate to Twilio
  • If you already have a Twilio account, click the Log In button else click the Sign Up link

Twilio Account Sign Up

Complete the account sign up details.

Once you are logged into your Twilio Account. You will need to obtain the following:

When you log into your Twilio account, you will presented with a list of Accounts. Unless you are familiar with Twilio and use their services for other applications you will usually only have one account. Select the Account to access the Account Console.

SMS From Number

The SMS From Number is a phone number provided by Twilio that SMS messages will be sent from. In other words, when someone receives an SMS from your Mythradon system, this is the 'From' phone number that will be listed on their phone.

To obtain the SMS From Number:

  • Select Phone Numbers → Manage → Active Numbers from the left side bar menu.

The following image shows how to get your SMS From Number.

Twilio Active Numbers

Note that sometimes the Twilio Console does not have items pinned to the left side bar. If that is the situation you need to perform the following steps to obtain your SMS From Number:

  • Click the Explore Products link as shown in the following image.

Twilio Explore Products

  • Scroll down the list of Twilio Products until you locate the Phone Numbers product

Twilio Phone Number Product

  • Click the Phone Numbers product to display the list of Active Numbers in your account

Twilio Active Phone Numbers

  • Click on the listed phone number to view the details

Twilio Active Phone Number Detail

Account SID

SID stands for String Identifier. It's a unique key that is used to identify specific resources. At Twilio, each SID has 34 digits.

At the time of writing this document there were a few different ways of obtaining the Twilio Account SID. It is usually displayed on the main page once you log into your Twilio account.

Twilio Account SID

If you are on the Twilio console you can click the home link in the top left corner of the Twilio console to return to the list of accounts.

Note

For security reasons the Twilio Account SID used in this documentation is not a valid Twilio Account SID.

Auth Token

An Auth Token is used by Twilio to authenticate API requests.

To obtain the Twilio Auth Token.

  • Select API Keys & Tokens from the Account menu option in the top right of the Twilio console

Twilio API Key

From the API Key & Tokens page you will see two sets of credentials. Live Credentials and Test Credentials.

Click the eye symbol at the bottom of the Live Credentials section to show your Auth Token.

Twilio Auth Token

Setup Twilio Integration

Mythradon needs to know the Twilio Account SID and Auth Token in order for API calls to be authenticated by Twilio.

  • Select Administration → Integrations → Twilio from the Menu Button
  • Click the Enabled checkbox
  • Enter the Account SID and the Auth Token
  • Click the Save button

Twilio Integration Settings - Light Twilio Integration Settings - Dark

Note

It is important that you treat the Account SID and Auth Token as sensitive information to protect your account.

Setup SMS Gateway

To setup the Mythradon SMS Gateway:

  • Select Administration → SMS from the Menu Button
  • Select Twilio from the SMS Provider list
  • Enter your Twilio SMS From Number (Note remove any spaces from the SMS From Number)
  • Click the Save button

SMS Account Settings - Light SMS Account Settings - Dark

Send Test messages

You can utilise the Formula Sandbox to send test SMS messages:

  • Navigate to Administration → Formula Sandbox using the Menu Button.
  • Copy and paste the following code into the Formula Sandbox, adjusting as necessary.
  • Press the Run button to execute the code.
ext\sms\send()
$smsId = record\create(
    'Sms',
    'fromName', 'Mythradon',
    'to', '+1000111222',
    'body', 'This is a test from Mythradon.'
);

ext\sms\send($smsId);

See also