Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NOTE: The major phone carriers around the globe impose limits upon the frequency of SMS transmission. They do this to prevent SMS spam & to provide a consistent service. The carriers use equipment that has limitations; there’s no getting around this. When these limits are exceeded, the carrier will “filter” out the excess SMS traffic, and those messages will simply be discarded: lost. You’ll commonly see these filtering events occur in batches.

...

Navigate to Twilio at: https://www.twilio.com/

...

Create your Twilio account.

NOTE: The designed use case for SMS messaging within CAS is for Identity Verification and Opt-in Notifications (“2FA”). We encourage you to obey these strict limitations.

Provide a valid email & phone number, and the following options:

...

Locate your keys:

...

  • Both the “ACCOUNT SID” and “AUTH TOKEN” are required.

...

Buy a phone number.

...

  • In this example, the cost is only $1/month.

  • Make sure it is SMS & Voice capable (MMS, Fax not required).

  • Per Twilio: “Toll-free verification required for US messaging. US Toll-Free numbers will not be able to send messages until the verification has been approved.

  • Information about Twilio Toll-free verification

...

Assemble the required parameters:

Using a colon “:” between all 3 parameters, place them in this specific order:

...

  • Copy & paste the entire parameter string in one paste operation.

    • CAS fields doesn’t append previous entries.

...

Navigate to CAS: Organization: SMS Provider

...

Enter the parameters from the previous step:

...

Save it.

...

Return to the setting, and test it.

...

  • You’ll be asked for a receiving phone number.

  • The number should be in international format, e.g. +420296399328

  • For trial accounts (only), the number must be pre-verified in your Twilio settings.

...

If everything went as planned, you should see:

...

Troubleshooting

From the bash BASH console, you can test your Twilio settings to ensure that:

  1. the settings that you are entering are correct, and

  2. the Twilio service is working as expected, and

  3. your Twilio account is working as expected.

First, collect this information and set these from your Twilio settings:

...

Code Block
curl "https://api.twilio.com/2010-04-01/Accounts/$sid/Messages.json" -X POST --data-urlencode "To=$test_number" --data-urlencode "From=$from_phone_number" --data-urlencode 'Body=Hello from GB' -u $sid:$token

This an example result:

...

  • The test_number should receive the SMS if everything is working, active, and you have the correct settings. Any issue on the Twilio side will cause this to fail, resulting in an “ERROR”.

  • You should test this first when it doesn’t work in CAS. Twilio failures within CAS are extremely unlikely after they are properly setup. The more likely issue is a problem at Twilio.