Ask Fern Slack app

The Ask Fern Slack app allows customers to ask questions about your products directly in Slack channels and receive AI-generated answers from your documentation database.

Fern stores all questions and answers from Slack interactions for analytics purposes.

Setup

Install the Ask Fern app and add the bot to customer channels.

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
  2. Select the workspace where you want to add Ask Fern and click Allow
Allow Ask Fern for Slack workspace

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
  2. Forward this link to your customer so they can install the Ask Fern app to their workspace.

  3. 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.

Configuration

Customize the bot’s behavior to match your workflow needs.

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

CommandDescriptionExample
respond_toControls whether the Ask Fern bot responds to all messages (all) or only when directly mentioned with @Ask Fern (mentions_only)/configure respond_to all
rolesSpecifies which RBAC roles should be used to filter Ask Fern responses (if you have role-based access control configured)/configure roles developer, admin
showShow the current settings/configure show
helpGet help with Ask Fern slash commands/configure help
Respond all setting in Slack

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

  1. In Slack, go to Apps in the sidebar and click Ask Fern
  2. Click the About tab, then Configuration
  3. Scroll to Bot User section and click Edit
  4. Enter your preferred bot name and save changes
Update name of Slackbot

Now customers will see @YourCompanyName Support was added to the channel instead of the default @Ask Fern name.

Architecture

When a user asks Ask Fern a question in Slack, a webhook triggers Fern’s servers to search your documentation database and retrieve relevant context. Using that context, Ask Fern generates a response.