In this article

Overview

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

Prerequisites

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 app. See 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.

Support for Ultra Pipelines

Works in Ultra Pipelines. 

Limitations

Snaps in this Snap Pack use conditional display/hiding of fields. So, ensure that you always use the New Form UI (and not the classic UI) for the Snaps to function as designed/expected.

Known Issues

None.

Snap Views

Snap Settings

Parameter Name	Data Type	Description	Default Value	Example
Label	String		N/A	Send Message
Message	String/Expression	Required. 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/A	Hello there!
Target Type	Drop-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. User Emails: To find user ID with email and then call a slack API to send a message.	Public Channel	Private Channel/Group
User Emails	String/Expression	Appears when you select User Emails as the Target Type. Specify the emails of the users' separated by commas. When the Snap sends a message, the specified user receives a message on Slack App. Specify the Scope as users:read:email in the Slack account to enable the Snap to suggest user emails.	.N/A	user@snaplogic.com
Channel	String/Expression/Suggestion	Required for Target Types - Public Channel and Private Channel/Group.  Click the  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
Users	String/Expression/Suggestion	Required for Target Type - Users.  Click the  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/Expression	To reply to a message you received, enter or pass the Epoch timestamp of the received message.	N/A	1601469028
Broadcast Reply	Check box	Select this check box to broadcast a reference to the threaded reply to the parent conversation.	Not selected	Selected
Snap Execution	Drop-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 only	Validate & Execute

Troubleshooting

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.

In this example, we use the Send Message Snap to send a message defined as normal text (string) to a user. You can try with sending to a Channel or private group.

Notice that when the Message field is not defined as an expression, the new-line character \n is not rendered as expected. 

We connect a Mapper Snap to capture the timestamp of the message sent. Alternatively, you can feed the timestamp using any other upstream Snap.

Now, to update the original message, connect an Update Message Snap to the Mapper and pass the New Message text, Channel/User and Timestamp values to it. The Snap replaces the original message with this updated message and shows the following output.

Notice that we have defined the New Message field as an expression and that it contains the new-line character \n that renders the message with multiple lines, as expected.

Download this Pipeline.

Add a download link to the Pipeline in the the "Download" text above. Explain the Pipeline/Snap configuration in detail if a complex enough example has been used. Ensure that the functionality you are trying to illustrate is captured correctly. Include caveats as appropriate. To insert link: Press Ctrl + K --> Files --> Select the SLP file corresponding to the example. 

Downloads

Edit the Excerpt Include macro below to link to the Snap Pack page for this Snap page. Ensure that the heading Snap Pack History is not within the Snap Pack's history Excerpt. 

See Also

Provide links to the endpoint's official documentation, any relevant or related internal documentation, and any other links you have referred to on this page. Care should be taken when referencing external sites/documentation that it is an official site/documentation. Do not refer to forums such as stackoverflow.

• Slack Snap Pack
• Start building Slack apps 
• Scopes and Permissions
• Snap Support for Ultra Pipelines
• SnapLogic Product Glossary
• Getting Started with SnapLogic