Overview

This node provides advanced analytics for Discord servers, specifically focusing on identifying peak activity times within a guild. It analyzes message activity across all text-based channels over a specified time range, optionally including or excluding bot messages. The node aggregates message counts by hour of the day and day of the week to determine the peak hour and peak day of activity. This is useful for server administrators to understand when their community is most active, enabling better scheduling of events or announcements.

Use Case Examples

1. A Discord server admin wants to find out the busiest hours and days in their server over the past week to schedule community events.
2. A community manager wants to analyze message activity trends to optimize posting times for announcements.

Properties

Output

JSON

• guildId - The ID of the analyzed Discord guild.
• peakHour - The hour of the day with the highest message activity, formatted as 'HH:00 (message count)'.
• peakDay - The day of the week with the highest message activity, formatted as 'Day (message count)'.
• hourlyDistribution - An object mapping each hour of the day (0-23) to the number of messages sent during that hour.
• dailyDistribution - An object mapping each day of the week to the number of messages sent on that day.

Dependencies

• Discord API with bot token authentication

Troubleshooting

• Ensure the provided Guild ID is correct and the bot has access to the guild.
• Verify the bot has permissions to read messages in the channels to be analyzed.
• If the channel is not text-based or does not exist, the node will throw an error.
• Large servers with many messages may hit rate limits or take longer to process; consider adjusting the maxLimit option.

Links

• Discord Developer Documentation - Official documentation for Discord API and bot development.