ZaplinDocs
GuiasReferência da APIMCPChangelogAbrir o app

Listar conversas

GET
/v1/conversations

As conversas que você pode ver, da mais nova à mais antiga; status filtra abertas (open) ou fechadas (closed).

Escopo: conversations:read

Autorização

bearer conversations:read
headerAutorizaçãoBearer <token>

A chave de API de uma conta de serviço (sk_live_…, 600 requisições por minuto cada) ou um access token OAuth para o recurso /api/v1 (600 requisições por minuto por conexão).

Escopo: conversations:read

Parâmetros de query

limit?integer

Itens por página, de 1 a 100.

Intervalo1 <= value <= 100
Padrão50
cursor?string

O next_cursor da página anterior.

status?string
Valor em"open""closed"

Corpo da resposta

Uma página, do mais novo ao mais antigo.

application/json
  1. response
data*array<>
next_cursor*|

O cursor da próxima página, ou null na última.

Exemplo de requisição
curl -X GET 'https://app.zaplin.com.br/api/v1/conversations' \  -H 'Authorization: Bearer sk_live_...'
Exemplo de resposta
{  "data": [    {      "id": "string",      "status": "open",      "number_id": "string",      "contact_id": "string",      "group_id": "string",      "assigned_member_id": "string",      "assigned_team_id": "string",      "unread": 0,      "created_at": "2026-10-17T12:00:00.000Z"    }  ],  "next_cursor": "string"}