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

> Manage the WhatsApp channel connection and whitelist.

## Login

Connect to WhatsApp by scanning a QR code in the terminal.

```bash theme={null}
openbunny whatsapp login
openbunny whatsapp login --reset-auth        # Clear credentials first
openbunny whatsapp login --stay-connected    # Keep connection active during setup
```

| Flag               | Description                             |
| ------------------ | --------------------------------------- |
| `--reset-auth`     | Clear stored credentials before login   |
| `--stay-connected` | Keep the connection active during setup |

## List chats

Show known WhatsApp chats from the local database.

```bash theme={null}
openbunny whatsapp list
```

## Whitelist

Control which WhatsApp chats are processed. Entries can be phone numbers or group IDs.

```bash theme={null}
openbunny whatsapp whitelist                       # Show current policy
openbunny whatsapp whitelist add +15551234567       # Add an entry
openbunny whatsapp whitelist remove +15551234567    # Remove an entry
openbunny whatsapp whitelist clear                  # Clear all entries
openbunny whatsapp whitelist allow-all on           # Listen to all chats
openbunny whatsapp whitelist allow-all off          # Listen only to whitelisted
```

You can also pass comma-separated entries directly:

```bash theme={null}
openbunny whatsapp whitelist +15551234567,+15559876543
```