Discord icon

Discord

Interact with Discord API - Full Bot Features

Overview

This node interacts with the Discord API to perform various voice channel operations within a Discord server (guild). Specifically, the 'Undeafen Member' operation allows a bot to remove the server deafen status from a specified user, enabling them to hear audio in voice channels again. This is useful in scenarios where a user was previously server deafened (unable to hear others) and needs to be restored to normal hearing. Practical examples include managing voice channel permissions during events or meetings, or automating moderation tasks in Discord servers.

Use Case Examples

  1. Automatically undeafen a user after a meeting ends to restore their hearing.
  2. Use in moderation workflows to toggle voice permissions for users based on server rules.

Properties

Name Meaning
Guild ID The ID of the Discord server (guild) where the voice operation is performed.
User ID The ID of the user to undeafen in the voice channel.
Additional Fields Optional additional parameters such as embed JSON, text-to-speech flag, reason for audit logs, and other miscellaneous settings that can be used in various operations but are not specifically required for undeafen operation.

Output

JSON

  • success - Indicates if the undeafen operation was successful.
  • userId - The ID of the user who was undeafened.
  • deafened - Boolean indicating the user is no longer deafened (false).

Dependencies

  • Discord API
  • Bot token credential for authentication

Troubleshooting

  • Ensure the bot has appropriate permissions to manage voice states in the guild, including the ability to undeafen members.
  • Verify that the user specified is currently in a voice channel; otherwise, the operation will fail with an error indicating the member is not in a voice channel.
  • Check that the provided Guild ID and User ID are correct and that the bot is a member of the guild.

Links

Discussion