Messages API

The Messages API unifies DMs from all channels: Instagram, Facebook, WhatsApp, Telegram, Discord, X, Bluesky, Reddit.

Conversations

{
  "data": [
    {
      "id": "conv_xxx",
      "platform": "instagram",
      "participant": { "id": "ig_user_xxx", "name": "Alice", "avatarUrl": "..." },
      "lastMessage": { "text": "Hello!", "createdAt": "..." },
      "unreadCount": 3
    }
  ]
}

Filters: platform, unreadOnly, assignedTo.

Create a conversation

{
  "platform": "whatsapp",
  "to": "+33612345678"
}

Send a message

{
  "conversationId": "conv_xxx",
  "text": "Hello!"
}

With media:

{
  "conversationId": "conv_xxx",
  "text": "Here is your ticket",
  "mediaUrls": ["https://example.com/ticket.pdf"]
}

List messages

Reactions

{ "emoji": "👍" }

Typing indicator

Mark as read

Search

Edit / Delete

{ "text": "Corrected text" }

Update status

Mark a conversation as resolved / pending / spam:

{ "status": "resolved" }

Webhooks

• inbox.message.received: new incoming DM
• inbox.message.delivered: sent message confirmed
• inbox.message.read: message read by the recipient