Clínica Experts
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 paciente
Nota
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
Atenção
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
Atenção
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
E-mail
ID do Paciente (uuid), Erros
Nota
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.
Atenção
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.