---
title: "Conversas"
slug: conversations
group: "Referência da API"
source: https://linkzap.orion.moe/developers/conversations
openapi: https://linkzap.orion.moe/openapi.json
---

# Conversas

Uma conversa é um contato falando por um canal. É a unidade que a sua equipe atende e a que os webhooks referenciam.

## Listar conversas

### `GET /api/v1/conversations`
Lista as conversas, da que teve mensagem mais recente para a mais antiga.

**Parâmetros da URL**

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `status` | texto | Um de `open`, `in_flow` ou `resolved`. Qualquer outro valor responde 422. |
| `channelId` | texto | Filtra por número. Uma chave de canal que pedir outro recebe 403. |
| `contactId` | texto | Todas as conversas de um contato (uma por canal por onde ele falou). |
| `page` | inteiro | A partir de 1. |
| `limit` | inteiro | De 1 a 200. Padrão 50. |

Pedido:

```bash
curl "https://linkzap.orion.moe/api/v1/conversations?status=open&limit=20" \
  -H "Authorization: Bearer lz_SUA_CHAVE"
```

Resposta:

```json
{
  "data": [
    {
      "id": "cnv_5ad2...",
      "status": "open",
      "channel": { "id": "chn_9f2a...", "label": "Recepção", "provider": "web" },
      "contact": { "id": "ctt_3c81...", "phone": "5592999990000", "name": "Maria Souza" },
      "assignedTo": "usr_44e1...",
      "participants": ["usr_7b20..."],
      "unread": 2,
      "lastMessageAt": "2026-09-21T14:02:59.000Z",
      "lastMessagePreview": "Pode ser quinta de manhã?",
      "automationPausedUntil": null,
      "createdAt": "2026-09-19T08:30:00.000Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 37
}
```

## Os três estados

- `open` — está na fila humana, esperando alguém (ou já com responsável).
- `in_flow` — um fluxo está conduzindo a conversa. Ela **não** aparece na aba “Abertos” do painel, porque não está esperando ninguém.
- `resolved` — o atendimento foi encerrado. Uma mensagem nova do contato reabre.

`automationPausedUntil` diz até quando a automação está calada nessa conversa — é o que acontece automaticamente depois que uma pessoa responde, para a Aura não falar por cima. `unread` é a contagem que a equipe vê no painel, não um estado do WhatsApp.

## O que esta rota ainda não faz

Ela lê. Resolver, reabrir, atribuir a alguém, encaminhar para um setor ou pausar a automação continuam sendo ações do painel — não existem por API hoje, e preferimos dizer isso a documentar um endpoint que não há. Se a sua integração precisa de alguma delas, fale com o suporte: saber qual é a que falta é o que decide a ordem em que elas entram.