Discord Advanced icon

Discord Advanced

Advanced Discord tools - Analytics, Moderation, Backup, and Automation
Join our community

Actions32

Overview

This node, part of the Discord Advanced toolset, provides a comprehensive server health report for a specified Discord guild (server). It fetches and analyzes various server metrics such as member counts (total, online, bots, humans), channel counts by type (text, voice, categories), role statistics, server age, verification level, and premium subscription details. This report helps server administrators monitor the overall health and status of their Discord server, enabling informed decisions about server management and community engagement.

Use Case Examples

  1. A Discord server admin wants to get an overview of their server's current health, including how many members are online, how many bots are present, and the distribution of channel types.
  2. A community manager needs to assess the server's role usage and member engagement to plan future moderation and event activities.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) to generate the health report for.
Time Range (Days) Number of days to analyze (1-30), though not specifically used in this operation.
Additional Options Collection of optional parameters such as including bots, minimum messages, spam threshold, etc., though not specifically used in this operation.

Output

JSON

  • guildId - The unique identifier of the Discord guild.
  • guildName - The name of the Discord guild.
  • reportDate - The ISO timestamp when the report was generated.
  • members
    • total - Total number of members in the guild.
    • online - Number of members currently online.
    • bots - Number of bot accounts in the guild.
    • humans - Number of human members (non-bots).
    • onlinePercentage - Percentage of members currently online.
  • channels
    • total - Total number of channels in the guild.
    • text - Number of text channels.
    • voice - Number of voice channels.
    • categories - Number of category channels.
  • roles
    • total - Total number of roles in the guild.
    • withMembers - Number of roles that have members assigned.
  • serverAge
    • days - Number of days since the guild was created.
    • created - ISO timestamp of the guild creation date.
  • verificationLevel - The guild's verification level setting.
  • premiumTier - The guild's premium (boost) tier level.
  • boostCount - Number of premium subscriptions (boosts) the guild has.

Dependencies

  • Discord API
  • An API key credential for Discord bot authentication

Troubleshooting

  • Common issues include invalid or missing Guild ID, which results in failure to fetch guild data.
  • If the bot token credential is invalid or lacks necessary permissions, the node will fail to login or fetch data.
  • Errors related to channel or member fetching may occur if the bot does not have sufficient permissions in the guild.
  • Timeouts or rate limits from the Discord API can cause incomplete data retrieval; consider reducing the number of items processed or adding delays.

Links

Discussion