Discord icon

Discord

Interact with Discord API - Full Bot Features

Overview

This node interacts with the Discord API to perform various operations related to Discord messages, specifically including the ability to unpin a message from a channel. It is useful for managing message states in Discord channels, such as sending, editing, deleting, reacting, pinning, and unpinning messages. For example, it can be used to automate message management in community servers or to maintain channel organization by unpinning outdated or irrelevant messages.

Use Case Examples

  1. Unpin a specific message in a Discord channel to keep the pinned messages relevant and up-to-date.
  2. Automate message management by unpinning messages after a certain event or time period.

Properties

Name Meaning
Channel ID The ID of the Discord channel where the message is located.
Message ID The ID of the message to be unpinned.
Additional Fields Optional additional parameters such as embed JSON, text-to-speech flag, reason for audit logs, and other message or channel related settings.

Output

JSON

  • success - Indicates if the unpin operation was successful.
  • messageId - The ID of the message that was unpinned.
  • pinned - Boolean indicating the pinned status of the message (false after unpinning).

Dependencies

  • Discord API
  • Bot token credential for authentication

Troubleshooting

  • Ensure the provided Channel ID corresponds to a valid text-based Discord channel; otherwise, the node will throw a 'Channel not found or not text-based' error.
  • Verify the Message ID is correct and the message exists in the specified channel to avoid fetch errors.
  • Check that the bot token credential has the necessary permissions to unpin messages in the channel.
  • Invalid JSON in embed fields will cause errors; ensure JSON is well-formed if used.

Links

Discussion