Clínica Experts
Esta página do wiki foi descontinuada e pode estar desatualizada. A documentação oficial e atualizada do NicoChat está em docs.nicochat.com/p/465-clinica-experts. Consulte sempre o link acima — o conteúdo abaixo é mantido apenas como histórico.
O Clínica Experts é o NicoApp de integração com o sistema de gestão de clínicas Clínica Experts (app.clinicaexperts.com.br). Com ele, o bot do NicoChat cria, edita e busca pacientes cadastrados na clínica diretamente pelo fluxo de conversa, usando a API oficial /api/v1/patients.
App de autoria própria da NicoChat, em Beta (v1.0.0), já instalado em canais de clientes. Disponível na aba de NicoApps.
Como obter as credenciais (token) da API
A Clínica Experts não publica um guia de integrações/API para desenvolvedores. Solicite ao suporte ou ao gerente de conta da Clínica Experts a liberação do token de integração.
O que confirmamos pela configuração técnica do miniapp:
A autenticação é por token único (Bearer) — não usa usuário + senha (Basic Auth). Na instalação do app, é pedido apenas um campo de Token.
O endpoint base consumido é
https://app.clinicaexperts.com.br/api/v1/patients.
Recomendação: contate o suporte ou o gerente de conta da Clínica Experts para solicitar a liberação de uma chave de API para integrações externas. Vale perguntar também se existe uma tela de "Integrações" no painel da clínica, já que o acesso pode estar vinculado a um plano específico.
Limitações
Limite de requisições e exigência de plano específico para a API não são divulgados publicamente pela Clínica Experts. Confirme com o suporte ou gerente de conta antes de dimensionar fluxos de alto volume.
Sem informação pública sobre rate limit ou cota mensal da API.
Sem informação pública sobre a API exigir um plano específico da Clínica Experts.
Trate sempre o caminho de erro das ações (mapeamento
$.errors) — é a única forma de saber se a Clínica Experts recusou uma chamada (ex.: paciente duplicado, campo inválido, token expirado ou sem permissão).
O que o miniapp faz
O app está estruturado em 5 sub-fluxos. Destes, 3 ações estão prontas e publicadas — é o que a tabela abaixo documenta:
Ação | O que faz | Entradas principais | Saídas |
|---|---|---|---|
Criar Paciente | Cadastra um novo paciente na Clínica Experts | Nome, E-mail, Telefone, Anotação, Data de Nascimento, Sexo, Estado Civil, Profissão, Notificações (SMS/WhatsApp/E-mail), Documento (tipo + número), Origem, Contatos (Facebook/Instagram); Endereço (CEP, Rua, Número, Complemento, Bairro, Cidade, Estado, País) — enviado apenas se o CEP for preenchido | ID do Paciente (uuid), Erros |
Editar Paciente | Atualiza os dados de um paciente existente (atualização parcial: só envia os campos preenchidos) | ID do Paciente (obrigatório) + qualquer campo do Criar Paciente que precise mudar | ID do Paciente, Erros |
Buscar Paciente | Busca um paciente cadastrado pelo e-mail | ID do Paciente (uuid), Erros |
Nota técnica (achado desta revisão): na configuração atualmente salva de Buscar Paciente, o parâmetro de e-mail usado na chamada aparece fixo em um valor de teste, em vez de vinculado à variável de entrada do fluxo. Antes de divulgar esta ação amplamente, valide com um teste real — buscando por um e-mail diferente do usado nos testes — se o resultado corresponde ao e-mail informado.
Horários disponíveis e Webhook existem no builder deste app, mas estão em rascunho (não publicados) e inconsistentes: "Horários disponíveis" ainda chama o endpoint de pacientes (/api/v1/patients) em vez de um endpoint de agenda/horários, e "Webhook" está vazio, sem nenhuma lógica implementada. Não use essas duas ações em produção até serem revisadas e corrigidas.
Dicas e observações
Tratamento de erros: todas as ações mapeiam a resposta de erro da API (
$.errors) em uma variável — use o caminho de erro do bloco de ação para tratar falhas no fluxo (ex.: paciente duplicado, campo obrigatório faltando, token inválido).Endereço opcional: no Criar Paciente, o bloco de endereço só é enviado se o campo CEP estiver preenchido.
Atualização parcial: no Editar Paciente, só é necessário informar os campos que realmente mudaram — campos vazios não sobrescrevem o que já está cadastrado.
ID do Paciente (uuid): guarde-o em uma variável do bot assim que criar ou buscar um paciente, para reutilizar nas próximas ações (ex.: Editar Paciente).
Token: trate como segredo — configure apenas no campo de autenticação do app na instalação, nunca em texto livre dentro do fluxo.