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.
- Obtain a WhatsApp Business access token, phone number ID, app secret, and verify token from the Meta Developer Portal.
- Use Agents → Connections in the web app to add WhatsApp, or declare a
whatsappconnection inlobu.config.ts. - Configure the webhook URL in the Meta Developer Portal to point to your gateway’s webhook endpoint.
- Start the stack with
lobu run— the bot starts handling messages on the configured phone number.
Configuration
Section titled “Configuration”| Field | Required | Type | Description |
|---|---|---|---|
accessToken | No | string | System User access token for WhatsApp Cloud API. |
phoneNumberId | No | string | WhatsApp Business phone number ID. |
appSecret | No | string | Meta App Secret for webhook HMAC-SHA256 signature verification. |
verifyToken | No | string | Verify token for webhook challenge-response. |
apiVersion | No | string | Meta Graph API version (default: v21.0). |
userName | No | string | Bot display name. |
Features
Section titled “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.
- Inbound media handling for documents, images, audio, and voice notes received from users.
- Conversation history window with configurable retention limits.
Typical Use Cases
Section titled “Typical Use Cases”- Personal assistant over WhatsApp chats.
- Group assistant that only responds when mentioned.
- Media-aware workflows (voice notes, files, images).