Slack

Requirements:

1. Your Slack User has the Org Owner role

   1. Ideally this User is a Service Account

2. You are subscribed to the Enterprise Grid Slack plan

Create a Slack API Key for Teleskope

1. Navigate to Your Apps

2. Click Create New App

3. Click From Scratch

4. Enter a name for the app and select a primary workspace

5. Navigate to Org Level Apps and click Enable org-readiness

6. Copy the app ID from the URL

   1. For example, A07J7VDDKBT

7. Reach out to Slack support by typing "/feedback" and ask them to add the discovery:read and discovery:write scopes to your App ID

8. Add the chat:write, chat:write.public, and im:write bot scopes

9. Under Interactivity & Shortcuts -> Enable Interactivity -> Request URL -> set the request URL to https://api.satellite.<Domain>.teleskope.ai/callback/slack

   1. Additionally, provide your Teleskope rep with the Signing Secret to allow Teleskope to authenticate interactivity actions.

10. Install the app to your Organization

11. Navigate to OAuth & Permissions and prepare your User OAuth Token and Bot User OAuth Token

12. Submit your User OAuth Token when enrolling the Slack Connector in Teleskope

    1. Submit your Bot User OAuth Token when configuring Policy Maker for actions and notifications

📘 Teleskope is currently working towards a Slack App Directory listing.