OmegaBaSMS

Forward WhatsApp group messages to SMS — batched and free.

How it works

• Monitors specified WhatsApp groups via WhatsApp Web
• Queues incoming messages for a configurable interval (default 30s)
• Flushes all queued messages as a single SMS via TextBee (uses your Android phone's mobile plan)
• If the WhatsApp session expires, sends the QR code to Telegram for easy re-auth

Requirements

• Node.js 18+
• Android phone with mobile plan (for TextBee)
• Telegram account (for QR re-auth notifications)

Setup

1. TextBee (SMS Gateway)

1. Create a free account at textbee.dev
2. Install the TextBee app on your Android phone
3. In the dashboard, register your device (scan QR with the app)
4. Copy your Device ID and API key

2. Telegram Bot (QR re-auth)

1. Open Telegram, search for @BotFather, send /newbot
2. Choose a name and username, get the bot token
3. Message your bot once, then visit: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
4. Copy your chat ID from the response

3. Configuration

Copy the example env file and fill in your details:

cp .env.example .env

# WhatsApp groups to monitor (comma-separated)
GROUP_NAMES=MyGroup,AnotherGroup

# TextBee
TEXTBEE_DEVICE_ID=your_device_id
TEXTBEE_API_KEY=your_api_key
SMS_RECIPIENT=+972501234567

# Telegram
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

# Batch settings (30s for testing, 900000 = 15min for production)
BATCH_INTERVAL_MS=30000
BATCH_MAX_CHARS=700

# Your name shown in forwarded messages
INCLUDE_OWN_MESSAGES=true
OWN_NAME=Dvir
OWN_LAST_NAME=

4. Run

npm start

On first run, scan the QR code with WhatsApp on your phone. The session is saved for next time.

Log format

[12:34:56] [INIT] Starting OmegaBaSMS...
[12:34:56] [INIT] Launching WhatsApp Web...
[12:34:58] [QR] New QR code received — scan with WhatsApp
[12:35:10] [READY] WhatsApp connected successfully
[13:01:23] [QUEUE] Queue #1 - Message from Dvir, flushed at 13:16
[13:16:23] [INFO] Flushed 2 messages

Batch messaging

Messages are queued and flushed together to avoid SMS spam:

[GroupName]
Dvir: Hey everyone
Dudi: What's up?
Dvir: Meeting at 5

Project structure

OmegaBaSMS/
├── index.js       # Main — WhatsApp client, queue, logging
├── config.js      # Reads from .env
├── sms.js         # TextBee API
├── telegram.js    # Telegram notification
├── .env           # Your secrets (git-ignored)
├── .env.example   # Template
└── package.json