Integrações/NicoApps (MiniApps) Nativos/Sistemas de Negócios Locais/Clinicorp

Clinicorp

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 c

2026-08-07
Nota
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

Nota
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 /security/list_users
Listar Clínicas
Lista as clínicas/unidades da conta
Nenhuma (usa a credencial da conta)
GET /business/list
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 /business/list_available_times
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 /patient/get
Criar um Paciente
Cadastra um novo paciente
Nome (obrigatório); Nascimento, Sexo, E-mail, Celular, CPF/Documento, Observações
POST /patient/create
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 /appointment/create_appointment_by_api
Recuperar um Agendamento
Consulta os detalhes de um agendamento pelo ID
ID do Agendamento
GET /appointment/get_appointment
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 /appointment/list
Confirmar Agendamento
Marca um agendamento existente como confirmado
ID do Agendamento
POST /appointment/confirm_appointment
Cancelar Agendamento
Cancela um agendamento existente
ID do Agendamento
POST /appointment/cancel_appointment
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 /estimates/list
Retornar os orçamentos de um paciente
Retorna o orçamento de um tratamento específico
ID do Tratamento
GET /estimates/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 /crm/add_leads

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.
Nota
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.