Table of Contents
Summary
This feature allows Slack channels to receive specific, automated Whistic updates! Slack Actions are also available here.
Supported
-
Pub/Sub POSTs
-
Static JSON data payloads sent to your endpoint.
-
-
Update Types
-
Vendor
-
Created.
-
-
Assessments
-
Awaiting Vendor, Review Pending, Review In Progress, Needs Clarification, On Hold, Completed, Approved, Approved with Conditions, Denied, Cancelled, Manual Review,
-
-
Profile
-
Shares, Views, Requests.
-
-
POST Events
-
Profile:
-
Request Approval.
-
-
-
Requirements
- Please confirm with your Whistic contact that your account is qualified and prepared for setup, etc.
- You will need your own Slack account.
Setup Steps
Overview
-
Slack Admin
-
Whistic Admin
The integration is configurable to allow for you to set multiple channels up with each separate designated notifications from Whistic. You can therefore have one channel for all Whistic notifications or create separate channels with different participants and for different purposes and have designated events appear within those channels.
Manage Slack App
Here’s the process for creating a Slack app with the Incoming Webhooks option, as well as getting the associated URL to post messages to a Slack channel with the app.
-
Prerequisites
-
Your account must be a Workspace Admin in the Slack Workspace which will receive the messages from Whistic
-
You should create a designated Slack channel to receive Whistic messages prior to creating the Whistic Slack app
-
1. Log into the Workspace in Slack
2. Select the Workspace at the top, then “Settings and Administration”, “Manage Apps”
3. Select Build at the top of the opened webpage (Should be https://api.slack.com/apps/)
4. Click “Create an App” then “From scratch”
5. Click “From scratch”
6. Name the App a distinctive name so that you know which app it is ( IE: “whistic-incoming-webhooks”) and select your workspace from the dropdown
7. Click “Create App”
8. You will be redirected to the administration page for your new App
9. Open the “Features/Incoming Webhooks” tab
10. Turn on “Activate Incoming Webhooks” using the slider control
11. Click the “Add New Webhook to Workspace” button. Repeat steps 11 through 14 if you are creating webhooks for multiple slack channels.
12. Select the proper Slack channel to receive Whistic messages and click Allow
13. You should see a new entry in the “Webhook URLs for Your Workspace” table
14. You can click the Copy button on that row to copy the URL. This is the URL you will use in the Whistic Webhooks page when adding a new Slack webhook.
Manage Slack Webhooks
1. After you have created your Slack app in Slack and copied the Webhook URL in Slack. Navigate to Whistic to complete the setup.
2. In Whistic, select Admin Tools in the left hand menu
3. Select Webhooks under Company Settings
4. Click on New Webhook and then click Slack to create a new webhook
5. Click on the pencil icon next to the existing Slack webhook to edit an existing webhook
6. The Webhook Configuration pop-up will appear
7. Add or edit the name of your webhook in the Name field
8. Paste the Webhook URL you created in Slack into the Slack Endpoint URL field
9. Add or edit the email address of the person who will receive error messages if Slack notifications fail to send
10. Select the events that you want to receive notifications about in your designated Slack channel by clicking the toggle next to the corresponding event to the blue “on” position
11. For every event you have added you can customize the message that will be associated with the event when a notification for this appears in Slack
12. Type your message into the field
13. To automatically add additional detail for this event into the message, click on “Show” next to “Available Keys”
14. A menu of available keys for the selected event will appear
15. Simply copy and paste the entire portion in dark bold into the message field to add the detail into the message, you can add words and punctuation around the keys to create a full sentence. For example: “Whistic profile sent from ${profileSenderEmail}” will display in Slack as “Whistic profile sent from ataylor@email.com”
16. After you have finished adding events and messages, click “Test Webhook” at the bottom left. This will send test notifications for each event to your slack channel.
17. Once the Webhook is Tested successfully a success message will appear.
18. Click Save
19. Go to Slack and check the channel you connected to see if the test webhook message has appear, this may take a few seconds
20. Setup is now complete!