> For the complete documentation index, see [llms.txt](https://docs.zaia.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zaia.app/channels/channel-types/whatsapp-waha.md).

# WhatsApp (Waha)

This option connects the platform to WhatsApp using **Waha API**, which leverages the official WhatsApp Web protocol through QR code authentication.

#### Connection Flow

1. Select **Type: WhatsApp (Waha)**.
2. Define the channel name and description.
3. Assign a responder (Agent or Squad).
4. Click **Create Channel**.
5. A **QR Code** will appear automatically.

#### QR Code Authentication

* Open the WhatsApp app on your phone.
* Navigate to **Linked Devices → Add Device**.
* Scan the QR Code displayed on the screen.
* The connection will be established within a few seconds.

Once the QR code is read successfully, the Agent can send and receive messages through that WhatsApp number.\
If the channel is deactivated, message routing stops immediately.

> 🕐 QR codes are valid for **40 seconds** — if the connection fails, refresh the page or restart the pairing process.

***

### ⚠️ Messaging limitations

WhatsApp (Waha) supports **text messages only**.

It does not support:

* WhatsApp templates
* Template fallback after the 24-hour window
* Official outbound template flows