diff --git a/fern/products/ask-fern/pages/features/slack-app.mdx b/fern/products/ask-fern/pages/features/slack-app.mdx index 0bc98b300..953cb87cd 100644 --- a/fern/products/ask-fern/pages/features/slack-app.mdx +++ b/fern/products/ask-fern/pages/features/slack-app.mdx @@ -9,36 +9,43 @@ Fern stores all questions and answers from Slack interactions for [analytics pur ## Setup -Install the Ask Fern app and add the bot to customer channels. +Install the Ask Fern app in your workspace and add the bot to customer channels. -### Install for your organization + + To install Ask Fern in your organization's Slack workspace, you must be a Slack admin. + -To install Ask Fern in your organization's Slack workspace, you must be a Slack admin. Follow these steps: + + -1. In your Fern dashboard, click the **Install to Slack** button. You'll be redirected to Slack to authorize the app -1. Select the workspace where you want to add Ask Fern and click **Allow** +Use the [API explorer](/ask-fern/api-reference/slack/get-slack-install-link) to get a unique Slack installation link for your organization. Provide: +- Your Fern token +- Your domain without protocol or path (e.g., `website.com`, not `https://website.com/docs`) + +You can alternatively use this cURL request: +```bash +curl -G https://fai.buildwithfern.com/slack/get-install \ + -H "Authorization: Bearer " \ + --data-urlencode domain= +``` + +Follow the URL returned in the `install_url` response field. + + + +You'll be redirected to Slack to authorize the Ask Fern app. Select the workspace where you want to add Ask Fern and click **Allow**. Allow Ask Fern for Slack workspace -### Enable for customer workspaces - -To give customers access to the Ask Fern bot in their own Slack workspaces: - -1. Generate a customer installation link by making a request to: - ``` - https://fai.buildwithfern.com/slack/get-install?domain={your-domain} - ``` - This returns a unique URL that your customers can use to install Ask Fern to their own Slack workspace. + + - - Respond all setting in Slack - -1. Forward this link to your customer so they can install the Ask Fern app to their workspace. -1. Once the customer has installed the Ask Fern app, you must add the bot to your customer Slack channel to give it access. +Once you've installed it in your workspace, add the bot to customer Slack channels to give it access. Customers will see that `@Ask Fern was added to the channel` and can start asking questions immediately. -Once added, customers will see that `@Ask Fern was added to the channel`. They can start asking questions immediately. + + ## Configuration