Actions32
- Analytics Actions
- Moderation Actions
- Backup Actions
- Automation Actions
- Insights Actions
Overview
This node provides advanced moderation tools for Discord servers, specifically focusing on checking user warning history among other moderation-related operations. It connects to a Discord server (guild) using a bot token and performs various analyses and actions such as detecting spam, finding duplicate messages, scanning for links, detecting mass mentions, and scanning for inactive members. The 'Check User Warnings' operation allows server moderators to review warning histories of users to help manage and moderate the community effectively. This node is beneficial for server administrators who want to automate and enhance their moderation capabilities, ensuring a safer and more organized server environment.
Use Case Examples
- A server moderator uses the 'Check User Warnings' operation to retrieve and review warning histories of users who have been flagged for rule violations in the past 30 days.
- A community manager employs the node to detect spam messages and mass mentions in a specific channel to quickly address disruptive behavior.
- An admin runs an inactive member scan to identify users who have not participated in the server for a set number of days, helping to clean up the member list.
Properties
| Name | Meaning |
|---|---|
| Guild ID | The ID of the Discord server (guild) where the moderation actions or checks will be performed. |
| Time Range (Days) | The number of days to analyze user activity or warnings, ranging from 1 to 30 days. |
| Additional Options | A collection of optional parameters to customize the moderation checks, including whether to include bots, minimum messages for analysis, inclusion of attachments, spam threshold, inactive days to flag users, and maximum items to process. |
Output
JSON
guildId- The ID of the Discord server where the operation was performed.inactiveDays- Number of days used to determine inactivity for user scans.totalMembers- Total number of members in the guild.inactiveCount- Number of inactive members identified.inactiveMembers- List of inactive members with details such as user ID, username, nickname, join date, days since joining, and roles.channelId- The ID of the channel analyzed for spam, duplicates, links, or mass mentions.totalMessages- Total number of messages analyzed in the channel.spamGroups- Number of groups of similar messages flagged as spam.spamMessages- Details of spam messages including content, count, message IDs, authors, and timestamps.duplicateCount- Number of duplicate messages found in the channel.duplicates- Details of duplicate messages including original and duplicate message information.messagesWithLinks- Number of messages containing URLs.totalLinks- Total number of links found in messages.uniqueDomains- Number of unique domains extracted from links.domains- List of unique domains found in messages.massMentionCount- Number of messages with mass mentions detected.messages- Details of messages with mass mentions including message ID, author, content snippet, mention counts, and timestamps.
Dependencies
- Discord API
- A bot token credential for Discord API authentication
Troubleshooting
- Ensure the provided Guild ID and Channel ID are correct and that the bot has the necessary permissions to access the guild and channels.
- If the node throws errors about channels not being text-based, verify that the channel IDs correspond to text channels and not voice or category channels.
- For operations involving message fetching, the bot must have the 'Read Message History' permission in the relevant channels.
- Timeouts or incomplete data may occur if the Discord API rate limits are exceeded; consider reducing the 'maxLimit' or the number of messages fetched.
- Errors related to user or role fetching may occur if the bot lacks 'Manage Members' or 'View Members' permissions.
Links
- discord.js Client Documentation - Official documentation for the Discord.js Client used to interact with the Discord API.
- Discord Developer Portal - Official Discord API documentation and developer resources.