1MSG
ReferenceInbox API

Mensagens de uma conversa

GET
/api/v1/inbox/conversations/{conversationId}/messages

As mais recentes primeiro. Sem kind, ou com kind=all, os eventos SYSTEM (status, responsável, bloqueio, título) vêm junto com as mensagens. kind=messages esconde os eventos SYSTEM. kind=system retorna só eles. As notas vêm junto com as mensagens. Para carregar registros mais antigos do mesmo kind, envie nextCursor como cursor.

Authorization

bearer
headerAuthorizationBearer <token>

Chave gerada em Settings → Developer → API key. Os métodos do Inbox precisam do escopo Inbox. Os métodos de Campaigns precisam do escopo Campaigns.

Path Parameters

conversationId*string

id da conversa

Query Parameters

limit?number

Tamanho da página. Padrão 50.

cursor?string

nextCursor da página anterior (createdAt em ISO). Retorna registros anteriores a esse instante, com o mesmo filtro kind.

kind?string

all (padrão quando omitido): todos os registros. messages: tudo menos SYSTEM. system: só SYSTEM.

Value in"all""messages""system"

Response Body

application/json
  1. response
messages*array<>

As mais recentes primeiro. Inclui eventos SYSTEM.

nextCursor?|

Envie de volta como cursor para carregar mensagens mais antigas. null na última página.

Formatdate-time
hasMore*boolean
curl -X GET 'https://api.1msg.io/api/v1/inbox/conversations/string/messages'
{  "messages": [    {      "id": "string",      "conversationId": "string",      "channelId": "string",      "direction": "INBOUND",      "type": "TEXT",      "content": "string",      "mediaUrl": "string",      "mediaType": "string",      "fileName": "string",      "fileSize": 0,      "mediaDuration": 0,      "thumbnailUrl": "string",      "templateName": "string",      "templateLanguage": "string",      "status": "PENDING",      "externalId": "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",      "systemEventSource": "string",      "systemEventOperatorName": "string",      "systemEventOperatorEmail": "string",      "assignmentEvent": {        "kind": "assign",        "actor": {          "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa",          "name": "QA Stage",          "avatar": null        },        "target": {          "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa",          "name": "QA Stage",          "avatar": null        }      },      "author": {        "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa",        "name": "QA Stage",        "avatar": null      },      "quotedMessage": {        "id": "string",        "content": "string",        "type": "string",        "direction": "INBOUND",        "contactName": "string",        "contactPhone": "string",        "mediaUrl": "string",        "fileName": "string"      },      "latitude": 0,      "longitude": 0    }  ],  "nextCursor": "2019-08-24T14:15:22Z",  "hasMore": true}