Paths live under
/v1/inbox/conversations. The older /v1/conversations
paths still serve the exact same responses — nothing to migrate.List conversations
{ "data": [ … ], "pagination": { … } }. Each row carries its
id, the contact, the account, the platform, the last message and whether it’s
unread. Conversations and messages use id (not _id).
Read a conversation
Reply
Idempotency-Key header so a network retry never sends the message
twice. Sending is immediate and public to the recipient — there’s no undo. Show the
exact text to whoever is approving it before you call this.
Start a conversation
The 24-hour window
Meta — Instagram, Facebook Messenger and WhatsApp — only accepts free-form messages within 24 hours of the contact’s last message. Past that:- WhatsApp: send an approved template.
- Instagram / Facebook: the window is closed. The single exception is a private reply to a comment, once per comment, within 7 days — which is what comment → DM automations run on.
Sync from the platform
Inbound messages arrive by webhook in real time. When the inbox looks incomplete — a freshly connected account, or webhooks that were misconfigured for a while — pull the current state from the platform:Reacting to inbound messages
Subscribe tomessage.received rather than polling the list. The payload
carries the conversation and the message, so you can route it straight into your
own system — see Webhooks.