Skip to main content
OpenBunny connects to WhatsApp Web using the Baileys library. This uses your personal WhatsApp account — no WhatsApp Business API required.

Setup

1
Run the setup wizard
2
npm run setup
3
Select WhatsApp when prompted. A QR code will be displayed in your terminal.
4
Scan the QR code
5
Open WhatsApp on your phone, go to Linked Devices, and scan the QR code.
6
Verify connection
7
Once authenticated, the service begins receiving messages from your WhatsApp chats.

How it works

The service uses the Baileys library to connect to WhatsApp Web via the multi-device protocol. Session credentials are stored locally so you don’t need to re-scan on restart.
WhatsApp Web connections can be disconnected if you link too many devices or if WhatsApp detects unusual activity. If disconnected, re-run the setup wizard to re-authenticate.

Notes

  • Uses your personal WhatsApp account, not WhatsApp Business API
  • Group chats and individual chats are both supported
  • Media messages (images, documents) are noted but not processed by the LLM
  • Session persists across restarts