Discord Advanced icon

Discord Advanced

Advanced Discord tools - Analytics, Moderation, Backup, and Automation

Overview

This node provides advanced analytics and insights for Discord servers, specifically focusing on the 'Voice Activity Report' operation under the 'Insights' resource. It analyzes voice channel usage within a specified Discord guild (server) over a configurable time range and with additional options such as including bot activity, minimum message thresholds, and limits on processed items. This node is useful for server administrators and community managers who want to understand voice channel engagement and activity patterns in their Discord servers.

Use Case Examples

  1. A server admin wants to analyze voice channel usage over the past 7 days to identify peak times and active users.
  2. A community manager needs to generate a report on voice activity including bot participation to assess overall engagement.
  3. An analyst wants to filter voice activity data to exclude users with fewer than a minimum number of messages and limit the report size for performance.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) to analyze voice activity for.
Time Range (Days) Number of days to analyze voice activity, ranging from 1 to 30 days.
Additional Options Optional parameters to customize the analysis, including whether to include bot activity, minimum messages for analysis, whether to include attachments, spam threshold, inactive days to flag users, and maximum items to process.

Output

JSON

  • guildId - The ID of the Discord server analyzed.
  • timeRange - The number of days over which the voice activity was analyzed.
  • voiceActivityData - Aggregated data and statistics about voice channel usage, including user activity and engagement metrics.

Dependencies

  • Discord API access via a bot token credential

Troubleshooting

  • Ensure the provided Guild ID is correct and the bot has permissions to access the guild and its voice states.
  • The bot token credential must be valid and have appropriate intents enabled, including Guilds, GuildVoiceStates, and GuildMembers.
  • If the node fails to fetch data, check Discord API rate limits and bot permissions.
  • Errors related to channel or guild fetching usually indicate missing permissions or incorrect IDs.

Discussion