---
title: "Listar histórico de conversas"
method: GET
path: "/v2/messages/history"
tags: ["conversas-v2-messages"]
---

# Listar histórico de conversas

`GET /v2/messages/history`

## Request

- Base URL: `https://api.tallos.com.br`
- URL: `https://api.tallos.com.br/v2/messages/history`
- Auth: HTTP bearer

ℹ️ API disponível para os planos Pro e Advanced.

ℹ️ Este recurso requer criptografia.

Listar histórico de conversas.

**Paginação:** por offset (parâmetros `page` e `limit`). Não há cursor.
O limite máximo por requisição é **100** registros.
Se `limit` for informado e ≤ 100, usa esse valor; caso contrário o padrão é 15.

Para obter as próximas páginas, incremente o parâmetro `page` (ex.: `page=1`, `page=2`,
`page=3`) e mantenha o mesmo `limit`.
Exemplo: `limit=50&page=2` retorna os registros de 51 a 100.

Após descriptografar o JWE, cada item segue o schema
`MessageHistoryDecryptedItem`. Campos novos: `broadcast_message`,
`broadcast_id` (string ou `null` quando não houver campanha associada),
`call` (Call associada à mensagem, quando existir) e `metadata` apenas
com `reason` e `code`. O campo `is_template_message` continua presente.
`call` não reconstrói sozinho a jornada bot → operador.

## Query parameters

- `limit` integer
- `page` integer
- `channel` string[]
- `customer_id` string, hash, required
- `end_date` string, date
- `sent_by` string[]
- `start_date` string, date
- `type` string[]

## Response `200`

Histórico de mensagens (criptografado)

- object
  - `messages` string, required: JWE compacto. Após descriptografar, a lista é um array de `MessageHistoryDecryptedItem`.

## Other responses

- `400`: Bad request
- `401`: Access Token missing or invalid
- `403`: Not authorized to access such resource
- `404`: Resource not found
- `422`: Unprocessable Content
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/revisions/730a895096d0?raw)