Slack Events/Webhook Setup

The Cyclr Slack Connector supports webhooks so you can subscribe to Slack events such as File Created and File Shared events. These events use Cyclr’s Partner-level single URL webhook.

Retrieve the partner level webhook URL

In your Cyclr console:

  1. Go to Connectors > Application Connector Library.
  2. Locate the Slack entry and edit it.
  3. Select the Settings tab.
  4. Make a note of the Webhook URL. This is your Partner-level webhook URL used when working with any Slack Connectors in that Cyclr Console and its Accounts.

Setup events in Slack

On the Slack API App page for your Slack App. You can find Slack’s documentation on this here.

  1. Select Event Subscriptions in the left-hand menu.
  2. Set Enable Events to On.
  3. Enter the webhook URL found in the previous section in the Request URL field. You will see a green Verified if the URL is valid.
  1. Select Subscribe to bot events to expand the section.
  2. Select Add Bot User Event.
  3. Enter the event name corresponding to the Slack Connector’s Webhook Method you wish to use:
Slack Connector MethodSlack Event
File Createdfile_created
File Sharedfile_shared
App Mentionedapp_mention
Channel Message Postedmessage.channel
Direct Message Postedmessage.im
Message Postedmessage
Multiparty Direct Message Postedmessage.mpim
Private Message Postedmessage.group
  1. Select Save Changes at the bottom of the page.
    Any scopes missing from your Slack App are automatically added based on the events you entered.

Setup the webhook in a cycle

In the cycle where you want to add the webhook, drag the appropriate Webhook Method into the Builder and connect to other Steps as normal.

You do not need to use the webhook URL from the webhook step as all requests will arrive there via the Cyclr Partner-level webhook URL you entered into your Slack App. They will then be routed by Cyclr to the correct Slack Connector and Cycle.