Actions32
- Analytics Actions
- Moderation Actions
- Backup Actions
- Automation Actions
- Insights Actions
Overview
This node provides advanced Discord server management tools, including analytics, moderation, backup, automation, and insights. Specifically, the 'Inactive Member Scan' operation under the 'Moderation' resource identifies members in a Discord guild who have been inactive for a specified number of days. It helps server administrators monitor and manage inactive users by flagging those who have not engaged within the set inactivity period, optionally including or excluding bots, and limiting the number of results processed.
Use Case Examples
- A server admin wants to find members who have not posted or interacted in the last 30 days to consider for removal or re-engagement campaigns.
- A moderation team uses the scan to identify inactive users to clean up the member list and improve server activity metrics.
Properties
| Name | Meaning |
|---|---|
| Guild ID | The ID of the Discord server (guild) to scan for inactive members. |
| Time Range (Days) | Number of days to analyze (1-30), used in some analytics operations but not directly in inactive scan. |
| Additional Options | Collection of optional parameters to customize the scan, including whether to include bots, minimum messages, attachment inclusion, spam threshold, inactive days threshold, and maximum items to process. |
Output
JSON
guildId- The ID of the Discord guild scanned.inactiveDays- The threshold of days of inactivity used to flag members.totalMembers- Total number of members in the guild.inactiveCount- Number of members identified as inactive.inactiveMembers- Array of inactive member details including userId, username, nickname, join date, days since joining, and roles.
Dependencies
- Discord API via discord.js library
- An API key credential for Discord bot authentication
Troubleshooting
- Ensure the provided Guild ID is correct and the bot has permissions to fetch guild members.
- The bot must have the 'Guild Members' intent enabled in Discord developer portal to fetch member data.
- If the bot cannot fetch messages or members, check that it has appropriate permissions in the guild and channels.
- Errors related to channel fetching indicate the channel ID might be invalid or the channel is not text-based.
- Large guilds may require higher rate limits or pagination handling; the maxLimit option helps control processing size.
Links
- discord.js Client Documentation - Official documentation for the Discord.js library used to interact with Discord API.
- Discord Developer Portal - Official Discord developer resources for creating and managing bots and applications.