Clinicorp
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/461-clinicorp. Consulte sempre o link acima — o conteúdo abaixo é mantido apenas como histórico.
O Clinicorp é um sistema de gestão para clínicas médicas e odontológicas (agenda, prontuário, orçamentos/tratamentos, CRM de leads). O miniapp Clinicorp do NicoChat integra o bot com a API REST da Clinicorp, permitindo consultar e criar pacientes, agendar/cancelar/confirmar consultas, consultar orçamentos e adicionar leads ao CRM — tudo direto do fluxo de conversa.
Disponível na aba de NicoApps. Base da integração: API REST da Clinicorp (https://api.clinicorp.com/rest/v1/...).
Como obter as credenciais
Username: Informe o ID de acesso ao Sistema.
Password: Informe o Token API.
Como encontrar essas informações:
Fazer login no Sistema.
Clicar em Gerenciar Assinatura.
Clicar em Acesso Externo e Integrações.
Em Integrações: Usuário API (Username) | Token API (Password).
Limitações
Limite de requisições (rate limit) e exigência de plano específico não são divulgados publicamente pela Clinicorp. Confirme com o suporte Clinicorp antes de dimensionar fluxos de alto volume (ex.: agente de IA respondendo em tempo real).
O que o miniapp faz
Ação | O que faz | Principais entradas | Endpoint |
|---|---|---|---|
Retornar todos os usuários | Lista os usuários (colaboradores) cadastrados na conta | Nenhuma (usa a credencial da conta) | GET |
Listar Clínicas | Lista as clínicas/unidades da conta | Nenhuma (usa a credencial da conta) | GET |
Listar horários disponíveis | Lista os horários livres na agenda de um profissional em um período | ID do Profissional, ID da Clínica, Data Inicial, Data Final | GET |
Buscar um Paciente | Busca um paciente existente por nome, telefone, e-mail ou ID | Nome, Telefone, E-mail ou ID do Paciente (ao menos um) | GET |
Criar um Paciente | Cadastra um novo paciente | Nome (obrigatório); Nascimento, Sexo, E-mail, Celular, CPF/Documento, Observações | POST |
Criar Agendamento | Cria um agendamento; se o paciente informado pelo nome ainda não existir na Clinicorp, o próprio fluxo busca o paciente antes de agendar | Nome/ID do Paciente, Celular, E-mail, Data, Hora Início, Hora Fim, ID da Clínica, ID do Dentista | POST |
Recuperar um Agendamento | Consulta os detalhes de um agendamento pelo ID | ID do Agendamento | GET |
Retornar dados de agendamento de um paciente | Lista agendamentos filtrando por período, clínica e/ou paciente | Data Inicial, Data Final, ID da Clínica, ID do Paciente | GET |
Confirmar Agendamento | Marca um agendamento existente como confirmado | ID do Agendamento | POST |
Cancelar Agendamento | Cancela um agendamento existente | ID do Agendamento | POST |
Retornar todos os orçamentos da clínica | Lista os orçamentos/tratamentos de uma clínica em um período | Data Inicial, Data Final, ID da Clínica | GET |
Retornar os orçamentos de um paciente | Retorna o orçamento de um tratamento específico | ID do Tratamento | GET |
Adicionar Lead ao CRM | Cria um lead em um quadro/funil do CRM da Clinicorp | Nome, E-mail, Telefone, Nome do Quadro (BoardName), Observações | POST |
Dicas e observações
Tratamento de erro padrão: todas as ações seguem o mesmo padrão — se a Clinicorp retornar um erro, a ação cai no caminho de falha do bloco (
action_failed) trazendo a mensagem de erro real devolvida pela API. Use esse caminho para tratar exceções no fluxo (ex.: paciente não encontrado, agendamento inexistente).Criar Agendamento resolve o paciente automaticamente: se o agendamento for criado só com o nome do paciente (sem ID), o app primeiro tenta localizar um paciente com o mesmo nome antes de seguir — evitando duplicidade de cadastro.
Múltiplas agendas/unidades na mesma credencial: os campos de autenticação (usuário, token e agenda) aceitam valores separados por vírgula, permitindo que a mesma instalação atenda mais de uma agenda/unidade da clínica.
Uma ação legada chamada "Cria uma solicitação de agendamento ❌" foi identificada na estrutura do miniapp — o nome (com o emoji de "quebrado") sugere que ela está inconsistente ou depreciada. Por isso, ela não foi incluída na tabela de ações acima. Recomenda-se revisar essa ação no builder do miniapp e removê-la ou corrigi-la.