Versions Compared

Key

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

In this article

...

Use this Snap to delete one or messages you have sent to a Public Channel/Private Group/User based on their timestamps.

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/A
Target TypeDrop-down list

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

  • Public Channel. To delete the message sent to one of the public channels in the workspace. Requires Channel.
  • Private Channel/Group. To delete the message sent to a private channel or group within the workspace. You must be a participant of the respective channel or group. Requires Channel.
  • Users. To delete the message sent 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
TimestampString/Expression/SuggestionRequired. To delete one or more messages you sent earlier, enter or pass their Epoch timestamps separated by a comma.N/A1601469028.000100
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

Failure: Unable to delete the message with the given target and timestamp, message_not_found

The Snap cannot locate the target message to delete 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 delete it.Ensure that you provide the required parameters to delete the message before running the Pipeline again.

Examples

Locating a

...

Sent Message Using Search Keywords and Deleting it

To delete a message that was sent, we can locate the sent message and delete it. The same can be done for multiple messages, at once. This example demonstrates how we can use the Search Snap to achieve this result.

...