Slack Connector

overview the slack connector allows seamless integration of swimlane turbine with slack's communication platform, enabling automated interactions and workflows within slack channels and conversations slack is a powerful communication platform that allows teams to collaborate effectively in real time the slack turbine connector enables users to automate a variety of slack interactions, such as sending messages, managing channels, and retrieving user information by integrating with swimlane turbine, security teams can streamline incident response communications, coordinate actions across channels, and enhance situational awareness without leaving the security automation workflow prerequisites to effectively utilize the slack connector with swimlane turbine, ensure you have the following prerequisites api key authentication url the base url for slack api requests api key your unique slack api token for authentication http bearer authentication url the base url for slack api requests token a bearer token such as a jwt for secure access capabilities the slack connector has the following capabilities create, archive, and retrieve history of conversations get message permalink invite and remove users from a conversation retrieve current users in a conversation send broadcast messages lookup by email asset setup the asset for this connector requires the following inputs api token bot or user token to set up a slack bot oauth api with the appropriate permissions follow these steps create a slack app go to the slack api website https //api slack com/ https //api slack com/ click on "your apps" in the top right corner and then click on "create new app " provide a name for your app and select the slack workspace where you want to install the app once the app is created, you'll be redirected to the app's settings page configure your slack app from the app's settings page, navigate to "oauth & permissions" under the "scopes" section for "bot token scopes", add the necessary scopes for the api calls chat✍️ this scope allows your app to send messages to channels and conversations channels🏛️ this scope grants access to conversation history in public channels channels🈴 this scope allows your app to invite users to public channels channels\ manage this scope grants the ability to manage public channels, including archiving, inviting, and kicking users channels📕 this scope provides access to channel and conversation information chat\ write customize this scope allows your app to customize messages with blocks and attachments groups✍️ this scope allows your app to create new channels groups🏛️ this scope grants access to conversation history in private channels groups📕 this scope provides access to private channel information im🏛️ this scope grants access to conversation history in direct messages mpim🏛️ this scope allows your app to view messages and other content in group direct messages that your slack app has been added to im📕 this scope provides access to direct message channel information users📕 this scope allows your app to retrieve user information users\ read email this scope provides access to user email addresses im✍️ this scope allows your app to start direct messages with people mpim✍️ this scope allows your app to start group direct messages with people channels\ write invites this scope allows your app to invite members to public channels groups\ write invites this scope allows your app to invite members to private channels mpim\ write invites this scope allows your app to invite members to group direct messages mpim📕 provides access to basic information about group direct messages that your slack app has been added to save the changes install the app to your workspace in the app's settings page, go to "oauth & permissions" scroll down to the "oauth tokens for your workspace" section and click on the "install app to workspace" button authorize the app to access your slack workspace by following the prompts obtain your access tokens after installing the app, you'll be provided with access tokens such as "bot user oauth access token" notes slack api documentation or methods link https //api slack com/methods see the following topics for more about user and bot oauth tokens token types https //api slack com/authentication/token typesscopes https //api slack com/scopesweb api https //api slack com/web this connector was last tested against product version 4 12 0 additional notes for lookup by email action, please set the scope parameter to users\ read email