Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 27 additions & 20 deletions fern/products/ask-fern/pages/features/slack-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
<Note>
To install Ask Fern in your organization's Slack workspace, you must be a Slack admin.
</Note>

To install Ask Fern in your organization's Slack workspace, you must be a Slack admin. Follow these steps:
<Steps>
<Step title="Get your unique install link">

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 <YOUR_FERN_TOKEN>" \
--data-urlencode domain=<YOUR_DOMAIN>
```

Follow the URL returned in the `install_url` response field.

</Step>
<Step title="Add to your workspace">
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**.

<Frame>
<img src="/products/ask-fern/pages/assets/allow-slack.png" alt="Allow Ask Fern for Slack workspace" />
</Frame>

### 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.
</Step>
<Step title="Add to customer channels">

<Frame>
<img src="/products//ask-fern/pages/assets/request-slack.png" alt="Respond all setting in Slack" />
</Frame>
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.
</Step>
</Steps>

## Configuration

Expand Down