Discord Tools icon

Discord Tools

Discord utility tools - Message fetching, user info, and more
Join our community

Actions30

Overview

This node operation deletes a specific message in a Discord channel within a specified guild (server). It is useful for automating message management tasks such as removing outdated, inappropriate, or unwanted messages from a channel. For example, a community manager can use this node to automatically delete spam messages or clear messages after an event.

Use Case Examples

  1. Deleting a message by its ID in a specific channel and guild to maintain channel cleanliness.
  2. Automating removal of bot messages or user messages that violate community guidelines.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) where the message is located.
Channel ID The ID of the channel within the guild where the message to be deleted is located.
Message ID The ID of the message to be deleted.
Additional Options Optional parameters that can modify the behavior of message operations, though not specifically used in the delete operation here.

Output

JSON

  • success - Indicates if the message deletion was successful.
  • messageId - The ID of the deleted message.
  • deleted - Boolean flag confirming the message was deleted.

Dependencies

  • Discord API accessed via discord.js library

Troubleshooting

  • Channel not found errors: Ensure the provided Guild ID and Channel ID are correct and the bot has access to the channel.
  • Invalid channel type errors: The channel must be text-based; voice or category channels are not supported for message deletion.
  • Channel mismatch errors: The Channel ID must belong to the specified Guild ID.
  • Message not found or already deleted: Verify the Message ID is correct and the message exists in the channel.
  • Bot permissions: The bot must have permission to manage messages in the channel to delete messages.

Links

Discussion