How to configure Slack for Notifications

Table of Contents

Overview

An organization can configure their vFunction Server to send Status Update notifications via Slack. An Admin on the organization’s vFunction Server enables Slack via the vFunction Server UI. The Admin shares some organizationally-specific information generated when enabling Slack with the vFunction Customer Success team. The vFunction Customer Success team enables the organization for Slack usage. Individuals in the organization then enable vFunction notifications to be sent as Direct Messages in Slack.

How to enable Slack as an Admin in the vFunction Server UI

An Admin on an organization’s vFunction Server enables Slack via the vFunction Server UI:

  1. Log into the vFunction Server in a web browser
  2. Select the dropdown arrow in the upper-left corner next to the vFunction logo
  3. Select the dropdown arrow next to the email address
  4. Select My Team
  5. Select Configure Apps in the left-hand sidebar
  6. Select the copy icon to the right of the Broker Key
  7. Paste the copied content into an email to support@vfunction.com
  8. A verification email will be sent back when the organization has been enabled for use with Slack

How to receive vFunction Server Notifications in Slack

After the vFunction Customer Success team has enabled the organization for Slack usage, an individual can enable vFunction notifications to be sent as Direct Messages in Slack.

  1. Log into the vFunction Server in a web browser
  2. Select the dropdown arrow in the upper-left corner next to the vFunction logo
  3. Select the dropdown arrow next to the email address
  4. Select My Account
  5. Click the Add to Slack button
  6. The browser will be redirected to slack.com. If an existing Slack session is found, the user is redirected to slackWorkspaceName.slack.com. If no existing Slack session is found, the user is asked to add the Slack Workspace.
  7. Click the Allow button to allow @vfunction to perform actions in channels & conversations.
  8. When Status Updates are available from the vFunction Server, these will be sent to the user as a Direct Message from the Slack user vfunction

Error: “Broker key not found”

  1. After an Admin enables Slack and an individual allows Slack Notifications, the individual is redirected back to the vFunction Server and sees a message that, “Broker key not found. Contact support”
  2. This error is thrown because the vFunction Customer Success team has not enabled the organization to use Slack.
  3. To resolve this error, please follow all steps in How to enable Slack as an Admin. Once verification has been received, the individual can then enable Slack Notifications following the steps in How to receive Notifications in Slack

Updated on 14 Apr 2023