Actions53
- Message Actions
- Channel Actions
- Thread Actions
- Reaction Actions
- Guild (Server) Actions
- Member Actions
- Role Actions
- Voice Actions
- DM Actions
- Webhook Actions
- Invite Actions
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
- Unpin a specific message in a Discord channel to keep the pinned messages relevant and up-to-date.
- 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
- Discord.js Message.unpin() - Official documentation for the unpin method used to unpin messages in Discord channels.