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

# Conversas

> Como consultar e gerenciar conversas do chat via API

# Conversas

O recurso `conversations` permite consultar e gerenciar as conversas de atendimento.

## Listar conversas

```bash theme={null}
curl "https://api.synax.app.br/functions/v1/api-proxy/conversations?limit=20&order=last_message_at.desc" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"
```

### Filtros

| Parâmetro     | Exemplo    | Descrição                               |
| ------------- | ---------- | --------------------------------------- |
| `status=open` | Por status | `open`, `pending`, `resolved`, `closed` |

## Buscar uma conversa

```bash theme={null}
curl "https://api.synax.app.br/functions/v1/api-proxy/conversations/{id}" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui"
```

## Atualizar status

<Note>
  Requer chave com permissão de **escrita**.
</Note>

```bash theme={null}
curl -X PATCH "https://api.synax.app.br/functions/v1/api-proxy/conversations/{id}" \
  -H "Authorization: Bearer sk_live_SuaChaveAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "resolved"
  }'
```