# Zapini API — Conversas

**Versão:** 1.2.0
**Base URL:** `https://zapini.app/api/v1`

---

## Autenticação

Todos os endpoints requerem um Bearer Token:

```
Authorization: Bearer {your_token}
Accept: application/json
Content-Type: application/json
```

Gere tokens de API no painel admin em **API Docs → Gerenciar Tokens**.

---

## Conversas

### GET /conversations

Listar conversas.

**Parâmetros de Consulta:**

| Campo | Tipo | Descrição |
|-------|------|-----------|
| instance_id | string | UUID da instância |
| unread | boolean | Apenas conversas com mensagens não lidas |
| search | string | Pesquisar por nome ou número |
| is_group | boolean | Filtrar grupos ou indivíduos |
| per_page | integer | Itens por página |

---

### GET /conversations/archived

Listar conversas arquivadas.

---

### GET /conversations/{uuid}

Retorna detalhes da conversa.

---

### GET /conversations/{uuid}/messages

Listar mensagens de uma conversa.

**Parâmetros de Consulta:**

| Campo | Tipo | Descrição |
|-------|------|-----------|
| from | datetime | Data de início |
| to | datetime | Data de fim |
| before_id | integer | Mensagens antes deste ID (para scroll infinito) |
| after_id | integer | Mensagens após este ID |
| limit | integer | Limite de mensagens (padrão: 50) |

---

### POST /conversations/{uuid}/mark-read

Marcar conversa como lida (resetar contador de não lidas).

---

### POST /conversations/{uuid}/archive

Arquivar a conversa.

---

### POST /conversations/{uuid}/unarchive

Desarquivar a conversa.

---

### DELETE /conversations/{uuid}

Excluir conversa e todas as mensagens.

---

*Gerado por Zapini — https://zapini.app*