node-red-contrib-dm-mention-alert 1.0.1
Discord DM mention alert node for Node-RED
node-red-contrib-dm-mention-alert A Node-RED node that detects Discord mentions, role tags, or keywords in messages and sends DM alerts to specified users or roles.
Installation npm install node-red-contrib-dm-mention-alert
Features User Mention Detection - Monitors for when a specific user is @mentioned Role Mention Detection - Monitors for when a specific role is @mentioned Keyword Detection - Monitors for specific words or phrases in messages Dynamic Role Lists - Manage notification lists via Discord commands Admin Commands - Admin users can add/remove users from notification lists Usage Basic Setup Add the DM Mention Alert node to your flow Connect a discord-message node as input Connect a discord-message-manager node as output Configure the node with your trigger type and values Configuration Admin User ID: Discord user ID who can manage role notification lists via commands
Trigger Type: Choose what to monitor:
User Mention - Watches for a specific user mention (@user) Role Mention - Watches for a specific role mention (@role) Keyword/Phrase - Watches for specific text in messages Trigger Value: The user ID, role ID, or keyword to monitor
Recipient Type (Keyword only): Where to send alerts:
Specific User - Send DM to one user Everyone with Role - Send DM to all users in a managed role list Recipient Value (Keyword only): The target user ID or role ID
Discord Admin Commands When configured for "Role Mention" trigger type, the admin user can use these commands:
!add-user - Add a user to the notification list !remove-user - Remove a user from the notification list !userid-list - Show all users in the notification list !clear-user - Clear ALL users from the notification list Example User: !add-user 161944269370818560 Bot: ✅ Added @username to the notification list. Total users: 1
User: !userid-list Bot: 📋 Notification List: 1. @username (161944269370818560) Total: 1 user(s)
User: !remove-user 161944269370818560 Bot: ✅ Removed @username from the notification list. Remaining users: 0 Example Flows Monitor User Mentions Set Trigger Type to User Mention Enter the user ID you want to monitor When that user is mentioned, they receive a DM with details about who mentioned them and where Monitor Role Mentions Set Trigger Type to Role Mention Enter the role ID to monitor Set your Admin User ID Use !add-user to add users to the notification list When the role is mentioned, all users in the list receive DMs Monitor Keywords Set Trigger Type to Keyword/Phrase Enter the keyword (e.g., "urgent", "alert", etc.) Choose recipient type (specific user or role) When the keyword appears in any message, alerts are sent How It Works The node listens for incoming Discord messages and checks them against your configured trigger. When a match is found:
It collects information about the message (author, channel, link) Determines who should receive the alert based on your recipient settings Sends a DM to each recipient with formatted message details including: Who mentioned/triggered the alert Which channel it happened in A direct link to the message Requirements Node-RED node-red-contrib-discord or compatible Discord integration Discord bot with DM permissions License MIT
Support For issues or feature requests, visit the GitHub repository: https://github.com/Casperac/node-red-dm-mention-alert
