Slack Integration Development Guide

Create and set up your Slack App

• Here you can find a step-by-step guide on how to create your own slack app

• To get the most out of the slack connector, you need to add the following permissions to your app:

  • channels:history
  • channels:join
  • channels:manage
  • channels:read
  • chat:write
  • chat:write.customize
  • chat:write.public
  • calls:read
  • commands
  • files:write
  • im:write
  • mpim:write
  • team:read
  • users:read
  • users:read.email
  • users.profile:read
  • workflow.steps:execute

Note that if you want your app to operate on behalf of a user, you would want to add the following user permissions too:

• chat:write
• im:history
• im:read
• search:read

Configure the app parameters in the integration.app platform

• Add the Slack app from store in the Integration.app console
• Click Configure & Test
• In the Parameters section, select a Use custom parameters toggle / Edit Parameters
• Fill in Client Id and Client Secret
• Add scopes your application may require

Configure Webhooks

Slack offers a mechanism of subscription to changes that occur in a user's workspace in real-time. Follow the steps below to get notifications when a message is created, updated or deleted:

• Go to the integration.app console => Apps => Slack => Copy the Global Webhooks url <img height="135" width="671" alt="global webhooks" src="https://static.integration.app/connectors/box/asset-b9816d39-61ff-4eb0-b51e-bf4f5f844ed6.png" />
• Open the settings of your Slack app
• Go to Features/Event Subscriptions
• Switch the Enable Events toggle on
• Paste the Global Webhooks url you saved earlier into the Request URL field
• In the Subscribe to events on behalf of users section add the message.channels workspace event
• Save changes