Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

...

Use this Snap to send messages to a fellow team member, group, or channel that you have the permissions to.

Prerequisites

A valid and active account in the Slack workspace.

...

Add Valid Slack Scopes based on the intended operation. See Required Slack Scopes below for details.

Required Slack Scopes

Any action you want to perform within a Slack workspace, additionally needs appropriate Scopes assigned to your appSee the Scope and Permissions article in Slack API documentation for the complete list and each Account page under Configuring Slack Accounts for information on defining Scopes for your app.

...

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Insert excerpt
File Writer
File Writer
nopaneltrue
N/ASend Message
MessageString/ExpressionRequired. Enter the message to send to the recipients. See Formatting Messages for instructions to format your message text in the same manner as allowed in the web/desktop versions of Slack, using markup syntaxes.N/AHello there!
Target TypeDrop-down list

Select an option from the following list of permitted Target Types and specify the corresponding details needed:

  • Public Channel. To send the message to one of the public channels in the workspace. Requires Channel.
  • Private Channel/Group. To send the message to a private channel or group within the workspace. You must be a participant of the respective channel or group. Requires Channel.
  • Users. To send the message to one or more individual users. Requires Users.
Public ChannelPrivate Channel/Group
ChannelString/Expression/Suggestion

Required for Target Types - Public Channel and Private Channel/Group

Select a Click the Image Added icon and select a channel from the suggested values. To add more channels, enter comma-separated values manually in one of the following formats: 

  • #channel.name:<11-character alphanumeric channel ID> OR
  • #channel.name OR
  • <11-character alphanumeric channel ID>
N/A

#testprivate:G019B3ETYMB

UsersString/Expression/Suggestion

Required for Target Type - Users

Select a Click the Image Added icon and select a recipient from the suggested values. To add more recipients, enter comma-separated values manually in one of the following formats: 

  • @user.name:<11-character alphanumeric user ID> OR
  • @user.name OR
  • @<11-character alphanumeric user ID>
N/A@user.name:W01A94P7MK1
Timestamp (if thread reply)String/ExpressionTo reply to a message you received, enter or pass the Epoch timestamp of the received message.N/A1601469028
Broadcast ReplyCheck boxSelect this check box to broadcast a reference to the threaded reply to the parent conversation.Not selectedSelected
Snap ExecutionDrop-down list

Select one of the three following modes in which the Snap executes:

  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled. Disables the Snap and all Snaps downstream from it.

Execute onlyValidate & Execute

...

ErrorReasonResolution
Unable to send the message to the given target. missing_scopeYou have not added/defined the required Slack Scope for your App.Ensure that your App is configured with the required Scopes and that the token and the inputs are valid before running the Pipeline again.
Unable to send the message to the given target. not_in_channelAt least one of the Users you specified is not available in the Channel.Ensure that the user is added to the target Channel/Private group before running the Pipeline again.
Unable to create an interim channel for the given list of users. cannot_dm_botYou have selected a Bot account to send the message to. Hence the Snap is unable to create an interim channel for sending the message to the selected recipients (as it includes the Bot).Ensure that you have selected only individual users and not any Bot for sending the message to. And run the Pipeline again.
Unable to load account definition. Account named "OAuth2SlackAccount_Bot" does not existThe account that you specified for the Snap to connect to Slack workspace is not valid.Update the account details for the Snap and validate the account before running the Pipeline again.
account.property_map.settings.access_token.value: Missing property value, String is too short (0 characters), it must have a minimum of 1 characters The Account settings for the Snap are incorrect. Ensure that you provide/generate a valid User Token in the Snap account before running the Pipeline again.

Examples

Sending a

...

Message and

...

Updating it

This example demonstrates how we can use the Send Message Snap to send messages to one or more recipients. To update a message that you have sent to another Slack user/Channel/private group, you need to use the Update Message Snap to pass the timestamp of the original message. The same can be done for multiple messages, at once.

...