Skip to content

Commit 9d4c7e9

Browse files
authored
(ask fern) Update Slack install instructions (#1187)
1 parent 168e858 commit 9d4c7e9

File tree

1 file changed

+27
-20
lines changed

1 file changed

+27
-20
lines changed

fern/products/ask-fern/pages/features/slack-app.mdx

Lines changed: 27 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -9,36 +9,43 @@ Fern stores all questions and answers from Slack interactions for [analytics pur
99

1010
## Setup
1111

12-
Install the Ask Fern app and add the bot to customer channels.
12+
Install the Ask Fern app in your workspace and add the bot to customer channels.
1313

14-
### Install for your organization
14+
<Note>
15+
To install Ask Fern in your organization's Slack workspace, you must be a Slack admin.
16+
</Note>
1517

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

18-
1. In your Fern dashboard, click the **Install to Slack** button. You'll be redirected to Slack to authorize the app
19-
1. Select the workspace where you want to add Ask Fern and click **Allow**
21+
Use the [API explorer](/ask-fern/api-reference/slack/get-slack-install-link) to get a unique Slack installation link for your organization. Provide:
22+
- Your Fern token
23+
- Your domain without protocol or path (e.g., `website.com`, not `https://website.com/docs`)
24+
25+
You can alternatively use this cURL request:
26+
```bash
27+
curl -G https://fai.buildwithfern.com/slack/get-install \
28+
-H "Authorization: Bearer <YOUR_FERN_TOKEN>" \
29+
--data-urlencode domain=<YOUR_DOMAIN>
30+
```
31+
32+
Follow the URL returned in the `install_url` response field.
33+
34+
</Step>
35+
<Step title="Add to your workspace">
36+
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**.
2037

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

25-
### Enable for customer workspaces
26-
27-
To give customers access to the Ask Fern bot in their own Slack workspaces:
28-
29-
1. Generate a customer installation link by making a request to:
30-
```
31-
https://fai.buildwithfern.com/slack/get-install?domain={your-domain}
32-
```
33-
This returns a unique URL that your customers can use to install Ask Fern to their own Slack workspace.
42+
</Step>
43+
<Step title="Add to customer channels">
3444

35-
<Frame>
36-
<img src="/products//ask-fern/pages/assets/request-slack.png" alt="Respond all setting in Slack" />
37-
</Frame>
38-
1. Forward this link to your customer so they can install the Ask Fern app to their workspace.
39-
1. Once the customer has installed the Ask Fern app, you must add the bot to your customer Slack channel to give it access.
45+
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.
4046

41-
Once added, customers will see that `@Ask Fern was added to the channel`. They can start asking questions immediately.
47+
</Step>
48+
</Steps>
4249

4350
## Configuration
4451

0 commit comments

Comments
 (0)