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.
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.
Bot Token Accounts
|User Token Accounts|
|Post messages in approved channels & conversations|
|Start direct messages with people|
|Read direct messages based on their IDs|
|View lists of channels and users to select from|
Support for Ultra Pipelines
Works in Ultra Pipelines.
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.
Snap Input and Output
|Input/Output||Type of View||Number of Views||Examples of Upstream and Downstream Snaps||Description|
- JSON Generator
- Search (Slack)
|A document containing one or more timestamps of the original messages to be deleted.|
- JSON Formatter
- CSV Parser
A document containing details of one or more messages deleted.
|Parameter Name||Data Type||Description||Default Value||Example |
Specify a name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.
|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 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 Channel||Private Channel/Group|
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
<11-character alphanumeric channel ID>
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
@<11-character alphanumeric user ID>
|Timestamp||String/Expression/Suggestion||Required. To delete one or more messages you sent earlier, enter or pass their Epoch timestamps separated by a comma.||N/A||1601469028.000100|
|Snap Execution||Drop-down list|
Select one of the three following modes in which the Snap executes:
|Execute only||Validate & Execute|
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) missing||You 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.|
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.
This Pipeline uses a set of Pipeline Parameters as depicted in the following image.
We use the Send Message Snap to send a message defined as an expression to a Private Channel.
Search Snap supports a variety of search keywords, besides exact words, like wildcard search (using *, #, and so on), sender, or recipient of the messages and files. We use this feature to perform two different search operations and combine their results to see if our message is retrieved.
So, after sending the message we use the Copy Snap to duplicate the output from Send Message Snap and initiate two Search operations - one based on the wildcard search and another on the sender's name/ID.
|Search by wildcard text||Output|
|Search by Sender||Output|
We combine these search results using a Join Snap to ensure the results contain the message we want to delete.
Now, we connect a Mapper Snap to transform the contain search results data to contain only the Channel ID and the timestamps of the messages. This will enable us filter the results and identify the latest message that we want to delete.
Connect a Delete Message Snap to the Mapper and pass the Channel and Timestamp values to it, to delete the message. The Snap deletes the message and shows the following output.
|Delete Message Snap||Output|
Download this Pipeline.
Important Steps to Successfully Reuse Pipelines
- Download and import the Pipeline into SnapLogic.
- Configure Snap accounts as applicable.
- Provide Pipeline parameters as applicable.
Snap Pack History