# WhatsApp

> WhatsApp integration capabilities for Lobu agents.

Lobu's WhatsApp adapter supports direct chats, group controls, and media-aware workflows.
Under the hood, Lobu uses the WhatsApp Business Cloud API for message delivery and media handling.

<PlatformChatExamples platform="whatsapp" client:visible />

## Setup

1. Obtain a WhatsApp Business **access token**, **phone number ID**, **app secret**, and **verify token** from the [Meta Developer Portal](https://developers.facebook.com/).
2. Run `lobu connections add whatsapp` to add the connection (prompts for the access token and phone number ID), or run `lobu init` to scaffold a new project and pick WhatsApp in the wizard.
3. Configure the webhook URL in the Meta Developer Portal to point to your gateway's webhook endpoint.
4. Start the stack with `lobu run -d` — the bot starts handling messages on the configured phone number.

## Configuration

<PlatformConfigTable platform="whatsapp" />

## Features

- **Cloud API integration** via the WhatsApp Business Platform.
- **Group controls** with allow/deny behavior and optional mention requirement.
- **Typing indicator status** while responses are being generated.
- **File/media support** for inbound and outbound attachments.
- **Conversation history window** with configurable retention limits.

## Typical Use Cases

- Personal assistant over WhatsApp chats.
- Group assistant that only responds when mentioned.
- Media-aware workflows (voice notes, files, images).