In this article
...
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.
Prerequisites
A valid and active account in the Slack Workspace.
Slack Scopes required
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 (Doc in Progress) for information on defining Scopes for your app.
| To | For Bot Token Accounts | For User Token Accounts ( user_scope) |
|---|---|---|
| Post messages in approved channels & conversations | chat:write | chat:write |
| Start direct messages with people | im:write | im:write |
| Read direct messages based on their IDs | im:read | im:read |
| View lists of channels and users to select from | users:read | users:read |
...
None.
Snap Input and Output
| Input/Output | Type of View | Number of Views | Examples of Upstream and Downstream Snaps | Description |
|---|---|---|---|---|
| Input | Document |
|
| A document containing the updated message and one or more timestamps of the original messages. |
| Output | Document |
|
| A document containing details of the updates made to one or more respective messages. |
Snap Settings
| Parameter Name | Data Type | Description | Default Value | Example | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Label | String |
| Update Message | Update Message | ||||||||
| Target Type | Drop-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 | Private Channel/Group | ||||||||
| Channel / Users | String/Expression/Suggestion | This 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. Select a channel from the suggested values. To add more recipientschannels, enter comma-separated values manually in one of the following formats:
| N/A | #testprivate:G019B3ETYMB | ||||||||
| Users | String/Expression/Suggestion | Required for Target Type - Users. Select a recipient from the suggested values. To add more recipients, enter comma-separated values manually in one of the following formats:
| N/A | #testprivate:G019B3ETYMB OR @user@user.name:W01A94P7MK1 | ||||||||
| Timestamp | String/Expression/Suggestion | Required. To edit the message you sent earlier, enter or pass its Epoch timestamp. | N/A | 1601469028 | ||||||||
| New Message | String/Expression/Suggestion | Required. 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/A | Hi there! | ||||||||
| Snap Execution | Drop-down list | Select one of the three following modes in which the Snap executes:
| Execute only | Validate & Execute |
...
| Error | Reason | Resolution |
|---|---|---|
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) missing | You 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. |
...
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...