Enigma Developers
API ReferenceConversations

List conversation messages

GET
/v1/conversations/{audienceExternalId}/messages

Message history of the contact's latest conversation, newest first. The key sees what its creator would see in the inbox: an organization owner's key sees the whole history; other members' keys see the last two sessions. Requires scope message:read.

Authorization

headerAuthorizationBearer <token>

Your organization API key: Authorization: Bearer org_…

Path Parameters

audienceExternalId*string

The contact's ID on its channel. For WhatsApp it is <phone number>:<your WhatsApp phone number ID>.

Query Parameters

page?integer
Range1 <= value
Default1
limit?integer
Range1 <= value <= 100
Default20

Response Body

A page of messages.

application/json
  1. response
messages*array<>
total*integer
page*integer
limit*integer
curl -X GET 'https://api.enigma-ai.com/v1/conversations/string/messages'
{  "messages": [    {      "_id": "string",      "externalId": "string",      "conversationId": "string",      "sessionId": "string",      "sender": "bot",      "content": {        "type": "text",        "text": "string",        "mediaUrl": "string"      },      "status": "pending",      "errorDetails": {        "code": 0,        "title": "string",        "message": "string",        "details": "string"      },      "sentAt": "2019-08-24T14:15:22Z",      "deliveredAt": "2019-08-24T14:15:22Z",      "readAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0,  "page": 0,  "limit": 0}