🍸 wahelper 🍸

wahelper is a lightweight whatsapp integration layer built on top of baileys that provides a simple cli, php wrapper, and mcp server for fetching messages, sending direct and group messages, and wiring whatsapp into existing tooling (wordpress, node, mcp clients) without having to deal with the full session lifecycle yourself.

requirements

• node >= 22
• php >= 8.1

installation

js

npm install @vielhuber/wahelper

php

composer require vielhuber/wahelper

.gitignore

/whatsapp_data/

usage

start daemon

npx wahelper-daemon --device "xxxxxxxxxxxx"

cli

npx wahelper \
    --device "xxxxxxxxxxxx" \
    ...

    # fetch messages
    --action "fetch_messages" \
    --limit 42

    # send message to user
    --action "send_user" \
    --number "xxxxxxxxxxxx" \
    --message "This is a test! 🚀"
    --attachments "/full/path/to/file.pdf,/full/path/to/image.png"

    # send message to group
    --action "send_group" \
    --name "Group name" \
    --message "This is a test! 🚀"
    --attachments "/full/path/to/file.pdf,/full/path/to/image.png"

php

require_once __DIR__ . '/vendor/autoload.php';
use vielhuber\wahelper\wahelper;

$wahelper = new wahelper();

// fetch messages
$wahelper->fetchMessages(device: 'xxxxxxxxxxxx', limit: 42);

// send message to user
$wahelper->sendUser(
    device: 'xxxxxxxxxxxx',
    number: 'xxxxxxxxxxxx',
    message: 'This is a test! 🚀',
    attachments: ['/full/path/to/file.pdf', '/full/path/to/image.png']
);

// send message to group
$wahelper->sendGroup(
    device: 'xxxxxxxxxxxx',
    name: 'Group name',
    message: 'This is a test! 🚀',
    attachments: ['/full/path/to/file.pdf', '/full/path/to/image.png']
);

mcp

{
    "mcpServers": {
        "whatsapp": {
            "command": "/usr/bin/php8.1",
            "args": ["/var/www/wahelper/vendor/bin/mcp-server.php"]
        }
    }
}

daemon

# install pm2
npm install -g pm2

# start daemon
pm2 start npx --name wahelper-xxxxxxxxxxxx --cwd /var/www/wahelper -- wahelper-daemon --device xxxxxxxxxxxx

# optional: autostart
## save config
pm2 save
## linux
pm2 startup
## windows
Windows Task Scheduler > Trigger Bei Systemstart → Aktion "pm2 resurrect"

# more commands
pm2 resurrect
pm2 unstartup
pm2 status
pm2 start wahelper-xxxxxxxxxxxx
pm2 stop wahelper-xxxxxxxxxxxx
pm2 restart wahelper-xxxxxxxxxxxx
pm2 logs wahelper-xxxxxxxxxxxx
pm2 delete wahelper-xxxxxxxxxxxx