WhatsApp Command Channel
PERSONAL WHATSAPP COMMAND CHANNEL

Your automations,
in your pocket.

Turn your own WhatsApp into a private command-and-notification channel for your automations.

A tiny, self-hosted bridge: message yourself on WhatsApp to trigger your scripts, and let your scripts message you back. One socket, file-based inbox/outbox, pair once with your number — no business API, no third-party server.

whatsapp self-hosted no-business-api notifications command-channel $0
what it does

A command channel in three files.

01 / PAIR

Your number, once

Run the connect step with your phone number to get an 8-digit pairing code (or scan a QR). The session is stored locally and reused — you never pair again.

02 / RECEIVE

Message yourself

Anything you send to your own WhatsApp lands in an inbox file. A lightweight watcher fires your handler the moment it arrives — no polling, no cost.

03 / REPLY

Scripts talk back

Your automations drop a line in the outbox and the daemon sends it to you. Notifications, alerts, command acknowledgements — straight to your phone.

quickstart

Up and running in a clone.

Every value comes from .env. Nothing here is tied to any account — bring your own.

# 1. install
npm install

# 2. set your number, then pair once (prints an 8-digit code)
cp .env.example .env      # put YOUR number in WA_TO
node connect.cjs --pair=15551234567

# 3. run the bridge — daemon + watcher
node wa-daemon.cjs &     # holds the connection
node wa-watch.cjs        # fires your handler on each message