/
Configuring Action Bot Chat Notifications

Configuring Action Bot Chat Notifications

Owned by Mack Baczynski, created
Last updated: Sept 13, 2022
5 min read

Common chat tools such as Slack, Google Chat, or Microsoft Teams support the use of webhooks to generate automated messages to defined channels. This article describes how to configure Sharpen Action Bots to trigger useful messaging based on Sharpen data triggers.

Create the Action Bot

If you haven’t configured an Action Bot, please review Action Bots. This guide assumes familiarity with action bots.

  1. Login to Sharpen

  2. Navigate to Admin>Configuration>Logic & Actions

  3. Create a new action bot

  4. Configure the Trigger and Data Source(s) to fit the appropriate data and criteria for sending the notification

    1. (e.g. If I want to send a Slack message when a call enters “Support Q,” I will configure an “Event” trigger on the “Support Q” for the “Enter Q” event. I will select “Queue Call Manager Activity” as my data source, and will select Cid Number, Queue Call Manager ID, Queue Name, and Inbound Number as my fields)

    2. If additional assistance is needed with this step, please visit Action Bots.

  5. Configure the action per the next section below

Setup the Webhook & Create the Action (Messaging Notification)

This method will only work if your chat tool has an inbound webhook configured. Configuring these webhooks typically requires appropriate permissions to be set. If you do not see the options disclosed in this guide, please confirm the appropriate permissions are enabled for your user.

Slack

Configure the Webhook

  1. Navigate to your slack “custom integrations” configuration

    1. e.g. https://orgname.slack.com/apps/manage/custom-integrations

  2. Click on “Incoming Webhooks”

  3. Click the “Add to Slack” button

  4. Find the desired destination channel from the “Choose a channel…” drop down

  5. Click the “Add Incoming Webhooks Integration” button

  6. The slack channel will confirm the addition of the webhook as shown below

  7. Take note of the “Webhook URL” on the next screen

Configure the Action

  1. Continuing from step 5 of “Create the Action Bot” above, move onto the “Actions” section of the action bot.

  2. Click the + Add button at the top right of the “Actions” panel

  3. Search for url in the drop down and choose “URL” from the “ALERT” section

  4. Utilizing the URL copied from step 7 above, paste the full url into the URL field

  5. Set POST for the “Request Method”

  6. Enter 'Content-Type: application/json' for the “Header” field

  7. Enter the “JSON Params” in a JSON body compliant with what slack requires.
    e.g.

    { "channel": "#SupportTeam", "username": "Notification Bot", "text": "<!here> A call from %%queueCallManager__CidNumber%% to %%queueCallManager__InboundNumber%% has entered the %%queueCallManager__QueueName%% queue.", "icon_emoji":":smirk:" }

  8. Click the green “Save” button

  9. Your action bot is ready to go

Google Chat

Configure the Webhook

  1. Navigate to chat.google.com

  2. Identify the destination Space from the “Spaces” tree

  3. Click the drop down for the Space and choose “Manage webhooks”

  4. Name the Incoming webhook and save or identify an existing one

    1. An icon can be added via the “Avatar URL” field if necessary

  5. Click the clipboard button to copy the webhook url

Configure the Action

  1. Continuing from step 5 of “Create the Action Bot” above, move onto the “Actions” section of the action bot.

  2. Click the + Add button at the top right of the “Actions” panel

  3. Search for url in the drop down and choose “URL” from the “ALERT” section

  4. Utilizing the URL copied from step 5 above, paste the full url into the URL field

  5. Set POST for the “Request Method”

  6. Enter 'Content-Type': 'application/json; charset=UTF-8' for the "Header" field

  7. Enter the “JSON Params” in a JSON body compliant with what slack requires.
    e.g.

    { "text": "<!here> "A call from %%queueCallManager__CidNumber%% to %%queueCallManager__InboundNumber%% has entered the %%queueCallManager__QueueName%% queue.", }

  8. Click the green “Save” button

  9. Your action bot is ready to go

Microsoft Teams

Configure the Webhook

  1. Navigate to teams.microsoft.com

  2. Choose the channel appropriate channel which is the intended destination for notifications

     

  3. Find the ellipsis at the top right corner and choose “Connectors”

     

  4. Search for “Incoming Webhook” and click “Add”

     

  5. After adding the “Incoming Webhook” Click the “Configure” button

    1. If “Configure” doesn’t show, you may need to add “Incoming Webhook” to your team through the apps store

  6. Confirmation of your webhook being added will show similar to this

  7. Give your Incoming Webhook at name

  8. Upload an image if desired

  9. Click “Create”

  10. Take note of the webhook url

Configure the Action

  1. Continuing from step 5 of “Create the Action Bot” above, move onto the “Actions” section of the action bot.

  2. Click the + Add button at the top right of the “Actions” panel

  3. Search for url in the drop down and choose “URL” from the “ALERT” section

  4. Utilizing the URL copied from step 9 above, paste the full url into the URL field

  5. Set POST for the “Request Method”

  6. Enter Content-Type: application/json for the "Header" field

  7. Enter the “JSON Params” in a JSON body compliant with what slack requires.
    e.g.

    { "@type": "MessageCard", "@context": "http://schema.org/extensions", "themeColor": "0076D7", "summary": "New Q Call", "sections": [{ "activityTitle": "A call has entered the Q", "activitySubtitle": "A call from %%queueCallManager__CidNumber%% to %%queueCallManager__InboundNumber%% has entered the %%queueCallManager__QueueName%% queue.", "markdown": true }], "potentialAction": [{ "@type": "ActionCard", "name": "Add a comment", "inputs": [{ "@type": "TextInput", "id": "comment", "isMultiline": false, "title": "Add a comment" }], "actions": [{ "@type": "HttpPOST", "name": "Add comment", "target": "https://docs.microsoft.com/outlook/actionable-messages" }] }] }

  8. Click the green “Save” button

  9. Your action bot is ready to go

Related content

Notify Agent In Queue
Notify Agent In Queue
SharpenCare Knowledge Base
Read with this
Handling Inbound Web Chat in Sharpen Q
Handling Inbound Web Chat in Sharpen Q
SharpenCare Knowledge Base
More like this
Voicemail Setup and Use
Voicemail Setup and Use
SharpenCare Knowledge Base
Read with this
Leveraging the "Whisper","Listen", and "Join" Feature for Calls
Leveraging the "Whisper","Listen", and "Join" Feature for Calls
SharpenCare Knowledge Base
More like this
Sharpen Q (Admin)
Sharpen Q (Admin)
SharpenCare Knowledge Base
Read with this