Conversas

Histórico de mensagens

Lista o histórico completo de mensagens (diretas e de grupo) do número vinculado, ordenadas por providerTimestamp (mais recentes primeiro). Funciona para todos os provedores (Evolution Go, Evolution v2 e Meta). Paginação por page/pageSize. Filtre por período com startDate/endDate (ISO 8601, sobre providerTimestamp). Retorna até ~1 mês de histórico armazenado (a partir da data de conexão). O modo de privacidade do número (PII) se aplica: RELAY_ONLY → [] + notice:“PII_RELAY_ONLY”; STORE_X_DAYS limita à janela max(startDate, agora − retentionDays). Requer key escopada a número.

Requer uma chave com escopo de número.

GET

messages

history

Histórico de mensagens

curl --request GET \
  --url https://pilotstatus.com.br/v1/messages/history \
  --header 'x-api-key: <api-key>'

{
  "messages": [
    {
      "id": "cm_01HZX...",
      "conversationId": "conv_01HZX...",
      "direction": "INBOUND",
      "providerKind": "PILOT_STATUS",
      "externalMessageId": "wamid.HBg...",
      "status": "DELIVERED",
      "messageType": "text",
      "origin": null,
      "text": "Olá, ainda está disponível?",
      "participantName": "Ana",
      "participantPhone": "+5511988887777",
      "repliedToExternalId": null,
      "media": null,
      "sentAt": null,
      "deliveredAt": "2026-06-27T10:00:01.000Z",
      "readAt": null,
      "providerTimestamp": "2026-06-27T10:00:00.000Z",
      "createdAt": "2026-06-27T10:00:00.500Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 30,
  "totalPages": 1
}

Autorizações

x-api-key

string

header

obrigatório

Sua chave de API ps_

Parâmetros de consulta

startDate

string

Início do período (filtra por providerTimestamp). Deve ser ≤ endDate. (string (ISO 8601))

endDate

string

Fim do período (filtra por providerTimestamp). (string (ISO 8601))

page

string

Página (padrão 1). (integer (≥1))

pageSize

string

Itens por página (padrão 30, máx 100). (integer (1–100))

Resposta

Histórico de mensagens

Mensagens de grupos

Mensagens não lidas

⌘I

Histórico de mensagens

curl --request GET \
  --url https://pilotstatus.com.br/v1/messages/history \
  --header 'x-api-key: <api-key>'

{
  "messages": [
    {
      "id": "cm_01HZX...",
      "conversationId": "conv_01HZX...",
      "direction": "INBOUND",
      "providerKind": "PILOT_STATUS",
      "externalMessageId": "wamid.HBg...",
      "status": "DELIVERED",
      "messageType": "text",
      "origin": null,
      "text": "Olá, ainda está disponível?",
      "participantName": "Ana",
      "participantPhone": "+5511988887777",
      "repliedToExternalId": null,
      "media": null,
      "sentAt": null,
      "deliveredAt": "2026-06-27T10:00:01.000Z",
      "readAt": null,
      "providerTimestamp": "2026-06-27T10:00:00.000Z",
      "createdAt": "2026-06-27T10:00:00.500Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 30,
  "totalPages": 1
}