As conversas por dentro.
Tem conversa esperando alguém da equipe?
Há 5 atendimentos abertos. Quatro estão esperando o paciente responder ao lembrete da consulta, como os do Felipe, da Carla e da Gabriela. Um está sem dono: o paciente respondeu "Sim, confirmo" e ninguém pegou ainda.
Sem telefone
A caixa de entrada pela IA vem sem telefone, e o conteúdo privado já chega oculto.
Ferramentas MCP
Ler
Caixa de entrada, não lidas, um atendimento, o histórico do paciente e as métricas.
- interacoes_inbox
- interacoes_contadores
- interacoes_get_ticket
- interacoes_feed_paciente
- interacoes_ticket_metricas
Mover o atendimento
Pegar, transferir, mandar para a fila, escalar, devolver, resolver, cancelar e reabrir.
- interacoes_atribuir_ticket
- interacoes_transferir_ticket
- interacoes_transferir_para_fila
- interacoes_escalar_ticket
- interacoes_devolver_ticket
- interacoes_resolver_ticket
- interacoes_cancelar_ticket
- interacoes_reabrir_ticket
Mensagem automática governada
Lembrete ou aviso por modelo, com chave que não reenvia, horário da clínica e teto diário.
- mensageria_enviar_intencao
API REST
Para integração sem IA: token da integração e chamadas HTTP. A referência completa vem com o acesso que a clínica concede.
Caixa de entrada
Conversas, mensagens e o atendimento corrente de cada uma.
- GET /conversas
- GET /conversas/{conversa_id}/mensagens
- GET /conversas/{conversa_id}/ticket
Atendimento
Atribuir, transferir, escalar, devolver, pausar, resolver e cancelar.
- POST /conversas/{conversa_id}/ticket/atribuir
- POST /conversas/{conversa_id}/ticket/transferir
- POST /conversas/{conversa_id}/ticket/transferir-fila
- POST /conversas/{conversa_id}/ticket/resolver
- POST /conversas/{conversa_id}/ticket/escalar
- POST /conversas/{conversa_id}/ticket/devolver
- POST /conversas/{conversa_id}/ticket/pausar
- POST /conversas/{conversa_id}/ticket/cancelar
Métricas e auditoria
As métricas do período e os cancelamentos para auditar.
- GET /conversas/tickets/metricas
- GET /conversas/tickets/cancelados
- POST /conversas/tickets/{ticket_id}/auditar
token = post(AUTH, {"grant_type": "client_credentials",
"client_id": CLIENT_ID, "client_secret": CLIENT_SECRET})["access_token"]
r = get(f"{API}/conversas", token,
params={"fila": "nao_atribuidas", "situacao": "abertas"})
for c in r["conversas"]:
nome = c["contato"]["cliente_nome"] or c["contato"]["nome_temp"] or "sem cadastro"
print(nome, c["last_message_at"], "não lida" if c["nao_lida"] else "")Regras
A fronteira
Responder ao paciente uma a uma não vira ferramenta da IA: a mensagem já foi para o WhatsApp e não volta.
Resolver não é cancelar
Resolvido conta como atendimento; cancelado pede motivo, não conta como resolvido e pode ser auditado.
- GET /conversas/tickets/cancelados
- POST /conversas/tickets/{ticket_id}/auditar
Privada continua privada
Pela IA ou pela API, a mensagem privada chega oculta para quem não é o dono.
- POST /conversas/{conversa_id}/mensagens/{mensagem_id}/privacidade
- POST /conversas/{conversa_id}/mensagens/{mensagem_id}/revelar
Peça à sua IA
Pela conexão MCP, a IA que a clínica preferir age com as permissões de quem pediu: só faz o que essa pessoa pode fazer na Central.
Segurança para médicos builders- "Tem conversa esperando alguém da equipe?"interacoes_inbox · interacoes_contadores
- "Escala a conversa do Leonardo para a Dra. Roberta."interacoes_escalar_ticket
- "Qual foi o tempo médio de atendimento no último mês?"interacoes_ticket_metricas
