whatsapp-tagall

A simple WhatsApp bot that automatically mentions all participants in a group when someone sends the exact message "@all". It uses the @whiskeysockets/baileys library for WhatsApp connection and qrcode-terminal for easy authentication right in your terminal.

Requirements

• Node.js (v20+ recommended)
• pnpm (or npm)
• Docker & Docker Compose (optional, for containerized execution)

Note: Baileys is stable using pnpm or npm, if you using bun baileys will not working correctly.

Setup & Running Locally

1. Install dependencies

   pnpm install

2. Compile the TypeScript code

   pnpm run build

3. Start the bot

   pnpm run start

4. Link your device
   • A QR Code will appear in the terminal.
   • Open WhatsApp on your phone, go to Linked Devices, and scan the QR code.
   • Your session will be saved in the session folder.

Running with Docker (Recommended)

To run the bot in the background using Docker and ensure it auto-restarts on failure:

1. Start the container

   docker-compose up -d

2. View the QR code for initial login

   docker logs -f wa-tagall

   (Scan the QR code from the logs. Press Ctrl+C to exit the log view once connected.)

Note: The session folder is mounted as a volume. This means your login state is preserved even if the container is restarted or rebuilt!

How it Works

When a message containing exactly "@all" is sent in a group where the bot is a member (or admin), the bot will fetch the group metadata and reply with a message saying "@all", tagging every single participant in the group.