Inbox
Receive and reply to WhatsApp direct messages
Inbox
Included — Inbox (DMs, comments, reviews) is bundled with every paid account on the Usage plan.
All WhatsApp features (broadcasts, sequences, DM conversations) are included with the Usage plan. WhatsApp DM conversations are available through the unified Inbox API, which aggregates conversations across all supported platforms.
Direct Messages
| Feature | Supported |
|---|---|
| List conversations | Yes |
| Fetch messages | Yes |
| Send text messages | Yes |
| Send attachments | Yes (images, videos, documents, audio) |
| Send voice notes | Yes — pass voiceNote: true on an audio attachment to render as a true voice message (waveform, autoplay, profile-picture bubble). The file must be .ogg encoded with the OPUS codec (mono); dashboard mic recordings are transcoded server-side. Omitting the flag sends as a basic audio attachment (still shows a microphone icon when the codec is Opus, but without the voice-message UI). |
| Send interactive messages | Yes (reply buttons, list, CTA URL, flow) via the interactive / buttons fields |
| Send location & contact cards | Yes via the location / contacts fields |
| Reply to a specific message | Yes via replyTo (the quoted message's platformMessageId) |
| React to a message | Yes (emoji) via Add message reaction |
| Typing indicator | Yes via Send typing indicator |
| Archive/unarchive | Yes |
Attachment Support
| Type | Supported | Max Size |
|---|---|---|
| Images | Yes | 5 MB |
| Videos | Yes | 16 MB |
| Documents | Yes | 100 MB |
| Audio | Yes | 16 MB |
Webhooks
WhatsApp emits the full set of message + delivery lifecycle webhooks:
| Event | When it fires |
|---|---|
message.received | New incoming WhatsApp message |
message.sent | Outgoing message is sent |
message.delivered | Outgoing message is delivered to the recipient |
message.read | Recipient reads an outgoing message |
message.failed | Outgoing message fails to deliver, the payload error object carries the Cloud API error code (e.g. 131026 recipient phone not reachable) |
message.deleted | The business deletes a previously-sent outgoing message via DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId} |
reaction.received | A participant adds or removes an emoji reaction. reaction.emoji is empty on removal (the Cloud API does not report which emoji was removed) |
Subscribe via Create webhook settings. See the Webhooks page for payload details.
Note: WhatsApp Cloud API does not expose incoming-message edits or recipient-side unsends, so message.edited and incoming-side message.deleted are not emitted. These are platform limitations.
Notes
- 24-hour window: Free-form messages only within 24 hours of customer's last message
- Templates: Required to initiate or re-initiate conversations outside the window
- Delivery tracking: Messages have sent/delivered/read status updates via webhooks
See Inbox API Reference for endpoint details.