Listar mensagens

Busca o histórico paginado de mensagens de uma conversa.

GEThttps://external-api.lip7.com.br/api/external/conversations/{id}/messages

Escopoconversations:messages:readSíncrono — responde 200 com os dados

Retorna as mensagens de uma conversa. Responde 404 quando a conversa não existe no workspace.

Query params

pagenumberopcionalpadrão 1

Número da página.

limitnumberopcionalpadrão 50

Itens por página, com máximo de 100.

sortOrderstringopcionalpadrão desc

Com desc, as mensagens mais recentes vêm primeiro.

valoresascdesc

mediaUrl é temporária

Quando a mensagem tem mídia, mediaUrl é retornada assinada e temporária — expira após o TTL padrão de armazenamento. Baixe o arquivo logo após a leitura e não armazene a URL assinada por longos períodos; refaça a consulta para obter uma nova quando precisar.

Valores de referência

Campo	Valores possíveis
`messageType`	`TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT`, `LOCATION`, `STICKER`, `CONTACT`, `TEMPLATE`, `INTERACTIVE`, `REACTION`, `ORDER`, `SYSTEM`, `BUTTON`
`status`	`RECEIVED`, `SENT`, `DELIVERED`, `READ`, `FAILED`
`messageOrigin`	`client` (cliente final), `WorkspaceMember` (atendente), `bot`, `system`

Requisição

curl -X GET "https://external-api.lip7.com.br/api/external/conversations/conv_123/messages?limit=50&sortOrder=desc" \
  -H "x-api-key: lip_SUA_CHAVE"

const response = await fetch(
  'https://external-api.lip7.com.br/api/external/conversations/conv_123/messages?limit=50&sortOrder=desc',
  { headers: { 'x-api-key': 'lip_SUA_CHAVE' } }
);

const data = await response.json();

Resposta

{
  "success": true,
  "data": {
    "messages": [
      {
        "id": "msg_...",
        "conversationId": "conv_...",
        "whatsappMessageId": "wamid...",
        "fromNumber": "5511999999999",
        "toNumber": "5511888888888",
        "messageType": "TEXT",
        "content": "Olá, tudo bem?",
        "isFromBot": false,
        "messageOrigin": "client",
        "status": "DELIVERED",
        "mediaUrl": null,
        "mediaType": null,
        "filename": null,
        "timestamp": "2026-06-15T18:00:00.000Z",
        "createdAt": "2026-06-15T18:00:01.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "totalPages": 1
  }
}