PHPackages                             vielhuber/wahelper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. vielhuber/wahelper

ActiveLibrary[Utility & Helpers](/categories/utility)

vielhuber/wahelper
==================

Lightweight whatsapp integration layer.

1.6.8(1w ago)0178↓25%MITJavaScriptPHP >=8.1

Since Nov 18Pushed 1w agoCompare

[ Source](https://github.com/vielhuber/wahelper)[ Packagist](https://packagist.org/packages/vielhuber/wahelper)[ RSS](/packages/vielhuber-wahelper/feed)WikiDiscussions main Synced yesterday

READMEChangelogDependencies (10)Versions (63)Used By (0)

[![GitHub Tag](https://camo.githubusercontent.com/be50e347be33aa00986198510c90ea034e991051e3b1ad6832a95219bb9df12a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f7669656c68756265722f776168656c706572)](https://github.com/vielhuber/wahelper/tags)[![Code Style](https://camo.githubusercontent.com/1540f8ce219727155ab62506c77b818b720421c22c4cf0b18a5f160942132e2d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64655f7374796c652d7073722d2d31322d6666363962342e737667)](https://www.php-fig.org/psr/psr-12/)[![License](https://camo.githubusercontent.com/414f1c4cad5dbf970785e23af06fcf7024846669485ae192c45a1472015791d8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7669656c68756265722f776168656c706572)](https://github.com/vielhuber/wahelper/blob/main/LICENSE.md)[![Last Commit](https://camo.githubusercontent.com/61a727de8114fe307cda34d9c7802decda706e49cfb60265ae9d2d03de3b0485/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f7669656c68756265722f776168656c706572)](https://github.com/vielhuber/wahelper/commits)[![PHP Version Support](https://camo.githubusercontent.com/162f88377f7d5f7bae79bc68c5b7319ecdccf81e2bcd48341d311b8961b5d305/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7669656c68756265722f776168656c706572)](https://packagist.org/packages/vielhuber/wahelper)[![Packagist Downloads](https://camo.githubusercontent.com/99b6eddd3a456e113c9b04bbbd4f20e80a6b7381f6869d26e588959b1b42584d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7669656c68756265722f776168656c706572)](https://packagist.org/packages/vielhuber/wahelper)[![node version](https://camo.githubusercontent.com/437d5023778d758fb4f9e79a35c5f4fc61b1ea6ae66ef9d3aa4a817807ae0a4b/68747470733a2f2f696d672e736869656c64732e696f2f6e6f64652f762f407669656c68756265722f776168656c706572)](https://www.npmjs.com/package/@vielhuber/wahelper)[![npm Downloads](https://camo.githubusercontent.com/033caf803d0f1717d10fef99a9a22a2abb97ec734065a1847fb4d45fca1d7a5e/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f64742f407669656c68756265722f776168656c706572)](https://www.npmjs.com/package/@vielhuber/wahelper)

🍸 wahelper 🍸
============

[](#-wahelper-)

wahelper is a lightweight whatsapp integration layer built on top of [baileys](https://github.com/WhiskeySockets/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
------------

[](#requirements)

- node >= 22
- php >= 8.1

installation
------------

[](#installation)

### js

[](#js)

```
npm install @vielhuber/wahelper
```

### php

[](#php)

```
composer require vielhuber/wahelper
```

### .gitignore

[](#gitignore)

```
/whatsapp_data/

```

usage
-----

[](#usage)

### start daemon

[](#start-daemon)

```
npx wahelper-daemon --device "xxxxxxxxxxxx"
```

### cli

[](#cli)

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

    # fetch messages
    --action "fetch_messages" \
    --filter '{"from":"491234567890","to":"491234567890","message":"meeting","date_from":"2026-01-01","date_until":"2026-12-31"}' \
    --limit 42 \
    --order "desc"

    # view a single message by id
    --action "view_message" \
    --id "ABCDEF1234567890"

    # 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

[](#php-1)

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

$wahelper = new wahelper();

// fetch messages
$wahelper->fetchMessages(
    device: 'xxxxxxxxxxxx',
    filter: [
        'from' => '491234567890',
        'to' => '491234567890',
        'message' => 'meeting',
        'date_from' => '2026-01-01',
        'date_until' => '2026-12-31'
    ],
    limit: 42,
    order: 'desc'
);

// view a single message by id
$wahelper->viewMessage(
    device: 'xxxxxxxxxxxx',
    id: 'ABCDEF1234567890'
);

// 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

[](#mcp)

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

daemon
------

[](#daemon)

```
# install pm2
npm install -g pm2

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

# start daemon (windows)
pm2 start node --name wahelper-xxxxxxxxxxxx --cwd "C:\path\to\project" -- node_modules/@vielhuber/wahelper/wahelper-daemon.js --device xxxxxxxxxxxx

## autostart (linux)
pm2 save
pm2 startup

## autostart (windows)
pm2 save
Windows Task Scheduler > Create Task > Triggers: At startup → Actions: Start a program → Program: "C:\Users\\AppData\Roaming\npm\pm2.cmd", Arguments: "resurrect"

# more commands
pm2 unstartup                      # remove autostart
pm2 status                         # show status of all processes
pm2 resurrect                      # restore saved process list
pm2 save                           # save current process list for resurrect
pm2 start wahelper-xxxxxxxxxxxx    # start a stopped process
pm2 stop wahelper-xxxxxxxxxxxx     # stop a running process
pm2 restart wahelper-xxxxxxxxxxxx  # restart a process
pm2 logs wahelper-xxxxxxxxxxxx     # tail live logs
pm2 delete wahelper-xxxxxxxxxxxx   # remove process
```

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance98

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

62

Last Release

8d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3183737?v=4)[David Vielhuber](/maintainers/vielhuber)[@vielhuber](https://github.com/vielhuber)

---

Top Contributors

[![vielhuber](https://avatars.githubusercontent.com/u/3183737?v=4)](https://github.com/vielhuber "vielhuber (91 commits)")

### Embed Badge

![Health badge](/badges/vielhuber-wahelper/health.svg)

```
[![Health](https://phpackages.com/badges/vielhuber-wahelper/health.svg)](https://phpackages.com/packages/vielhuber-wahelper)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[google/cloud-core

Google Cloud PHP shared dependency, providing functionality useful to all components.

346132.9M112](/packages/google-cloud-core)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[phpactor/phpactor

PHP refactoring and intellisense tool for text editors

1.9k17.1k1](/packages/phpactor-phpactor)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)