School Messenger Integration

Configure Revolution to send notifications to Intrado School Messenger to trigger existing or custom Broadcasts.

This integration allows you to use on-premesis events to trigger the School Messenger broadcast system to send SMS, email, or phone messages to your contact lists.

Note: It is assumed that you have a School Messenger instance in place with Broadcasts and Lists already created and the environment settings set up as needed.

This token enables communication between Revolution and School Messenger.

  1. Go to Configuration > Integrations > Token.

  2. Select New.

    1. For Name, provide a name to make this token easily recognizable.

    2. For Available in All Sites, enable to allow use of the authorization token for all your sites or disable to specify a specific Site. If your permissions are limited to single site, Revolution automatically assigns this to your site.

    3. For Token Type, select School Messenger.

    4. For Account Name, enter the name used for your School Messenger instance. You can find this in the address of School Messenger. For example:

      https://asp.schoolmessenger.com/accountname/

    5. For Username, enter the login for a user in your School Messenger instance. School Messenger Broadcasts will show this login as the submitter.

      Ensure the broadcasts and lists are visible to this user.

    6. For Country, select the value associated with your School Messenger account. If you select the wrong value, you will not be able to load targets or send broadcasts.

    7. Select Save.

This webhook service automates the creation of an endpoint for School Messenger. You will use this endpoint when editing or creating notifications.

When creating this service, you can link it to an existing School Messenger Broadcast or create your own Broadcast for this service.

  1. Go to Configuration > Integrations >School Messenger.

  2. Select New > New School Messenger Service.

    1. For Name, provide a name to make this service easily recognizable.

    2. For Token, select the School Messenger token you created. See Creating a School Messenger Token. Revolution will open a connection to School Messenger and retrieve information from your instance.

    3. Identify a Broadcast, either by selecting an existing one or creating a new one.

      • Selecting an Existing Broadcast:

        1. Enable Use Existing Broadcast.

        2. For Broadcast, select one of your pre-made broadcasts from the list. This list is populated based on the Token you selected and is specific to the user you identified. 

          This list is based on the entries in School Messenger in the My Repeating Broadcasts pane of the Broadcasts > Broadcasts tab.

        3. Select Save.

      • Creating a new Broadcast:

        Note: To use this method, you must be familiar with the process for creating Broadcasts in School Messenger. Refer to your School Messenger documentation for detailed information.

        1. Disable Use Existing Broadcast.

        2. For Type, select one of the options from the drop-down list.

          This list matches the Type/Category field for School Messenger Broadcasts.

        3. For the Settings group, define the behavior of the broadcast. Each field provides a brief description of the setting.

          These fields match fields from the School Messenger Broadcast creation page.

        4. For the Message group, define who should receive the broadcast and how the message should be delivered.

          Note: Message trimming is based on your School Messenger settings.

          • Recipient Lists — You can select one or more options.

            Note: Revolution only supports School Messenger broadcasts in English.

          • Send SMS — The message will include the Revolution Title and Body fields from the Notification

          • Send Phone Call — The call will include audio based on your selection.

            For Forward Notification Audio, it will send the audio file attached to the Revolution notification. If more than one audio file is attached, only the first file will be sent.

            For Send Content as Text-to-speech, it will send the Revolution Title and Body fields as TTS.

          • Send Email — The email will show the Revolution Title as the email subject and the Body as the email body.

            For From Email, the address must belong to the domain used with your School Messenger instance, as shown in Admin > Settings > Customer Settings > Email Domain.

    4. Select Save.

After creating the School Messenger Service, Revolution creates an endpoint for the service. You can view it in the Configuration > Endpoints page by searching for "schoolmessenger".

You are now ready to include the service endpoint to your notifications that you want to initiate broadcasts in School Messenger.

Create a new or edit an existing notification.

  1. General: Define information about the notification.

  2. Select Triggers: Select what activates the notification.

  3. Message Details: Define the content sent to endpoints. School Messenger will use the Title and Body from the Notification as content in the SMS message, email, or phone call.

  4. Actions: Configure any Revolution responses or actions to this notification.

  5. Endpoint & Contact Selection:

    1. Select the Endpoints tab.

    2. Search for and select the created endpoints.

      You can search for the Name you assigned to your School Messenger Service.

      Alternatively, you can find the endpoint in System Tags > Category > Webhook.

  6. Select Save.

Whenever any of the selected triggers are activated, Revolution will send this notification to your endpoints and contacts, including School Messenger.

When your Revolution Notifications are activated and sent to School Messenger, you can review the resulting broadcasts in your School Messenger interface.

  • You can see those triggered by your account In the Broadcasts > Broadcasts page under My Completed Broadcasts.

  • If you are an Admin, you can see those triggered by yours and any other accounts in the System > Completed Broadcasts page.

In either location, Revolution-based broadcasts show the following information:

  • Submitted by — Shows the user associated with the token used to send the broadcast.

  • Broadcast Name — If the School Messenger Service was created to use an existing broadcast, you will see that name and the date and time stamp. If the Service was created using a customized broadcast, the Name will be "Revolution Broadcast" followed by the date and time stamp.

  • Other Data — Follows the standard School Messenger behavior.