Actions32
- Analytics Actions
- Moderation Actions
- Backup Actions
- Automation Actions
- Insights Actions
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
- A server admin wants to analyze voice channel usage over the past 7 days to identify peak times and active users.
- A community manager needs to generate a report on voice activity including bot participation to assess overall engagement.
- 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.