> ## 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.

# WhatsApp

> Connect to WhatsApp using the Baileys library with QR code authentication.

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

## Setup

<Steps>
  ### Run the setup wizard

  ```bash theme={null}
  npm run setup
  ```

  Select WhatsApp when prompted. A QR code will be displayed in your terminal.

  ### Scan the QR code

  Open WhatsApp on your phone, go to **Linked Devices**, and scan the QR code.

  ### Verify connection

  Once authenticated, the service begins receiving messages from your WhatsApp chats.
</Steps>

## 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.

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

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