Create a notification channel to send health status requests using your company's preferred communication method, such as the Slack or Microsoft Teams collaboration platforms. Create the notification channel using a script or a subflow.

1. Navigate to Emergency Outreach > Channels.
2. Click New.

   

3. Enter the name of your notification channel.
   Use a short name that indicates the communication method to make it easy for the requester to pick the correct channel.
4. In the Subject field, enter the subject of your notification channel.
5. In the Body field, enter the body message.
6. Create a script notification channel.
   1. In the Notification type field, leave the default notification type of Script.
   2. In the Script field, replace the code in the comment with the script to connect to your channel.

      {
                  // sendNotification(responses.acknowledgementsGr.user.email, 
      channelGr.subject, channelGr.body);
              }

      For information about JavaScript APIs for GlideRecord, see GlideRecord - Scoped.
   3. Click Submit.

   The following example includes code to count the number of acknowledgements and survey instances generated when the notification is sent. It displays the number of acknowledgements and survey instances that succeeded. Use this information to review and handle errors that appear in the Delivery Log related list in the Outreach record.

   (function notify(responses, channelGr) {
       var record = responses.mode === 'acknowledgements' 
           ? responses.acknowledgementsGr 
           : responses.surveyInstancesGr;
       var totalCount = record.getRowCount();
       var numSent = 0;
       while (record.next()) {
           try {
               // sendNotification(record.user.email, channelGr.subject, channelGr.body)
               numSent += 1;
           } catch (err) {
               gs.error('Error occurred: ' + err.message);
           }
       }
       return { total_count: totalCount, sent_count: numSent };
   })(responses, channelGr);

7. Create a subflow notification channel.
   1. Create a subflow to use in the outreach notification.
      For information about creating, publishing, and testing subflows, see Subflows.

      Use the following inputs in the subflow that you create:

      • mode (string)
      • akcnowledgements (Records of sn_imt_checkin_check_in_acknowledgement)

        If the mode is acknowledgements, then acknowledgements are set to a valid GlideRecord and survey_instances is null.

      • survey_instances (Records of asmt_assessment_instance)

        If the mode is survey_instances, then survey_instances is set to a valid GlideRecord and acknowledgements is null.

      • channel (Reference of sn_imt_checkin_channels)

      The following outputs are optional:

      • total_count (integer)
      • sent_count (integer)

      To review these outputs, include the number of total acknowledgements or surveys versus the successful acknowledgements or surveys.

   2. Select the Subflow notification type.
      The Script section changes to Flow, and the Subflow reference field appears.
   3. Select the subflow that you created.
8. Click Submit.

When an outreach is sent using a custom notification channel, a Delivery Logs related list appears in the Outreach message.

1. Test the notification channel for an outreach message, and open the failed record to review the error message.
2. Fix errors that caused the notification to fail.
3. Continue testing the notification channel until it no longer fails.

(function notify(responses, channelGr) {
    var createClient = function () {
        var client = new sn_ws.RESTMessageV2();      
        client.setRequestHeader('Authorization', 'Bearer xoxb-222222222222-1111111111111-000000000000000000000000');
        client.setRequestHeader("Accept", "application/json");
        client.setRequestHeader('Content-type', 'application/json');
        return client;
    };

    var getEmailToSlackIdMap = function (users) {
        var emailToSlackIdMap = {};
        for (var i = 0; i < users.length; i++) {
            var email = users[i].profile.email;
            if (email) {
                emailToSlackIdMap[email] = users[i].id;
            }
        }
        return emailToSlackIdMap;
    };

    var runSlackCommand = function (method, params) {
        var client = createClient();
        client.setHttpMethod('post');
        client.setEndpoint('https://slack.com/api/' + method);
        client.setRequestBody(JSON.stringify(params));
        var response = client.execute();
        if (response.getStatusCode() < 200 || response.getStatusCode() > 299) {
            throw new Error('Failure running ' + method + ':\n' + response.getBody());
        }

        var body = JSON.parse(response.getBody());
        if (!body.ok) {
            throw new Error(body.error);
        }

        return body;
    };

    var sendMessage = function (userId, message) {
        var openConversationResponse = runSlackCommand('conversations.open', { users: userId });
        var channel = openConversationResponse.channel.id;
        runSlackCommand('chat.postMessage', { channel: channel, text: message });
    };

    var users = runSlackCommand('users.list').members;
    var emailToSlackIdMap = getEmailToSlackIdMap(users);
    var body = channelGr.getValue('body') || '<p></p>';
    var record = responses.mode === 'acknowledgements' ? responses.acknowledgementsGr : responses.surveyInstancesGr;
    var numSent = 0;

    while (record.next()) {
        var email = record.user.email + '';

        var link = responses.mode === 'acknowledgements'
            ? gs.getProperty('glide.servlet.uri') + record.getLink(true)
            : gs.getProperty('glide.servlet.uri') + 'sp?id=take_survey&instance_id=' + record.getUniqueValue();

        var message = body + '\n' + link;

        var slackId = emailToSlackIdMap[email];
        if (slackId) {
            sendMessage(slackId, message);
            numSent += 1;
        }
    }

    return { sent_count: numSent };
})(responses, channelGr);