Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openbunny.ai/llms.txt

Use this file to discover all available pages before exploring further.

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