Discord Advanced icon

Discord Advanced

Advanced Discord tools - Analytics, Moderation, Backup, and Automation
Join our community

Actions32

Overview

This node provides advanced analytics and engagement analysis for Discord servers (guilds). Specifically, the 'Channel Engagement Analysis' operation analyzes engagement metrics across all text-based channels in a specified Discord guild. It fetches recent messages from each channel, calculates metrics such as message count, unique users, reaction count, and an overall engagement score, then identifies the most and least engaged channels. This is useful for server administrators or community managers who want to understand which channels are most active and engaging, helping them optimize content and community interaction.

Use Case Examples

  1. A Discord server admin wants to identify which channels have the highest user engagement to focus community events or announcements there.
  2. A community manager analyzes engagement scores to decide which channels need more moderation or content improvement.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) to analyze.
Channel ID The ID of a specific channel (not used in this operation but available in others).
Time Range (Days) Number of days to analyze (1-30), though not directly used in this operation's logic for channel engagement.
Additional Options Optional parameters to customize analysis, such as including bot activity, minimum messages, attachment inclusion, spam threshold, inactive days, and max limit for processing.

Output

JSON

  • guildId - The ID of the Discord guild analyzed.
  • totalChannels - Total number of text-based channels analyzed.
  • channels - Array of channel engagement data objects, each containing channelId, channelName, messageCount, uniqueUsers, reactionCount, and engagementScore.
  • mostEngaged - The channel with the highest engagement score.
  • leastEngaged - The channel with the lowest engagement score.

Dependencies

  • Discord API accessed via discord.js library

Troubleshooting

  • Ensure the provided Guild ID is correct and the bot has permissions to access the guild and its channels.
  • Channel must be text-based for message fetching; otherwise, an error is thrown.
  • The bot token credential must be valid and have appropriate scopes to fetch guild data and messages.
  • If the bot is not ready or fails to login, the node will not execute properly.

Links

Discussion