Versions Compared

Key

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

In this article

...

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

TypeFormatNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min: 0
  • Max: 1
  • Mapper
  • JSON Generator
A document with a message to send to a public channel, private channel/group or a user in a workspace.
Output

Document

  • Min: 0
  • Max: 1
  • JSON Formatter
  • CSV Parser

A document containing the output/result for the Send Message operation.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab. The available options are:

  • Stop Pipeline Execution: Stops the current pipeline execution when the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the rest of the records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

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.
  • User Emails: To find user ID with email and then call a slack API to send a message.

Public ChannelPrivate 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.


Note

Specify the Scope as users:read:email in the Slack account to enable the Snap to suggest user emails.


.N/A

user@snaplogic.com
ChannelString/Expression/Suggestion

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

Click the Image Modified 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

Click the Image Modified 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

...

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.

Downloads

Note
titleImportant Steps to Successfully Reuse Pipelines
  1. Download and import the Pipeline into SnapLogic.
  2. Configure Snap accounts as applicable.
  3. Provide Pipeline parameters as applicable.

...