Slack

The default method. Use it so the Improvado agent reads your direct and group direct messages and, when you ask it to, sends messages as you. Each person connects with their own Slack account. Reports are not extracted through these connections.

3.1Click Authorize and approve with your own Slack account. Sign in to the right workspace first; an Incognito window helps.

3.2Keep the connection private. Anyone it is shared with can have the agent read and send messages as you.

Use this method so the Improvado agent searches, reads and posts in Slack as you, including through Slack's MCP server. The app is created once per workspace; after that, everyone who wants the agent to act as them connects with their own Slack account. Reports are not extracted through these connections.

3.1Go to api.slack.com/apps, click Create New App, choose From a manifest, pick your workspace and paste this manifest (YAML):

display_information:
  name: Improvado Agent
oauth_config:
  redirect_urls:
    - https://connections.improvado.io/stat_provider_client/oauth_redirect/slack/
  scopes:
    user:
      - search:read.public
      - search:read.private
      - search:read.im
      - search:read.mpim
      - search:read.files
      - search:read.users
      - channels:history
      - groups:history
      - im:history
      - mpim:history
      - channels:read
      - groups:read
      - im:read
      - mpim:read
      - im:write
      - mpim:write
      - chat:write
      - reactions:read
      - reactions:write
      - users:read
      - users:read.email
      - files:read
      - files:write
      - canvases:read
      - canvases:write
      - emoji:read
settings:
  is_mcp_enabled: true
  token_rotation_enabled: false

The manifest registers Improvado's redirect URL, the permissions the agent uses and Slack's MCP server. Keep the scopes as they are: the connection asks for exactly this list.

3.2Open Basic Information and copy the Client ID and Client Secret into the connection form.

3.3Click Authorize and approve as yourself. Colleagues connect with the same Client ID and Client Secret and approve with their own Slack accounts.

Use this method for reports. It installs the Improvado app in your workspace, and the app reads the channels it is invited to.

3.1Pick a permission set:

• Read Only (default) - the workspace, its members, channels and user groups, plus the content of the conversations the app is invited to: messages, thread replies, direct and group direct messages, shared files and calls.
• Read & Write - everything in Read Only, plus posting messages, adding reactions and setting up calls when you ask the Improvado agent to.
• Custom - individual permissions of your choice.

3.2Click Authorize and approve the app. Sign in to the right workspace first; an Incognito window helps.

3.3Invite the app to every channel you want to extract: run /invite @Improvado in the channel.

Use this method for reports and for the Improvado agent to post as the bot of a Slack app you create and manage.

3.1Go to api.slack.com/apps and create an app in the workspace you want to connect.

3.2Open OAuth & Permissions and add the Bot Token Scopes you need:

• chat:write - send messages to channels the app is a member of (add chat:write.public to post to public channels without joining).
• team:read, users:read, channels:read - add these if you also need to extract workspace data.

3.3Install the app to your workspace and copy the Bot User OAuth Token (it starts with xoxb-).

3.4Invite the bot to the channels it should post to or read from: run /invite @your-app in the channel.

3.5Paste the token into the Bot User OAuth Token field.