Slack

Configuration details for the Slack integration

With the Slack destination, Hightouch can serve as a notifier for various changes. This is a very flexible integration, but here are a few example use cases.

  1. Notify your customer success teams when product usage for a key account suddenly drops

  2. Notify an account executive when product usage surpasses a certain threshold

  3. Send a daily summary of the number of sign ups, compared to the same day last month

  4. Send a daily summary on the adoption of a core feature

The Slack destination has two different formats, for slightly different use cases.

  • Message — Rows that have been added or removed since the last query run are sent as individual messages

  • Table — All rows for the current query run are posted as a single message, formatted as a table

Message

Message formatting is the best method to use for the first two of our example use cases.

  1. Notify your customer success teams when product usage for a key account suddenly drops

  2. Notify an account executive when product usage surpasses a certain threshold

Message formatting is best when the following conditions are met.

  1. You want to write a query, and have Hightouch detect the added and removed rows

  2. You want a custom message sent per each added and removed rows

Message has two configuration parameters:

Name

Description

Added body

Body of the message sent for rows that are added

Removed body

Body of the message sent for rows that are removed

For both the added and removed body, Liquid templating is supported. The most important implication of this is that columns from the added or removed row can be accessed as part of the message body. Here is an example message making use of Liquid to insert a column into the message.

User with name {{ name }} and email {{ email }} has signed up

Table

Table formatting is the best format to use for the last two of our example use cases.

  1. Send a daily summary of the number of sign ups, compared to the same day last month

  2. Send a daily summary on the adoption of a core feature

This format is good for the following scenarios.

  1. You want to write a query, and have Hightouch push a message containing all rows, formatted as a table, to Slack

  2. You don't want Hightouch to detect added and removed rows, but instead want to send all rows on each query run

Table format has no configuration parameters. All columns in the query are sent to Slack. If you want to customize the columns sent to Slack, adjust the ones returned in the query.

Contents
Message
Table