Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/caldas14/discord-private-messenger

🚀 Powerful Discord bot for mass DM messaging and role communication. Send bulk messages, manage role-based announcements, and track message delivery with ease. Perfect for server administrators and community managers.
https://github.com/caldas14/discord-private-messenger

bot-discord bulk-messaging communication-dm discord-automation discord-bot mass mass-dm mass-dm-bot messaging-automation nodejs role-management server-tools

Last synced: about 2 months ago
JSON representation

🚀 Powerful Discord bot for mass DM messaging and role communication. Send bulk messages, manage role-based announcements, and track message delivery with ease. Perfect for server administrators and community managers.

Awesome Lists containing this project

README 

        
# Discord Private Messenger Bot






![Discord Bot](https://img.shields.io/badge/Discord-Bot-7289DA?style=for-the-badge&logo=discord&logoColor=white)

![Node.js](https://img.shields.io/badge/Node.js-43853D?style=for-the-badge&logo=node.js&logoColor=white)

![Status](https://img.shields.io/badge/Status-Active-success?style=for-the-badge)



---



**🚀 The Ultimate Discord Mass DM & Role Communication Bot**



Streamline your server communication with this powerful Discord bot! Send mass DMs, role-specific messages, and server-wide announcements with ease. Perfect for community managers, event organizers, and server administrators.



**Key Features:**

- 📨 Mass DM to all server members

- 👥 Role-targeted messaging

- 📊 Delivery tracking & reports

- 🛡️ Permission-based access

- ⚡ Fast & efficient delivery

- 🔒 Secure & configurable



[Getting Started](#-installation) • [Features](#-features) • [Documentation](#-usage) • [Security](#-security-considerations)



---






## 📜 Overview



This Discord bot is a powerful tool for mass messaging and server communication. It enables server administrators and support team members to:



- Send mass DMs to all server members

- Target specific roles for bulk messaging

- Send private announcements to selected groups

- Automate member communication efficiently

- Track message delivery status



Whether you need to send server-wide announcements, role-specific communications, or bulk DMs to selected members, this bot provides a simple and interactive way to manage mass messaging without the hassle of sending messages individually.



### Alternative Names

- Discord Mass DM Bot

- Server-wide Messaging System

- Role-based DM Manager

- Bulk Message Sender

- Member Communication Bot

- Discord Announcement System

- Mass Private Messaging Tool

- Role Message Dispatcher

- Server Member DM Bot



## ✨ Features



### Mass Messaging Capabilities

- **Server-wide DMs**: Send messages to all members in your server

- **Role-Based Messaging**: Target specific roles for focused communication

- **Bulk Message Delivery**: Efficiently handle mass message distribution

- **Smart Member Filtering**: Automatically handles users with closed DMs



### User Experience

- **Interactive Interface**: Select roles and preview messages before sending

- **Message Editing**: Edit your announcements before sending

- **Real-time Preview**: See exactly how your message will look

- **Command Simplicity**: Easy-to-use slash commands



### Administration & Control

- **Permission Management**: Restrict mass messaging to authorized roles

- **Detailed Reports**: Track successful and failed message deliveries

- **User Lists**: See which members received or missed messages

- **Safe Cancellation**: Cancel message sending at any time



### Technical Features

- **Rate Limit Handling**: Smart message queuing system

- **Error Recovery**: Continues sending even if some messages fail

- **Environment Configuration**: Secure token and ID management

- **Scalable Design**: Handles servers of any size



## 🔧 Installation



> Perfect for server owners, community managers, and anyone needing to send mass private messages on Discord!



### Prerequisites



- [Node.js](https://nodejs.org/) 16.9.0 or higher

- [npm](https://www.npmjs.com/) (comes with Node.js)

- A Discord bot token (create one at [Discord Developer Portal](https://discord.com/developers/applications))



### Setup



1. **Clone the repository**

   ```bash

   git clone https://github.com/Caldas14/discord-private-messenger.git

   cd discord-private-messenger

   ```



2. **Install dependencies**

   ```bash

   npm install

   ```



3. **Configure environment variables**

   - Create a `.env` file in the root directory

   - Add the following variables:

     ```env

     # Discord Bot Token

     TOKEN2=your_discord_bot_token_here

     

     # Server (Guild) ID where the bot will operate

     GUILD_ID=your_discord_server_id_here

     

     # Support role ID that has permission to send messages

     CARGO_SUPORTE_ID=your_support_role_id_here

     ```



4. **Invite the bot to your server**

   - Go to the [Discord Developer Portal](https://discord.com/developers/applications)

   - Select your application

   - Go to OAuth2 > URL Generator

   - Select the following scopes: `bot`, `applications.commands`

   - Select the following bot permissions: `Send Messages`, `Embed Links`, `Use Slash Commands`

   - Copy and open the generated URL to invite the bot to your server



5. **Start the bot**

   ```bash

   npm start

   ```



## 🚀 Usage



> Send mass DMs, make server-wide announcements, or communicate with specific roles - all with simple commands!



### Commands



- **`/message`**: Starts the process of sending a message to a role

  - Required parameter: `content` - The message you want to send

  - Only members with the support role can use this command



- **`/cancel`**: Cancels an active message interaction

  - Useful if you need to abort the current operation

  - Only members with the support role can use this command



- **`/help`**: Displays all available commands and their descriptions



### Workflow



1. Use `/message` with your message content

2. Select the role you want to send the message to

3. Preview your message and confirm or edit it

4. After sending, view the delivery report showing successful and failed deliveries



### Message Delivery Report



After sending a message, the bot provides a detailed report showing:

- Number of members who received the message

- Number of members who didn't receive the message

- List of users who didn't receive the message (usually because they have DMs disabled)

- The content of the sent message



## ⚙️ Configuration Options



### Basic Settings

- **Minimum Role Size**: The bot will only show roles with at least 2 members

- **Support Role**: Only members with this role can send messages (configured in `.env`)



### Use Cases

- **Server Announcements**: Send important updates to all members

- **Role Communications**: Target specific groups like VIP members, supporters, or staff

- **Event Notifications**: Inform participants about upcoming events

- **Team Coordination**: Send private instructions to staff members

- **Member Updates**: Notify users about role changes or permissions

- **Community Engagement**: Send personalized messages to active members



## 🔒 Security Considerations



- Keep your `.env` file secure and never commit it to version control

- The bot only sends messages to users who allow DMs from server members

- All message sending actions require explicit confirmation



## 🛠️ Troubleshooting



### Common Issues



- **Bot doesn't respond to commands**: Make sure the bot has the necessary permissions and is online

- **Commands not showing up**: It may take up to an hour for slash commands to register globally

- **Users not receiving messages**: They likely have DMs from server members disabled



### Logs



The bot logs all important events to the console, including:

- Bot startup

- Command registrations

- Message deliveries (successful and failed)



## 📋 License



This project is licensed under the MIT License - see the LICENSE file for details.



## 👨‍💻 Author



**Felipe Caldas** ([@felipecaldass](https://github.com/Caldas14))



---






**Made with ❤️ by Felipe Caldas**