> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar conversas

> Obter a lista paginada de conversas da sua organização.

# Listar conversas

Retorna todas as conversas da organização, ordenadas por última atividade decrescente por padrão. É possível filtrar por status ou por agente e mudar o critério de ordenação. As conversas de teste do Playground não são incluídas.

```http theme={null}
GET https://app.chatnorris.ai/api/v2/conversations
Authorization: Bearer <sua_api_key>
```

**Escopo necessário:** `conversations:read`

***

## Query parameters

| Parâmetro | Tipo | Descrição |
| - | - | - |
| `status` | string | Filtrar por status: `bot`, `handoff`, `open` ou `closed` |
| `chatbot_id` | string | Filtrar por agente |
| `created_after` | string | Apenas conversas criadas depois desta data (ISO 8601, ex.: `2026-09-01T00:00:00Z`) |
| `order_by` | string | Campo de ordenação: `created_at` ou `updated_at`. Default: `updated_at` |
| `page` | integer | Número da página. Default: `1` |
| `per_page` | integer | Resultados por página. Default: `25`, máximo `100` |

***

## Resposta

```json theme={null}
{
  "status": "success",
  "data": {
    "conversations": [
      {
        "id": "conv_abc123",
        "chatbot_id": "bot_xyz789",
        "visitor_id": "visitor_001",
        "visitor_name": "Juan Pérez",
        "visitor_email": "juan@empresa.com",
        "status": "closed",
        "channel": "web",
        "created_at": "2026-06-28T14:00:00.000Z",
        "updated_at": "2026-06-28T14:35:00.000Z"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 25,
    "total": 240
  }
}
```

### Campos da resposta

| Campo | Tipo | Descrição |
| - | - | - |
| `id` | string | ID único da conversa |
| `chatbot_id` | string | ID do agente que atendeu a conversa |
| `visitor_id` | string | Identificador do visitante (gerado automaticamente) |
| `visitor_name` | string \| null | Nome do visitante (se foi capturado, por exemplo com o Lead Form) |
| `visitor_email` | string \| null | Email do visitante (se foi capturado) |
| `status` | string | Status: `bot` (em andamento), `handoff` (aguardando agente), `open` (atendida), `closed` |
| `channel` | string | Canal: `web`, `whatsapp`, `instagram`, `telegram`, `messenger`, `email` ou `api` (conversas criadas com a API) |
| `created_at` | string | Data de início (ISO 8601) |
| `updated_at` | string | Última atividade (ISO 8601) |

> [!TIP]
>
> Para fazer polling incremental (por exemplo, sincronizar conversas novas com outro sistema), combine `created_after` com `order_by=created_at` e salve o `created_at` do último resultado como ponto de partida da consulta seguinte.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.