Conversas

Mensagens de grupos

Lista as mensagens em conversas de GRUPO do número vinculado (mais recentes primeiro). Paginação por page/pageSize. Filtre por período com startDate/endDate (ISO 8601, sobre createdAt). Números Meta retornam 400 NOT_SUPPORTED_FOR_META (grupos só em PILOT_STATUS). 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

group

Mensagens de grupos

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

{
  "messages": [
    {
      "id": "cm_01HZX...",
      "conversationId": "conv_01HZX...",
      "groupId": "123456789-987654321@g.us",
      "groupSubject": "Pilot Status Group",
      "direction": "INBOUND",
      "fromNumber": "5511988887777",
      "text": "Bom dia, pessoal!",
      "createdAt": "2026-06-27T10:00:00.000Z"
    }
  ],
  "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 createdAt). Deve ser ≤ endDate. (string (ISO 8601))

endDate

string

Fim do período (filtra por createdAt). (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

Mensagens de grupo

Listar conversas

Histórico de mensagens

⌘I

Mensagens de grupos

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

{
  "messages": [
    {
      "id": "cm_01HZX...",
      "conversationId": "conv_01HZX...",
      "groupId": "123456789-987654321@g.us",
      "groupSubject": "Pilot Status Group",
      "direction": "INBOUND",
      "fromNumber": "5511988887777",
      "text": "Bom dia, pessoal!",
      "createdAt": "2026-06-27T10:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 30,
  "totalPages": 1
}