Slack Chat actions

preview

We're still working on this feature, but we'd love for you to try it out!

This feature is currently provided as part of a preview program pursuant to our pre-release policies.

This page provides a comprehensive reference for slack chat actions available in the workflow automation actions catalog. These actions enable you to slack messaging operations.

Prerequisites

Before using communication actions in workflow automation, ensure you have:

A Slack workspace with appropriate permissions.
A Slack bot token configured as a secret in workflow automation.
Access to the Slack channels where you want to send messages.

See Add Slack configuration for information on how to set up Slack integration.

Slack actions

Sends a message to a slack channel, with an optional file attachment.

Input Field	Optionality	Type	Description	Example
token	Required	Secret	The Slack bot token to use. This should be passed as a secret syntax. Refer to Add Slack configuration for instructions on setting up a token.	`${{ :secrets:slackToken }}`
channel	Required	String	The name of the channel, or a channelID, to send the message. See Slack API for more information.	`my-slack-channel`
text	Required	String	The message to be posted to Slack in the specified `channel`.	`Hello World!`
threadTs	Optional	String	Timestamp belonging to parent message, used to create a message reply in a thread.	`<digits>.<digits>`
attachment	Optional	Map	Allows attaching a file with a message onto the specified `channel`.
attachment.filename	Required	String	Specify the filename for the uploaded file in Slack.	`file.txt`
attachment.content	Required	String	The content of the file to upload as UTF8.	`Hello\nWorld!`
selectors	Optional	List	The selectors to get the only specified parameters as output.	`[{\"name\": \"threadTs\", \"expression\": \".threadTs\"}, {\"name\": \"channelID\", \"expression\": \".channelID\")\"}]`

Output Field	Type	Description	Example
threadTs	String	Timestamp of the message thread. May be used in future `postMessage` calls to post a reply in a thread.	`<digits>.<digits>`
channelID	String	Id of the channel where message is posted.	`<string>`
success	Boolean	Status of the request	`true / false`
errorMessage	String	Failure reason as message	`<string>`

Example 1: Send slack message

Workflow example
`name: SendMessage steps: - name: send_slack_message type: action action: slack.chat.postMessage version: 1 inputs: token: ${{ :secrets:dn_staging_slack_token }} channel: ${{ .workflowInputs.channel }} text: ${{ .workflowInputs.text }} selectors: - name: threadTs expression: ".threadTs" - name: channelID expression: ".channelID"` Inputs: { "inputs": [ { "key": "channel", "value": "test-channel-workflow" }, { "key": "text", "value": "This is my message with bold text and `code backticks`" } ] } Expected output: `[ { "threadTs": "1718897637.400609", "channelID": "C063JK1RHN1" "success": true } ]`

Workflow example

name: SendMessage

  steps:
    - name: send_slack_message
      type: action
      action: slack.chat.postMessage 
      version: 1
      inputs:
        token: ${{ :secrets:dn_staging_slack_token }}
        channel: ${{ .workflowInputs.channel }}
        text: ${{ .workflowInputs.text }}
        selectors:
          - name: threadTs
            expression: ".threadTs"
          - name: channelID
            expression: ".channelID"

Inputs:

{
  "inputs": [
    {
      "key": "channel",
      "value": "test-channel-workflow"
    },
    {
      "key": "text",
      "value": "This is my message *with bold text* and `code backticks`"
    }
  ]
}

Expected output:

[
    {
      "threadTs": "1718897637.400609",
      "channelID": "C063JK1RHN1"
      "success": true
    }
  ]

Example 2: Attach a file

Workflow example
`name: SendFileMessage steps: - name: postCsv type: action action: slack.chat.postMessage version: 1 inputs: token: ${{ :secrets:dn_staging_slack_token }} channel: test-channel-workflow text: "Please find the attached file:" attachment: filename: 'file.txt' content: "Hello\nWorld!"` Expected output: `[ { "threadTs": "1718897637.400609", "channelID": "C063JK1RHN1" "success": true } ]`

Workflow example

name: SendFileMessage

  steps:

    - name: postCsv
      type: action
      action: slack.chat.postMessage
      version: 1
      inputs:
        token: ${{ :secrets:dn_staging_slack_token }}
        channel: test-channel-workflow
        text: "Please find the attached file:"
        attachment:
          filename: 'file.txt'
          content: "Hello\nWorld!"

Expected output:

[
    {
      "threadTs": "1718897637.400609",
      "channelID": "C063JK1RHN1"
      "success": true
    }
  ]

Get a reaction of a message from Slack channel.

Input Field	Optionality	Type	Description	Example
token	Required	Secret	The Slack bot token to use. This should be passed as a secret syntax. Refer to Add Slack configuration for instructions on setting up a token.	`${{ :secrets:slackToken }}`
channelID	Required	String	The channelID, to get the message reactions. See `reactions.get` method	`C063JK1RHN1`
timeout	Optional	Int	The time in seconds for how long to wait for any reaction. Default is 60s, maximum allowed is 600s (10min).	60
threadTs	Required	String	Timestamp belonging to message, used to get reaction of that message.	`<digits>.<digits>`
selectors	Optional	List	The selectors to get the only specified parameters as output.	`[{\"name\": \"reactions\", \"expression\": \".reactions \"}]`

Output Field	Type	Description	Example
reactions	List	List of elements with all the reactions captured or an empty list if timeout occurred.	`<list>`
success	Boolean	Status of the request	`true / false`
errorMessage	String	Failure reason as message	`Invalid slack token`

Example 1: Slack get reactions

Workflow example
`name: GetReactions steps: - name: getReactions type: action action: slack.chat.getReactions version: 1 inputs: token: ${{ :secrets:dn_staging_slack_token }} channelID: ${{ .steps.promptUser.outputs.channelID }} threadTs: ${{ .steps.promptUser.outputs.threadTs }} timeout: ${{ .workflowInputs.timeout }} selectors: ${{ .workflowInputs.selectors }}` Inputs: `{ "inputs": [ { "key": "channelID", "value": "C063JK1RHN1" }, { "key": "threadTs", "value": "1718897637.400609" }, { "key": "selectors", "value": "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]" } ] }` Outputs: `[ { "name": "grinning", "users": [ "W222222" ], "count": 1 }, { "name": "question", "users": [ "W333333" ], "count": 1 } ] or if it is timed out, []`

Workflow example

name: GetReactions

  steps:
      - name: getReactions
      type: action
      action: slack.chat.getReactions
      version: 1
      inputs:
        token: ${{ :secrets:dn_staging_slack_token }}
        channelID: ${{ .steps.promptUser.outputs.channelID }}
        threadTs: ${{ .steps.promptUser.outputs.threadTs }}
        timeout: ${{ .workflowInputs.timeout }}
        selectors: ${{ .workflowInputs.selectors }}

Inputs:

{
  "inputs": [
    {
      "key": "channelID",
      "value": "C063JK1RHN1"
    },
    {
      "key": "threadTs",
      "value": "1718897637.400609"
    },
    {
      "key": "selectors",
      "value": "[{\"name\": \"reactions\", \"expression\": \".reactions \"}]"
    }
  ]
}

Outputs:

[
              {
                  "name": "grinning",
                  "users": [
                      "W222222"
                  ],
                  "count": 1
              },
              {
                  "name": "question",
                  "users": [
                      "W333333"
                  ],
                  "count": 1
              }
          ]

  or if it is timed out,
  []

preview

Prerequisites.css-21sua1{background:none;border:none;width:0;padding:0;}

Slack actions

Get a reaction of a message from Slack channel

Prerequisites