Skip to content

Commit 774138e

Browse files
authored
(ask fern) Update Slack instructions and add images (#1021)
1 parent 780ab67 commit 774138e

File tree

5 files changed

+31
-8
lines changed

5 files changed

+31
-8
lines changed
155 KB
Loading
232 KB
Loading
66 KB
Loading
75 KB
Loading

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

Lines changed: 31 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,10 @@ To install Ask Fern in your organization's Slack workspace, you must be a Slack
1919
1. In your Fern dashboard, click the **Install to Slack** button. You'll be redirected to Slack to authorize the app
2020
1. Select the workspace where you want to add Ask Fern and click **Allow**
2121

22+
<Frame>
23+
<img src="/products/ask-fern/pages/assets/allow-slack.png" alt="Allow Ask Fern for Slack workspace" />
24+
</Frame>
25+
2226
</Accordion>
2327
<Accordion title="Enable for customer workspaces">
2428

@@ -29,9 +33,15 @@ To give customers access to the Ask Fern bot in their own Slack workspaces:
2933
https://fai.buildwithfern.com/slack/get-install?domain={your-domain}
3034
```
3135
This returns a unique URL that your customers can use to install Ask Fern to their own Slack workspace.
36+
37+
<Frame>
38+
<img src="/products//ask-fern/pages/assets/request-slack.png" alt="Respond all setting in Slack" />
39+
</Frame>
3240
1. Forward this link to your customer so they can install the Ask Fern app to their workspace.
3341
1. Once the customer has installed the Ask Fern app, you must add the bot to your customer Slack channel to give it access.
3442

43+
44+
3545
Once added, customers will see that `@Ask Fern was added to the channel`. They can start asking questions immediately.
3646
</Accordion>
3747
</AccordionGroup>
@@ -43,20 +53,33 @@ Customize the bot's behavior to match your workflow needs.
4353
<AccordionGroup>
4454
<Accordion title="Bot settings per channel">
4555

46-
Use the `/configure` command in any channel to adjust the following settings:
56+
Use the `/configure` slash command in any channel to adjust the settings:
57+
58+
| Command | Description | Example |
59+
|---------|-------------|---------|
60+
| **respond_to** | Controls whether the Ask Fern bot responds to all messages (`all`) or only when directly mentioned with `@Ask Fern` (`mentions_only`) | `/configure respond_to all` |
61+
| **roles** | Specifies which RBAC roles should be used to filter Ask Fern responses (if you have [role-based access control](/docs/authentication/rbac) configured) | `/configure roles developer, admin` |
62+
| **show** | Show the current settings | `/configure show` |
63+
| **help** | Get help with Ask Fern slash commands | `/configure help` |
64+
65+
<Frame>
66+
<img src="/products//ask-fern/pages/assets/respond-all-slack.png" alt="Respond all setting in Slack" />
67+
</Frame>
4768

48-
- **respond_to**: Controls whether the Ask Fern bot responds to all messages (`all`) or only when directly mentioned with `@Ask Fern` (`mentions_only`)
49-
- **roles**: Specifies which RBAC roles should be used to filter Ask Fern responses (if you have [role-based access control](/docs/authentication/rbac) configured)
5069
</Accordion>
5170
<Accordion title="Customize the bot name">
5271

5372
You can rename the bot to match your brand (example: "YourCompanyName Support"):
5473

55-
1. In Slack, go to **Apps** in the sidebar and click **Add Apps**
56-
2. Search for **Ask Fern** and select it
57-
3. Click the **About** tab, then **Configuration**
58-
4. Scroll to **Bot User** section and click **Edit**
59-
5. Enter your preferred bot name and save changes
74+
1. In Slack, go to **Apps** in the sidebar and click **Ask Fern**
75+
1. Click the **About** tab, then **Configuration**
76+
1. Scroll to **Bot User** section and click **Edit**
77+
1. Enter your preferred bot name and save changes
78+
79+
80+
<Frame>
81+
<img src="/products//ask-fern/pages/assets/update-name-slack.png" alt="Update name of Slackbot" />
82+
</Frame>
6083

6184
Now customers will see `@YourCompanyName Support was added to the channel` instead of the default `@Ask Fern` name.
6285
</Accordion>

0 commit comments

Comments
 (0)