ZaplinDocs
GuiasReferência da APIMCPChangelogAbrir o app

Ler conversa

GET
/v1/conversations/{id}

Uma conversa: seu contato, número, equipe, responsável e status.

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 caminho

id*string

O id.

Corpo da resposta

Feito.

application/json
  1. response
id*string
status*string
Valor em"open""closed"
number_id*string
contact_id*string|null
group_id*string|null
assigned_member_id*string|null
assigned_team_id*string|null
unread*integer
Intervalo-9007199254740991 <= value <= 9007199254740991
created_at*string
Formatodate-time
Exemplo de requisição
curl -X GET 'https://app.zaplin.com.br/api/v1/conversations/string' \  -H 'Authorization: Bearer sk_live_...'
Exemplo de resposta
{  "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"}