Versions Compared

Key

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

In this article

Table of Contents
maxLevel2
absoluteUrltrue

Overview

Use this Snap to edit messages you have sent to a user, private group/channel or a public channel. The Snap instantly updates the messages.

Image RemovedImage Added

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 app. See Scopes for more information 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.

To

For Bot Token Accounts
(scope)

For User Token Accounts
(user_scope)
Post messages in approved channels & conversationschat:writechat:write
Start direct messages with peopleim:writeim:write
Read direct messages based on their IDsim:readim:read
View lists of channels and users to select fromusers:readusers:read

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 Input and Output

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min: 0
  • Max: 1
  • Mapper
  • JSON Generator
  • Search (Slack)
  • Copy
  • Sort
A document containing the updated message and one or more timestamps of the original messages.
Output

Document

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

A document containing details of the updates made to one or more respective messages.

Snap Settings

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Insert excerpt
File Writer
File Writer
nopaneltrue
Update MessageUpdate Message
Target TypeDrop-down list

Select one of an option from the following options available in this drop-down list. The label and suggestions for the next field change based on the option selected from this drop-down list.

Public Channel:

list of permitted Target Types and specify the corresponding details needed:

  • Public Channel. To update the message sent to one of the public channels in the workspace. (Next label: Channel) Requires Channel.
  • Private Channel/Group:. To update the message sent to a private channel or group within the workspace. You must be a participant of the respective channel or group. (Next label: Channel)Requires Channel.
  • Users: . To update the message sent to one or more individual users. (Next label: Users)Requires Users.
Public ChannelPrivate Channel/Group
Channel / UsersString/Expression/SuggestionThis label displays as either Channel or Users and the field refreshes the list of suggested values for the field based on the Target Type selected. Select a recipient

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

Click the Image Added icon and select a channel from the suggested values. To add more

recipients

channels, enter comma-separated values manually in one of the following formats: 

  • Channel:#channel#channel.name:<11-character alphanumeric channel ID> OR#channel
  • #channel.name name OR
  • <11-character alphanumeric channel ID>
N/A#testprivate:G019B3ETYMB
UsersString/Expression/Suggestion

Required for Target Type - Users

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@user.name:<11-character alphanumeric user ID> OR@user
  • @user.name name OR
  • @<11-character alphanumeric user ID>
N/A#testprivate:G019B3ETYMB
OR 
@user@user.name:W01A94P7MK1
TimestampString/Expression/SuggestionRequired. To edit the message you sent earlier, enter or pass its Epoch timestamp.N/A1601469028
New MessageString/Expression/SuggestionRequired. Enter the updated message to send to same set of 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/AHi there!
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

Troubleshooting

ErrorReasonResolution

Unable to update the message with the given target and timestamp: message_not_found

The Snap cannot locate the target message to update it.

Ensure that the Channel and Timestamp provided correspond to a valid message that exists before running the Pipeline again.

Input error: Target (user/channel) missingYou have not supplied either the Channel or the Timestamp for the target message to update it.Ensure that you provide the required parameters to delete the message before running the Pipeline again.

Examples

Updating/

...

Editing a Message Already Sent

This example demonstrates how we can use the Send Message and Update Message Snaps to send update 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 timestamp of the original message. The same can be done for multiple messages, at once.

...

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.

...

Insert excerpt
Slack Snap Pack (Doc in Progress)
Slack Snap Pack (Doc in Progress)
nopaneltrue

...

See Also