Shortlink: http://go.Storytell.ai/Docs

Install Storytell in Your Slack Workspace

The easiest way to start using Storytell is to join our Slack Playground. If you want a custom install in your own Slack workspace, here’s how!

You’ll need a Slack Admin to configure Storytell. If that’s not you, share this with the appropriate person in your company.

⏰ This process will take you around 10-15 minutes

Create a new “Bot” in your Slack workspace

1. Click here to start and then click Create app

1. Select your workspace in the popup window

   

2. Click Edit Configuration

   ❗Warning: Do not click the green Create button. (Don’t let it trick you!)

4a. You’ll need to copy this configuration below

_metadata:
  major_version: 1
  minor_version: 1
display_information:
  name: Storytell (Storytell Official App)
  description: Distill Signal from Noise
  background_color: "#11359e"
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: true
  bot_user:
    display_name: Storytell
    always_online: true
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - channels:history
      - chat:write
      - files:read
      - files:write
      - groups:history
      - groups:read
      - im:history
      - im:read
      - mpim:history
      - mpim:read
      - users:read
      - channels:manage
      - groups:write
      - im:write
      - mpim:write
      - chat:write.public
      - chat:write.customize
      - channels:read
      - team: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

4b. You’ll copy the text above by hovering over this button as per the instructions below:

1. Paste it in to your screen where it says Enter app manifest below in the YAML configuration (not JSON). Then hit Next (green button)