Histórico de mensagens

Lista as mensagens da instância, das mais recentes para as mais antigas, com paginação por cursor. Resposta síncrona.

GEThttps://api.zapdev.com.br/v1/messages

Query params

Param	Tipo	Descrição
limit	integer	Itens por página. Padrão 50, máximo 100.
cursor	string	id da última mensagem da página anterior (vem em pagination.nextCursor).
status	string	Filtra por status: queued, sent, delivered, read, failed.
from	string	Filtra pelo número da conversa (o mesmo valor do campo to da mensagem).

Requisição

cURL

curl "https://api.zapdev.com.br/v1/messages?limit=50&status=delivered" \
  -H "Authorization: Bearer zd_live_..."

Resposta

200 OK: um array data de mensagens e um objeto pagination. Para a próxima página, repita a chamada com cursor=<nextCursor> enquanto hasMore for true.

Campo	Tipo	Descrição
id	string	ID da mensagem
to	string	Número/grupo de destino
type	string	text, image, audio…
status	string	Estado atual da mensagem
whatsappId	string | null	ID da mensagem no WhatsApp
errorCode	string | null	Código do erro, se failed
createdAt	string	ISO 8601 (UTC)

Resposta

200 OK

{
  "data": [
    {
      "id": "msg_3Hb9aZ2kQ",
      "to": "5511999990000",
      "type": "text",
      "status": "delivered",
      "whatsappId": "3EB0...",
      "errorCode": null,
      "createdAt": "2026-07-11T14:32:08Z"
    }
  ],
  "pagination": { "nextCursor": "msg_3Hb9aZ2kQ", "hasMore": true }
}