Skip to content
Merged
Show file tree
Hide file tree
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
39 changes: 31 additions & 8 deletions fern/products/ask-fern/pages/features/slack-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@ To install Ask Fern in your organization's Slack workspace, you must be a Slack
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**

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

</Accordion>
<Accordion title="Enable for customer workspaces">

Expand All @@ -29,9 +33,15 @@ To give customers access to the Ask Fern bot in their own Slack workspaces:
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.

<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 added, customers will see that `@Ask Fern was added to the channel`. They can start asking questions immediately.
</Accordion>
</AccordionGroup>
Expand All @@ -43,20 +53,33 @@ Customize the bot's behavior to match your workflow needs.
<AccordionGroup>
<Accordion title="Bot settings per channel">

Use the `/configure` command in any channel to adjust the following settings:
Use the `/configure` slash command in any channel to adjust the settings:

| Command | Description | Example |
|---------|-------------|---------|
| **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` |
| **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` |
| **show** | Show the current settings | `/configure show` |
| **help** | Get help with Ask Fern slash commands | `/configure help` |

<Frame>
<img src="/products//ask-fern/pages/assets/respond-all-slack.png" alt="Respond all setting in Slack" />
</Frame>

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

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

1. In Slack, go to **Apps** in the sidebar and click **Add Apps**
2. Search for **Ask Fern** and select it
3. Click the **About** tab, then **Configuration**
4. Scroll to **Bot User** section and click **Edit**
5. Enter your preferred bot name and save changes
1. In Slack, go to **Apps** in the sidebar and click **Ask Fern**
1. Click the **About** tab, then **Configuration**
1. Scroll to **Bot User** section and click **Edit**
1. Enter your preferred bot name and save changes


<Frame>
<img src="/products//ask-fern/pages/assets/update-name-slack.png" alt="Update name of Slackbot" />
</Frame>

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