diff --git a/connection-guides/messaging/slack.mdx b/connection-guides/messaging/slack.mdx new file mode 100644 index 0000000..da58338 --- /dev/null +++ b/connection-guides/messaging/slack.mdx @@ -0,0 +1,66 @@ +--- +title: "Slack" +description: "Follow these steps to connect Slack via the StackOne Hub successfully." +--- + +import IntegrationFooter from "/snippets/integration-footer.mdx" + + + You must be able to create and manage Slack apps for the workspace you want to connect. + + +If you've been directed to integrate with Slack, the following steps will help you configure the required OAuth application details so you can connect successfully. + +## Create a Slack app and configure OAuth + + + + Go to [Slack API: Your Apps](https://api.slack.com/apps) and create a new app (for example, **From scratch**). + + + + In your app settings, open **OAuth & Permissions** and add this **Redirect URL**: + `https://api.stackone.com/connect/oauth2/slack/callback` + + + + In **OAuth & Permissions**, add the scopes required by your integration (you can adjust these later if needed). + + + + Install the app to the Slack workspace you want to connect so the OAuth authorization flow can be completed. + + + + In **Basic Information**, copy the **Client ID** and **Client Secret** and store them safely. + + + +## Linking your Slack account + + + + In your integration platform, paste the **Client ID** and **Client Secret** from the previous steps (and any optional scopes/settings required for your use case). + + + + Start the OAuth flow and approve access when prompted by Slack. + + + + + +## Available data + +This integration has the following [Messaging Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider: + + +## Useful Links + + + https://docs.slack.dev/authentication/installing-with-oauth + diff --git a/docs.json b/docs.json index e8482c2..02fd264 100644 --- a/docs.json +++ b/docs.json @@ -358,6 +358,14 @@ { "source": "/en/articles/en/articles/7727327-ashby", "destination": "/connection-guides/ats/ashby" + }, + { + "source": "/integration-guides/messaging/slack", + "destination": "/connection-guides/messaging/slack" + }, + { + "source": "/integration-guides/messaging/slack/", + "destination": "/connection-guides/messaging/slack" } ] } \ No newline at end of file diff --git a/integrations.mdx b/integrations.mdx index ac8388e..9cd87c2 100644 --- a/integrations.mdx +++ b/integrations.mdx @@ -223,3 +223,6 @@ import { IntegrationTile } from '/snippets/integration-tile.mdx'; + +## Messaging +