Slack Interactivity

Using Slack Interactivity

Using Slack Interactivity allows the user to influence the flow of a Workflow. There are two ways you can use the Slack Interactivity action: by Sending a message to a Slack channel or by Updating an existing message in a Slack channel. Once the message is received via the designated Slack channel, a person can interact with the received message.

note

• It is highly recommended to use the Slack Block Kit Builder to compose and view your blocks before running the action.

• The blocks passed to Slack Interactivity steps must include at least one actions block with a button element. Such button elements should have their value field set to a not empty, unique value.

• Input blocks must have their block ids set to a not empty, unique value.

• The only interactive element that is supported is a button element, and it should reside inside an actions block as described above. Including interactive button elements inside other blocks (e.g. accessory of a section block) will not block/fail the execution of the step, but will cause an error when the recipient presses the button.

Creating a Send a Message Step:

1. Search and select the Slack Interactivity Action.

2. You will be presented with two Action Type options: Send Message or Update Message. Select the Send Message option.

3. Within this step, enter the following parameters:

   Parameter	Description
   Action Type	Choose the Send Message or Update Message Action Type.
   To	The recipients email address or Slack channel.
   Blocks	Array of blocks that compose the message. Must include at least one action block.
   Timeout in minutes (optional)	Timeout in minutes for the recipient to respond.
   Response message	A message the recipient of the message will receive after responding.

4. Next, create a Slack connection by navigating to the top-right hand corner of your Step, select Connection required and then select an existing connection or create a new connection by selecting Create new connection.

5. Once these steps are completed, you can select the button to execute a trial run of the step or the test run button to execute a test run of your Workflow. The following phases in this guide refer to testing Slack Interactivity.

6. When this Workflow is executed, the designated Slack channel you have entered in the text field, will receive the message.

info

Upon recipient interaction (triggered by action button clicks), the system collects values from all input blocks, allowing the Workflow to resume from the paused step.

7. Subsequently, you will have the option to engage with the message by writing a response and then pressing the submit button.

note

Once the recipient clicks the submit button, the message will be updated to Processing your response.... It is up to the creator of the Workflow to decide what to do with the interaction.

8. You can then navigate back to your Workflow where you can find your Slack-written response in the output of your Workflow.

Creating an Update a Message Step:

1. Progressing further, you also have the ability to update your original message by selecting the Update Message action type.

2. You will be presented with two Action Type options: Send Message or Update Message. Select the Update Message option.

3. Enter the following parameters in your step.

   Parameter	Description
   Action Type	Choose the Send Message or Update Message Action Type.
   Channel ID	The ID of the channel.
   To	The recipients email address.
   Blocks	Array of blocks that compose the message. Must include at least one action block.
   Timestamp (ts)	Timestamp of the message to be updated.
   Timeout in minutes (optional)	Timeout in minutes for the recipient to respond.
   Response message	A message the recipient of the question will receive after responding.

note

Please note, when using the Update Message action, you must use the channel and ts(TimeStamp) values above from the output of the response message created in your Slack channel.

6. Upon revisiting your Slack channel, you will notice that the message reflects the most recent adjustments you made to the message within the blocks section of your Workflow: