Discord Tools icon

Discord Tools

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

Actions30

Overview

This node provides various Discord utility tools, including advanced analytics and statistics for Discord servers (guilds). Specifically, the 'Top Contributors' operation under the 'Analytics' resource fetches the most active contributors in a specified text channel by counting the number of messages sent by each user (excluding bots by default). This is useful for server administrators or community managers who want to identify and recognize the most engaged members in their Discord channels.

Use Case Examples

  1. A community manager wants to find the top 10 most active users in a specific channel to reward them.
  2. A server admin wants to monitor user engagement trends by analyzing which users contribute the most messages over a period.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) where the channel is located. Required to identify the server context.
Channel ID The ID of the text channel within the guild to analyze for top contributors. Required to fetch messages from the correct channel.
Additional Options Optional parameters to customize the operation, such as including bot messages, filtering messages before or after certain message IDs, case sensitivity, exact match, audit log filters, and limits. These options are generally available but not specifically used in the 'Top Contributors' operation.

Output

JSON

  • id - Message ID of the contributor's message.
  • username - Username of the contributor.
  • count - Number of messages sent by the contributor in the specified channel.

Dependencies

  • Discord API access via a bot token credential

Troubleshooting

  • Ensure the provided Guild ID and Channel ID are correct and that the bot has access to the specified channel.
  • The channel must be a text-based channel; voice or category channels are not supported for this operation.
  • If no messages are found, the output will be an empty list; verify that the channel contains messages and that any filters applied do not exclude all messages.

Links

Discussion