Support and Documentation


With the Twilio plugin, you can receive Brightspot notifications to phone via text (SMS) messages.

Developers perform this task.

. See also:

Step 1: Acquire SMS API credentials

This section provides the basic steps to acquire an SMS API key from Twilio. Acquiring API credentials for other messaging services is similar.

  1. In your browser, go to and click Get a free API key.

  2. In the Sign up for free page, enter your account information and then click Get Started.

  3. In the verification page, enter your phone number and click Verify via SMS.

  4. In the following response page, enter the verification code you received from Twilio and click Submit.

  5. Fill out any subsequent forms until you get to the dashboard.

  6. In the dashboard's upper-right corner, click Show API Credentials.

  7. Copy the values for ACCOUNT SID and AUTH TOKEN into a text editor.

Step 2: Provision originating numbers

In this step, you provision phone numbers from which Twilio can send text messages.

Procedure. To provision originating numbers:
  1. Navigate to the Twilio dashboard, and click Manage Numbers. The Phone Numbers Dashboard appears.

  2. Click Get Started, and in the next page click Get your first Twilio phone number. A widget appears.


    Referring to the previous illustration, the Twilio phone number is (202) 816-4833.

  3. Click Choose this Number. A confirmation widget appears.

  4. Copy the phone number into a text editor. Referring to the previous illustration, the phone number you copy is +12028164833.

Step 3: Configure Dari for text messaging

In this step, you configure Dari to send text messages using the API credentials you acquired in Step 1: Acquire SMS API credentials and the phone number you acquired in Step 2: Provision originating numbers.

Procedure. To configure Dari for text messaging:
  1. In a text editor, open the Tomcat configuration file conf/context.xml.

  2. Add the following lines:

    <!-- SMS -->
    <Environment name="dari/defaultSmsProvider" type="java.lang.String" value="twilio" /> 1
    <Environment name="dari/smsProvider/twilio/class" type="java.lang.String" value="notifications.TwilioSmsProvider" /> 2
    <Environment name="dari/smsProvider/twilio/accountSid" type="java.lang.String" value="putYourAccountIDHere" /> 3
    <Environment name="dari/smsProvider/twilio/authToken" type="java.lang.String" value="putYourAuthTokenHere" />
    <Environment name="dari/smsProvider/twilio/defaultFromNumber" type="java.lang.String" value="+12028164833" /> 4
  3. Save and close the configuration file.

  4. Restart the Tomcat server.


Specifies the default text messaging configuration as twilio.


Specifies the fully qualified class name implementing the text messaging service.


Values for the API's account ID and token that you acquired in Step 1: Acquire SMS API credentials.


Specifies the 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, and is the same one you created in Step 2: Provision originating numbers.

Step 4: Configure text-message delivery

In this step, you configure Brightspot to send text messages through Twilio. The following illustration is an example of a typical text message. Contact your Brightspot representative to customize the message's wording for your organization's needs.

If your version of Brightspot is missing this feature, contact your Brightspot representative.​

Procedure. To configure text-message delivery:
  1. In the header, click your username. The Profile panel appears.

  2. Toward the right of the widget, select |mi-more_horiz| > Notifications. A widget appears.

  3. Under Delivery Options, click Add Text (SMS). A form appears.

  4. In the Phone Number field, enter your phone number. (You can configure a default phone number for all text delivery options; for details, see Configuring your profile.)

  5. Click Save.

  6. Re-open the profile settings: in the header, click Profile.

  7. Toward the right of the widget, select |mi-more_horiz| > Notifications. A widget appears.

  8. Under Delivery Options, check for a message that the delivery option needs to be verified.

  9. Click Click here to confirm. Brightspot sends a confirmation message to your phone.

  10. In your phone's messaging app, check for a message from Brightspot that includes a verification code.

  11. In the Code field, enter the verification code.

  12. Click Submit.