​
Overview

Onyx can connect to your Slack workspace and answer questions like an expert teammate. You can configure OnyxBot to respond to certain types of messages, in specific channels, and with selected data from your index. Onyx Slack Bot

​
Setup

You must be an admin of the Slack workspace to set up the Slack bot.
1

Create a new Slack App

Navigate to the Slack App Dashboard and click Create New App → From a manifest.Select the workspace you want to connect to Onyx.
2

Use the YAML manifest

Click the YAML tab and paste the following manifest into the box:
YAML Manifest
display_information:
  name: OnyxBot
  description: I help answer questions in Slack!
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: OnyxBot
    always_online: true
  slash_commands:
    - command: /onyx
      description: Get back a private answer!
      usage_hint: Put your question here!
      should_escape: false
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - channels:history
      - channels:join
      - channels:read
      - chat:write
      - commands
      - groups:history
      - groups:read
      - im:history
      - im:read
      - mpim:history
      - reactions:write
      - reactions:read
      - usergroups:read
      - users:read.email
      - users:read
settings:
  event_subscriptions:
    bot_events:
      - app_mention
      - message.channels
      - message.groups
      - message.im
      - message.mpim
  interactivity:
    is_enabled: true
  org_deploy_enabled: false
  socket_mode_enabled: true
  token_rotation_enabled: false
Click Create and you will be taken to the app page.
3

Generate an App Token

Scroll down to the App-Level Tokens section and click Generate Token and Scopes.Give your token a name, add the connections:write scope to the app-level token and click Generate. Save this token for later.
You can customize your Slack bot’s name, description, and icon in the Display Information section.
Onyx Slack Bot App Token
4

Install the Slack App

Navigate to the OAuth & Permissions tab, click Install to Workspace, and follow the instructions to install the app.Copy the Bot User OAuth Token and save it for later.
Onyx does not currently support token rotation.
Onyx Slack Bot Bot Token
5

Setup Onyx for the Slack Bot

Navigate to the Onyx Admin Panel and select the Slack Bots tab.Enter the Bot Token, App Token, and click Create!Onyx Slack Bot Onyx Setup
6

Configure the Slack Bot's Behavior

Once your Slack bot is created, you can configure it’s universal behavior through the Default Configuration.You can also set channel-specific behavior using Channel Configurations.Onyx Slack Bot Configuration

​
How to use the Onyx Slack Bot

There are a few ways to chat with the Onyx Slack bot:
Your admin may enable any or all of these methods in your Slack workspace. Additionally, the configurations may change based on the channel you are in.
OnyxBot may also be configured with none, some, or all of your indexed data. Ask your admin what is available through your OnyxBot.

​
Advanced Configuration

There are a set of advanced configuration options available via environment variables that control your Slack bot’s behavior. You can find the full list of configuration options in the Onyx GitHub.
These configuration options are rarely needed and should be used with caution.