n8n-nodes-discord-all

Complete Discord Bot integration for n8n with all features - DM, Mentions, Server Management, Roles, Advanced Tools and more!

🚀 Features

4 Powerful Nodes

1. Discord - Basic Discord operations (Regular n8n workflows)

   • Send, edit, delete messages
   • Manage channels, roles, members
   • Server administration
   • Webhooks and invites

2. Discord Tools - AI Agent Tool 🤖 (For AI agents)

   • All-in-one tool for AI agent workflows

   • Messages: Send, edit, delete, fetch, search messages

   • DM: Send direct messages to users

   • User Info: Get detailed user information and avatars

   • Channel Management: Statistics, active users, pins, slowmode

   • Server Analytics: Message heatmaps, top contributors

   • Moderation: Spam detection, duplicate finder

   • Backup: Export messages with full metadata

   • Emoji Management: Create, delete, list custom emojis

   • Audit Logs: Server audit log access

3. Discord Trigger - Real-time event listening

   • Message events (create, update, delete)
   • DM received trigger
   • Bot mentioned trigger
   • User mentioned trigger
   • Role mentioned trigger
   • Reactions, members, roles, channels
   • Voice state, typing events

📦 Installation

npm install n8n-nodes-discord-all

n8n Setup

Add to your n8n environment:

# Community nodes installation
n8n start

# Then in n8n UI:
# Settings → Community Nodes → Install
# Enter: n8n-nodes-discord-all

Or via environment variable:

export N8N_CUSTOM_EXTENSIONS="/path/to/node_modules/n8n-nodes-discord-all"

🎯 Quick Start

1. Setup Discord Bot

1. Go to Discord Developer Portal
2. Create a new application
3. Go to "Bot" section
4. Click "Add Bot"
5. Copy the bot token
6. Enable these Privileged Gateway Intents:
   • Message Content Intent ✅
   • Server Members Intent ✅
   • Presence Intent (optional)

2. Configure n8n Credentials

1. In n8n, go to Credentials
2. Create new "Discord API" credential
3. Paste your bot token
4. Save

3. Create Your First Workflow

Example: DM Auto-Responder

Discord Trigger (DM Received)
  ↓
Discord (Send DM)
  User ID: {{$json["userId"]}}
  Content: "Thanks for your message! We'll get back to you soon."

Example: Bot Mention Handler

Discord Trigger (Bot Mentioned)
  ↓
Code Node (Parse command)
  ↓
Discord (Send Message)
  Channel ID: {{$json["channelId"]}}
  Content: "Hello! How can I help you?"

📚 Documentation

• Complete Usage Guide
• 22 Practical Examples
• DM & Mentions Guide - 12 examples
• Discord Tools Guide - Advanced utilities
• Discord Advanced Guide - Analytics, moderation, backups 🔥

🎨 Use Cases

• Customer Support Bot - Auto-respond to DMs and mentions
• Server Moderation - Auto-delete spam, manage slowmode
• Community Engagement - Welcome messages, role assignment
• Analytics & Reporting - Track server growth, user activity
• Content Monitoring - Search messages, audit logs
• Multi-language Support - Auto-detect and respond in user's language

🔧 Available Operations

Discord Tools (AI Agent Tool 🤖)

• Messages: Send, edit, delete, fetch, search, get mentions, bulk delete
• DM: Send direct messages to users
• Users: Get detailed info, avatars, status, permissions
• Channels: Get stats, active users, pins, webhooks, set slowmode
• Server: Get statistics, online members, audit log, emojis
• Emojis: Create, delete, list custom emojis
• Analytics: Message heatmaps, top contributors
• Moderation: Spam detection, duplicate message finder
• Backup: Export messages with full metadata

Discord Trigger

• Message Created / Deleted / Updated
• DM Received
• Bot Mentioned
• User Mentioned
• Role Mentioned
• Reaction Added / Removed
• Member Joined / Left / Updated
• Role/Channel Created / Deleted / Updated
• Guild Ban Add / Remove
• Voice State Update
• Typing Start

🔐 Required Permissions

Bot Permissions

• Read Messages / View Channels
• Send Messages
• Manage Messages (for deletion)
• Manage Channels (for channel management)
• Manage Roles (for role management)
• Kick/Ban Members (for moderation)
• Read Message History

Gateway Intents (Developer Portal)

• ✅ Message Content Intent (required)
• ✅ Server Members Intent (required)
• Presence Intent (optional, for status)

📖 Example Workflows

Auto-Moderation System

Discord Trigger (Message Created)
  ↓
Code Node (Check for spam)
  ↓
IF Node (Is spam?)
  ↓ true
Discord Tools (Bulk Delete)
  ↓
Discord (Send Warning)

User Activity Dashboard

Schedule Trigger (Daily)
  ↓
Discord Tools (Get Active Users)
  ↓
Code Node (Generate report)
  ↓
Discord (Send Embed Report)

Ticket System

Discord Trigger (Reaction Added) → "🎫"
  ↓
Discord (Create Channel) - Private ticket channel
  ↓
Discord (Send Message) - "How can we help?"

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

MIT © [Your Name]

🐛 Issues

Found a bug? Have a feature request? Please open an issue.

⭐ Support

If you find this package helpful, please give it a star on GitHub!

🔗 Links

• n8n Documentation
• Discord.js Documentation
• Discord Developer Portal

📊 Version History

v2.3.0 (2024-11-21) 🚀

• BREAKING: Simplified to 2 nodes (DiscordTools + DiscordTrigger)
• DiscordTools: Unified AI Agent Tool with all Discord operations
• Removed Discord and DiscordAdvanced nodes (all features now in DiscordTools)
• Complete consolidation for better AI agent integration

v2.2.0 (2024-11-21)

• Added all Discord operations to DiscordTools
• Message send, edit, delete operations
• DM sending capabilities
• Analytics, moderation, and backup features

v2.1.0 (2024-11-21)

• Discord Advanced Node with 15+ operations
• Analytics, moderation, backup features
• DiscordTools enabled as AI Agent Tool

v1.0.0 (2024)

• Initial release
• Complete Discord bot functionality
• DM and mention triggers

Made with ❤️ for the n8n community