Skip to main content
GET
Uma conversa, com o estado da IA

Authorizations

Authorization
string
header
required

Authorization: Bearer mcp_… — gere em Configurações → Tokens de API.

O token de API tem modo read ou write. Um token read responde 403 a qualquer verbo que não seja GET. As capacidades do token são a interseção com as da pessoa de quem ele herda o papel: se ela perder acesso na grade de Equipe, o token perde junto, sem ninguém revogar nada.

Token de agência (gerado no console da agência): vale para as empresas da agência, e a empresa de cada chamada vai no header X-Empresa: <slug da empresa>. Sem o header, 401. Num token de empresa o header é opcional e, se vier, tem de ser a própria empresa. O modo read vale igual: um token de agência de leitura só faz GET — é o token para pôr numa função que só consulta.

Path Parameters

id
string<uuid>
required

Response

OK

id
string<uuid>
channel
enum<string>
Available options:
whatsapp,
instagram
phone
string

No Instagram, é o identificador da pessoa na conta, não um telefone.

name
string | null
lead_id
string<uuid> | null
atendimento
enum<string>
  • aguardando — chegou mensagem e ninguém assumiu.
  • em_atendimento — alguém assumiu a conversa.
  • resolvida — encerrada.
Available options:
aguardando,
em_atendimento,
resolvida
owner
object | null

Quem do time assumiu a conversa. null = está na fila.

ia
object
unread
integer
last_message_at
string<date-time> | null
last_direction
enum<string> | null

in = a última fala foi do lead.

Available options:
in,
out
created_at
string<date-time>