O cadastro por dentro.

Vídeo em regravação

O laudo veio com o nome CUNHA, LEONARDO. Quem é?

Não há ninguém com esse nome exato. O mais parecido é Leonardo Cunha, de Criciúma, com 97% de semelhança no nome. Antes de usar esse cadastro, confirme a data de nascimento dele no laudo.

Pergunte à sua IA…
  • Abaixo de 0,6, nada

    A busca aproximada não devolve "o mais parecido" de qualquer jeito: abaixo do limiar, a lista vem vazia.

Ferramentas MCP

  • Ler

    Buscar (com a aproximada quando não há nome exato), abrir a ficha e analisar duplicados.

    • clientes_find
    • clientes_get_context
    • clientes_analisar_duplicados
  • Escrever com prévia

    Cadastro, revisado, convênio, pedido de convênio, etiquetas e família.

    • clientes_upsert
    • clientes_marcar_revisado
    • clientes_manage_convenio
    • clientes_convenio_solicitacao
    • clientes_manage_tags
    • clientes_manage_relacionamento
  • Mesclar

    Prévia por padrão; executa só com confirmação e semelhança mínima de 0,7.

    • clientes_mesclar_duplicados
    • POST /clientes/{id}/mergear/{id2}

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.

  • Cadastro

    Listar, buscar, ler, criar, editar e marcar como revisado.

    • GET /clientes/
    • GET /clientes/search/
    • GET /clientes/{id}
    • POST /clientes/
    • PUT /clientes/{id}
    • POST /clientes/{id}/review
  • Pelo telefone

    O paciente de um número, sem devolver o número; ambíguo, devolve os candidatos e não escolhe.

    • POST /clientes/resolver-telefone
  • Convênio, família e etiquetas

    Carteirinhas, pedidos de convênio, vínculos e etiquetas.

    • GET /clientes/convenio
    • POST /clientes/convenio
    • GET /clientes/convenio/solicitacao/pendentes
    • POST /clientes/convenio/solicitacao/{id}/aprovar
    • POST /clientes/convenio/solicitacao/{id}/rejeitar
    • GET /clientes/{id}/relacionamentos
    • POST /clientes/{id}/relacionamentos
    • GET /clientes/{id}/tags
    • POST /clientes/{id}/tags
    • GET /clientes/tags/{tag}/clientes
Achar pelo telefone ou cadastrar, sem duplicarpython
token = post(AUTH, {"grant_type": "client_credentials",
                    "client_id": CLIENT_ID, "client_secret": CLIENT_SECRET})["access_token"]

r = post(f"{API}/clientes/resolver-telefone", token, {"telefone": "5548999990000"})
if r["ambiguo"]:
    print("mais de um paciente com esse número:", [c["nome"] for c in r["candidatos"]])
elif r["candidatos"]:
    paciente_id = r["candidatos"][0]["cliente_id"]
else:
    # repetir a chamada com a mesma chave não cria outro cadastro
    novo = post(f"{API}/clientes/", token, {"nome": "Marina Souza", "telefone": "5548999990000"},
                headers={"Idempotency-Key": "lead-2026-11-11-0042"})
    paciente_id = novo["id"]

Regras

  • Busca enxuta

    Listas e buscas devolvem id, nome, cidade e revisado; o resto só na ficha, com permissão própria.

  • CPF só na criação

    Pela IA, o CPF entra ao criar e não se repete; corrigir CPF é pela Central.

    • clientes_upsert
  • Fora da IA

    Apagar paciente, apagar todas as etiquetas de uma vez e excluir carteirinha.

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
  • "O laudo veio com o nome CUNHA, LEONARDO. Quem é?"clientes_find
  • "Compara esses dois cadastros e mostra o que mudaria ao mesclar."clientes_analisar_duplicados
  • "Liga a Ana como responsável pelo Lucas. Me mostra antes."clientes_manage_relacionamento

Digite pelo menos 2 letras.