How To Use WebHooks With Slack

Updated on December 13, 2018
Download PDF

Brief Overview

WebHooks (AKA callbacks) allow you to build WalkMe directly into your workflows by triggering 3rd party APIs and/or adding WalkMe Event data into your analytics platform.

WebHooks come in very handy for various platforms, include Slack, Zendesk, Intercom, Zapier, and many more. This article will focus on defining WebHooks for Slack.

Use Cases

WebHook for Slack use cases include the following:

  • Send any WalkMe Event (i.e., clicks on specific WalkMe elements) you wish to track to the Slack channel of your choosing;
  • Receive real-time notifications when specified events occur;
  • Better understand how your end-users engage with WalkMe in real-time in order to meet their needs and follow their journeys;
  • Utilize the vast Slack API library to manipulate and utilize your incoming WebHooks as you please.

Steps for Defining a WebHook for Slack

Step 1: Create a Slack channel;

Step 2: Add a WebHook to the Slack channel;

  1. Type “Apps” into the Slack search bar, and click on Apps;
  2. Click Manage apps… on the top left;
  3. In the search bar, type “Incoming WebHooks” and click Incoming WebHooks;
  4. Click the green Install button;
  5. Click the dropdown menu in Post to Channel and select the channel you created in Step 1;
  6. Click Add Incoming WebHooks integration;
  7. Click Save Settings.

Step 3: Enter into the Slack channel you created;

Step 4: Click “incoming-webhook”;

Step 5: Click “Settings”;

Step 6: Click “Copy URL”;

Step 7: Review ‘How To Send WalkMe Event Data To 3rd Party Systems Using WebHooks‘ to learn how to define your new incoming WebHook on Insights;

Step 8: Proceed Using the WebHook Wizard.

Wizard — Step 1: Define Event;

  • Events are sent to Slack by the “text” property;
  • Click “+ ADD PROPERTY” and add the “text” property;
Pro-Tip

Construct the sentence you want to send to your Slack channel and incorporate data from the predefined properties by adding “@” and selecting the property name from the list that appears.

 

Wizard — Step 2: Set Destination.

  • Destination platform Name: This will be used to identify the destination system (in this case Slack);
  • Set Request Type to “POST”;
  • Paste the Destination URL you copied in Step 6;
  • Add Header – Content-type : application/json;
  • Click Test. You should see the message “Tested Successfully!” in green;
  • Open the Slack channel you defined and see that WebHooks sent a random word;
  • Click SAVE;
  • FINALLY, try running the event you defined and observe the result on Slack!
Pro-Tip

Read this Slack Article to make your WebHook fancy using advanced formatting!

Example Implementation: Sending Survey Responses to Slack

Step 1: Choose Survey Question Answered event from Definition;

Step 2: Uncheck all the properties of the event;

Step 3: Add property “text” and set this as its value: The user: @wm.euId has rated us: @value.

 

 

Was this article helpful?

Related Articles