Discord Tools icon

Discord Tools

Discord utility tools - Message fetching, user info, and more
Join our community

Actions30

Overview

This node operation fetches the count and status breakdown of online members in a specified Discord guild (server). It is useful for monitoring the activity and presence of members in a Discord community, such as tracking how many members are online, idle, do not disturb, or offline at a given time.

Use Case Examples

  1. A community manager wants to see how many members are currently online in their Discord server to gauge activity levels.
  2. A bot administrator needs to monitor member presence statuses to trigger notifications or events based on online activity.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) from which to retrieve online member information.
Additional Options Optional parameters to customize the operation, though not specifically used in this operation.

Output

JSON

  • guildId - The ID of the guild (Discord server) queried.
  • totalMembers - Total number of members in the guild.
  • onlineCount - Number of members currently online (status not offline).
  • offlineCount - Number of members currently offline.
  • statusBreakdown
    • online - Count of members with 'online' status.
    • idle - Count of members with 'idle' status.
    • dnd - Count of members with 'do not disturb' status.

Dependencies

  • Discord API

Troubleshooting

  • Ensure the provided Guild ID is correct and the bot has permission to access the guild.
  • The bot must have the 'Guild Members' and 'Guild Presences' intents enabled to fetch member presence information.
  • If the bot is not ready or fails to login, check the validity of the Discord API token and network connectivity.
  • Common errors include 'Guild not found' if the Guild ID is invalid or the bot is not a member of the guild.

Links

Discussion