New Interaction Events (Instant)

Pipedream makes it easy to connect APIs for Slack and 2,400+ other apps remarkably fast.

Trigger workflow on

New Interaction Events (Instant) from the Slack API

Next, do this

Connect to 2,400+ APIs using code and no-code building blocks

No credit card required

Overview#

Slack messages can contain interactive elements like buttons, dropdowns, radio buttons, and more. This source subscribes to interactive events, like when a button is clicked in a message.

Example of a Slack button

Then this source will be triggered when you or another Slack user in your workspace clicks a button, selects an option or fills out a form.

Example feed of interaction events coming from Slack

With this trigger, you can build workflows that perform some work with other APIs or services, and then reply back to the original message.

Getting Started#

What this short video to learn how to use this in a workflow, or follow the guide below.

First, if you haven’t already - send yourself a message containing one or more interactive elements. Use the Sending the message with an interactive element guide below to send a message containing a button.

If you have already sent a message containing an element, skip to Configuring the source.

Sending the message with an interactive element

The easiest way is to send yourself a message using the Slack - Send Message Using Block Kit action:

Selecting the Send Slack Message with Block Kit )

Then select a Channel you’d like to send the message to, and use the Block Kit Builder to build a message, or just copy the example button blocks below:

[
  {
    "type": "actions",
    "elements": [
      {
        "type": "button",
        "text": {
          "type": "plain_text",
          "text": "Click Me",
          "emoji": true
        },
        "value": "click_me_123",
        "action_id": "button_click"
      }
    ]
  }
]

Your Slack - Send Message Using Block Kit should look like this:

Setting up the block kit message with a button block

Configuring the source

By default, this source will listen to all interactive events from your Slack workspace that your connected Slack account has authorization to view. Please note that only messages created via Slack - Send Block Kit Message Action, or via API call from the Pipedream app will emit an interaction event with this trigger. Block kit messages sent directly via the Slack's block kit builder will not trigger an interaction event.

You can filter these events by selecting a specific channel and/or a specific action_id.

Filtering interactive events by channel

Use the Channels dropdown to search for a specific channel for this source to subscribe to. Only button clicks, dropdown selects, etc. in this selected channel will trigger the source.

Filtering interactive events by `action_id`

For more specificity, you can filter based on the passed action_id to the message.

The action_id is arbitrary. It’s defined on the initial message sending the button, dropdown, or other interactive element’s markup.

For example, in the section above using the Block Kit to create a message, we defined the button’s action_id as "button_click". But you can choose whichever naming convention you’d like.

If you pass button_click as a required action_id to this source, then only interactivity events with the action_id of "button_click" will trigger this source.

Troubleshooting

I’m clicking buttons, but no events are being received

Follow these steps to make sure your source is configured correctly:

Make sure that your action_id or channels filters apply to that message, remove the filters to make sure that’s not the case.
Make sure that the message comes from the same Slack account that this source is configured with.
Make sure that the message was sent via Pipedream action (e.g. Slack - Send Block Kit Message Action) or via API call from the Pipedream app.

import common from "../common/base.mjs"; import sampleEmit from "./test-event.mjs"; export default { name: "New Interaction Events (Instant)", version: "0.0.17", key: "slack-new-interaction-event-received", description: "Emit new events on new Slack [interactivity events](https://api.slack.com/interactivity) sourced from [Block Kit interactive elements](https://api.slack.com/interactivity/components), [Slash commands](https://api.slack.com/interactivity/slash-commands), or [Shortcuts](https://api.slack.com/interactivity/shortcuts).", type: "source", props: { ...common.props, alert: { type: "alert", alertType: "info", content: "Please note that only messages created via Pipedream's [Send Block Kit Message](https://pipedream.com/apps/slack/actions/send-block-kit-message) Action, or via API call from the Pipedream app will emit an interaction event with this trigger. \n\nBlock kit messages sent directly via the Slack's block kit builder will not trigger an interaction event. \n\nSee the [documentation](https://pipedream.com/apps/slack/triggers/new-interaction-event-received) for more details.", }, action_ids: { type: "string[]", label: "Action IDs", description: "Filter interaction events by specific `action_id`'s to subscribe for new interaction events. If none are specified, all `action_ids` created via Pipedream will emit new events.", optional: true, default: [], }, conversations: { propDefinition: [ common.props.slack, "conversation", ], type: "string[]", label: "Channels", description: "Filter interaction events by one or more channels. If none selected, any interaction event in any channel will emit new events.", optional: true, default: [], }, // eslint-disable-next-line pipedream/props-description,pipedream/props-label slackApphook: { type: "$.interface.apphook", appProp: "slack", /** * Subscribes to potentially 4 different events: * `interaction_events` - all interaction events on the authenticated account * `interaction_events:${action_id}` - all interaction events with a specific given action_id * `interaction_events:${channel_id}` - all interaction events within a specific channel * `interaction_events:${channel_id}:${action_id}` - action_id within a specific channel * @returns string[] */ async eventNames() { // start with action_ids, since they can be the most specific const action_events = this.action_ids.reduce((carry, action_id) => { // if channels are provided, spread them if (this.conversations && this.conversations.length > 0) { return [ ...carry, ...this.conversations.map( (channel) => `interaction_events:${channel}:${action_id}`, ), ]; } return [ ...carry, `interaction_events:${action_id}`, ]; }, []); if (action_events.length > 0) return action_events; // if no action_ids are specified, move down to channels const channel_events = this.conversations.map( (channel) => `interaction_events:${channel}`, ); if (channel_events.length > 0) return channel_events; // if not specific action_ids or channels are specified, subscribe to all events return [ "interaction_events", ]; }, }, }, methods: {}, async run(event) { this.$emit( { event, }, { summary: `New interaction event${ event?.channel?.id ? ` in channel ${event.channel.id}` : "" }${ event.actions?.length > 0 ? ` from action_ids ${event.actions .map((action) => action.action_id) .join(", ")}` : "" }`, ts: Date.now(), }, ); }, sampleEmit, };

Label	Prop	Type	Description
Slack	`slack`	`app`	This component uses the Slack app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Action IDs	`action_ids`	`string[]`	Filter interaction events by specific `action_id`'s to subscribe for new interaction events. If none are specified, all `action_ids` created via Pipedream will emit new events.
Channels	`conversations`	`string[]`	Select a value from the drop down menu.
	`slackApphook`	`$.interface.apphook`

Label

Prop

Type

Description

Slack

slack

app

This component uses the Slack app.

N/A

db

$.service.db

This component uses $.service.db to maintain state between executions.

Action IDs

action_ids

string[]

Filter interaction events by specific action_id's to subscribe for new interaction events. If none are specified, all action_ids created via Pipedream will emit new events.

Channels

conversations

string[]

Select a value from the drop down menu.

slackApphook

$.interface.apphook

New Interaction Events (Instant) from Slack API

Pipedream makes it easy to connect APIs for Slack and 2,400+ other apps remarkably fast.

Overview#

Getting Started#

Sending the message with an interactive element

Configuring the source

Filtering interactive events by channel

Filtering interactive events by `action_id`

Troubleshooting

I’m clicking buttons, but no events are being received

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Integrations#

Details#

Code#

Configuration#

Authentication#

About Slack#

More Ways to Use Slack#

Triggers#

Actions#

Explore Other Apps#

1
-
24
of
2,400+
apps by most popular

New Interaction Events (Instant) from Slack API

Pipedream makes it easy to connect APIs for Slack and 2,400+ other apps remarkably fast.

Sending the message with an interactive element

Configuring the source

Filtering interactive events by channel

Filtering interactive events by action_id

Troubleshooting

I’m clicking buttons, but no events are being received

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

1-24of2,400+apps by most popular

Filtering interactive events by `action_id`

1
-
24
of
2,400+
apps by most popular