Discord Tools icon

Discord Tools

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

Actions30

Overview

This node operation fetches pinned messages from a specified Discord channel within a given guild (server). It is useful for retrieving important or highlighted messages that have been pinned by users or moderators in a channel. For example, a community manager might use this to gather all pinned announcements or rules in a channel for review or archival purposes.

Use Case Examples

  1. Fetch all pinned messages from a specific channel in a Discord server to display them in a dashboard.
  2. Retrieve pinned messages to analyze important communications or announcements in a community channel.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) where the channel is located.
Channel ID The ID of the channel from which to get pinned messages.
Additional Options Optional parameters to customize the operation, such as including bot messages or filtering by message IDs, though not specifically used in the 'Get Pins' operation.

Output

JSON

  • id - ID of the pinned message.
  • content - Content text of the pinned message.
  • author
    • id - ID of the author who pinned the message.
    • username - Username of the author who pinned the message.
  • createdTimestamp - Timestamp when the message was created.
  • url - URL link to the pinned message.

Dependencies

  • Discord API accessed via discord.js library using a bot token credential

Troubleshooting

  • Ensure the bot token credential is valid and has permissions to access the specified guild and channel.
  • Verify that the Guild ID and Channel ID are correct and that the channel is text-based (not voice or category).
  • Common error: 'Channel not found' indicates the bot cannot access the channel or the IDs are incorrect.
  • Common error: 'Channel is not text-based' means the operation was attempted on a non-text channel, which is unsupported.

Links

Discussion