Integration for Slack

Julian Schulte -

Navigate to Data & Integrations to create Integration for Slack.

To install the PushMetrics Slack App, first log in to your PushMetrics account. In the Data & Integrations page, select Slack and click Add to Slack. You will then be redirected to Slack to review the requested permissions and complete the installation.

Using the Slack App, requires you to add the bot for Slack to your workspace and amend certain permissions ("scopes") to the Bot.
The PushMetrics Slack App makes use of the following Slack Scopes:

  • channels:join - This scope allows your app to join public channels in a workspace.
  • channels:read - This scope allows your app to view basic information about public channels in a workspace, including the list of channels and their details like name, creation date, purpose, etc.
  • chat:write - This scope allows your app to send messages as itself to channels it's a member of. The messages will appear as sent by the app, not as a user.
  • chat:write.public - This scope allows your app to send messages to public channels it's not a member of. The messages will appear as sent by the app, not as a user.
  • files:write - This scope allows your app to upload, delete and interact with files (for instance, create a public URL for a file) as itself. It can handle files it uploaded itself or ones uploaded by users in channels it's a part of.
  • files:read - This scope allows your app to view information about files stored in Slack, such as file type, size, and permalink. PushMetrics uses it only to fetch the metadata of files it has just uploaded.
  • im:write - This scope lets the PushMetrics bot create (or reopen) a 1-to-1 DM with a user so it can deliver a report or notification directly to them.
  • groups:read - Allows the app to view basic information about private channels (“private groups”) it is invited to. Required so PushMetrics can list available private channels for report delivery.
  • im:read - Allows the app to view basic information about a user’s direct message conversations with the PushMetrics bot. Needed so the app can confirm delivery and avoid opening duplicate DMs.
  • mpim:read - Allows the app to view basic information about multi-person direct message (MPIM) conversations. Required so PushMetrics can deliver reports to small DM groups if configured.

Creating a Slack Connection:

  1. Click "Slack" in the Data & Integrations screen
  2. Click "Add to Slack"
  3. Review scopes and click "allow"
  4. Choose a name for this integration, if you have more than one
  5. Click "next"

Editing a Slack Connection:

  1. Navigate to integrations tab of the Data & Integrations page.
  2. Click the edit button to the right of the integration you would like to edit.
  3. Click "Edit".

Slack App:

A Slack App is a comprehensive integration that can interact with Slack in a variety of ways. It's not just about sending messages but can also read, write, and extend Slack functionalities. Here are a few things a Slack App can do:

  • Send messages not only to channels but also directly to users.
  • Receive and respond to events in Slack (like messages, reactions, etc.)
  • Add new UI elements to the Slack interface like buttons, drop-down menus, etc.
  • Access Slack APIs that provide additional functionalities, such as uploading files, managing channel settings, etc.
  • Use interactive components like buttons, message menus, dialogues, etc.
  • Run slash commands.