CZapyChat
GET/public/conversations

Listar conversas

Lista as conversas que a chave pode ver, da mais recente para a mais antiga.

Chave com permissão de leitura (read)

Cabeçalhos

NomeTipoDescrição
AuthorizationobrigatóriostringBearer pk_sua_chave — a chave de API criada em Configurações › API Keys.

Parâmetros de consulta (query)

NomeTipoDescrição
statusstringPENDING, BOT, OPEN, WAITING ou CLOSED.
channelIdstringSó conversas deste canal.
contactIdstringSó conversas deste contato.
assignedToIdstringSó conversas deste atendente.
updatedSincestring (ISO 8601)Só conversas alteradas a partir desta data (bom para sincronizar).
pagenumberPágina (começa em 1). Padrão: 1.
limitnumberItens por página, de 1 a 100. Padrão: 25.

Observações

  • Chaves de atendente só enxergam as conversas que o atendente pode ver no painel.
curl -X GET "https://api.zapychat.com.br/api/v1/public/conversations?status=OPEN&limit=10" \
  -H "Authorization: Bearer pk_sua_chave"
Resposta · 200
{
  "data": {
    "items": [
      {
        "id": "cmf3k9x1a0001",
        "status": "OPEN",
        "channelId": "cmf0abc123",
        "channelName": "Vendas",
        "channelType": "WHATSAPP_MAGICAPI",
        "contactId": "cmf2xyz789",
        "contactName": "Maria Souza",
        "contactPhone": "5571999990000",
        "assignedToId": "cmf1usr456",
        "subject": null,
        "protocol": null,
        "isGroup": false,
        "lastMessageAt": "2026-10-05T14:32:10.000Z",
        "closedAt": null,
        "createdAt": "2026-10-05T14:10:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 25
  },
  "meta": {
    "timestamp": "2026-10-05T14:32:10.000Z"
  }
}