Integrating a text messaging service

Some editors may want to receive notifications via text messaging. This section describes integrating Twilio as the text messaging service. Integration for other services is similar.

To integrate a text messaging service:

1. Log in to your Twilio console, and select the account from which you want to send text messages. The account's dashboard appears.

2. Under Account Info, copy the values for Account SID and Auth Token into a text editor.

   

3. In a text editor, open the Tomcat configuration file context.xml.

4. Add lines similar to the following:

   <!-- SMS -->
   <Environment name="dari/defaultSmsProvider" type="java.lang.String" value="twilio" /> 
   <Environment name="dari/smsProvider/twilio/class" type="java.lang.String" value="notifications.TwilioSmsProvider" /> 
   <Environment name="dari/smsProvider/twilio/accountSid" type="java.lang.String" value="putYourAccountIDHere" /> 
   <Environment name="dari/smsProvider/twilio/authToken" type="java.lang.String" value="putYourAuthTokenHere" />
   <Environment name="dari/smsProvider/twilio/defaultFromNumber" type="java.lang.String" value="+12028164833" /> 

   • Specifies the default text messaging configuration as twilio. This configuration appears by default in the Sms Provider Setting Key field in step 8.
   • Specifies the fully qualified class name implementing the text messaging service.
   • Value for the account ID that you copied in step 2.
   • Value for the authentication token that you copied in step 2.
   • Default from number that appears in the recipient’s text message. This number must be one that the SMS service recognizes as authorized to send text messages.

5. Save and close the configuration file.
6. Restart the Tomcat server.
7. In Brightspot, click menu> Admin > Sites & Settings > Sites > Global. The Edit Global widget appears.

8. Under CMS > Notifications > SMS Settings, do the following:

   1. In the Default From Phone Number field, enter what appears as the "from" number in text messages.
   2. In the Sms Provider Setting Key field, keep the default configuration (twilio as in the above snippet), or enter one of the other configurations.
9. Click Save.