Slack (Actions) Destination

Slack is a team collaboration tool work flows. It’s where the people you need, the information you share, and the tools you use come together to get things done.

This document is about a feature which is in beta. This means that the Destination Actions are in active development, and some functionality may change before it becomes generally available

Good to know: This page is about the Actions-framework Slack Segment destination. There’s also a page about the non-Actions Slack destination. Both of these destinations receives data from Segment.

Benefits of Slack (Actions) vs Slack Classic

Slack (Actions) provides the following benefits over the classic Slack destination:

  • Consolidated Message Sending. Send multiple messages from a single instance of the Slack (Actions) destinations. Use Event Triggers to send a message when your criteria is met.
  • Streamlined Configuration. Configure connection details on a per-message basis, rather than for the destination as a whole. This enables sending messages to different workspaces or channels from one source.
  • Easier access to data. The event variables picker shows you all the available data from the event you use to test the Trigger. Variables are clearly labeled to ensure they stand out from other text and markup.

Getting Started

  1. From the Segment web app, click Catalog, then click Destinations.
  2. Find the Destinations Actions item in the left navigation, and click it.
  3. Click Configure Actions Slack.
  4. Select an existing Source to connect to Slack (Actions).
  5. Click Customized Setup to start from a blank mapping.

Important differences from the classic Slack destination

Available Slack actions

Combine the supported triggers with the following Slack-supported actions:

Post Message

Post Message sends a message to the specified Slack workspace and channel when the associated trigger criteria are met.

Click to expand fields

Field Description
Webhook URL (required)

The webhook provided by Slack to connect with the desired workspace.

Message (required)

The message that will post to the specified channel. Use a mix of Slack’s formatting, and event variables.

channel

The channel within the connected workspace. Do not include the # character. For example, use general, not #general.

User Default Segment

The sender of the posted message.

Icon URL Default https://logo.clearbit.com/segment.com

The URL of the image that appears next to the User.

Migration from the classic Slack destination

Follow the table below to map your existing Slack destination configuration to Slack (Actions).

Slack (Actions) uses Slack’s formatting syntax. This requires that you manually re-enter any messages from Slack Classic, and pick event data from the event variable picker. The handlebars syntax from Slack Classic is not compatible.

Slack settings mapping

All
slack Classic Destination Setting How to enable in slack (Actions)
Connection Settings
Event Channels

In Slack (Actions), events and channels are set per subscription.

Identify Template

In Slack (Actions), you do not need a specific template for Identifying users. Use the Messages field to write your message, and add data from the event.

Event Template

In Slack (Actions), you do not need a specific template for specific Events. Use the Filter and Messages field to specify the incoming event, and write your message with data from the event.

Incoming Webhook URL

Available as a subscription-level setting on the Post Message action.

Whitelisted Traits

Use the Messages field in the Post Message action to create your message with any traits from an incoming Identify call.

This page was last modified: 16 Sep 2021



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account