Integração via API – Clinicorp + Leavo
1. Visão Geral
O Clinicorp é um dos sistemas de gestão mais usados por clínicas odontológicas no Brasil, com agenda, prontuário, orçamentos e financeiro. A integração com a Leavo permite que os agentes de IA atendam os pacientes no WhatsApp usando as informações e a agenda da clínica.
Casos de uso principais:
- Agendar avaliações consultando os horários livres da agenda
- Cadastrar os pacientes que chegam pelo WhatsApp e pelos anúncios
- Confirmar consultas e lembrar o paciente antes do horário
- Retomar pacientes que receberam orçamento e ainda não agendaram
Fluxos disponíveis:
- ✅ Leavo → Clinicorp: o agente consulta os horários e registra o agendamento na agenda da clínica
- ✅ Clinicorp → Leavo: os dados do paciente e da consulta ficam disponíveis para o agente e para o CRM
Diferencial: a recepção continua usando o Clinicorp normalmente, e o WhatsApp passa a ser atendido pela IA na hora, inclusive fora do horário comercial.
2. Documentação Oficial
Clinicorp:
Leavo:
3. Credenciais necessárias
A conexão usa as credenciais de API geradas pelo próprio Clinicorp:
| Credencial | Onde encontrar |
|---|---|
Usuário API | Clinicorp → Gerenciar Assinatura → Acesso Externo e integrações |
Token API | Clinicorp → Gerenciar Assinatura → Acesso Externo e integrações |
⚠️ Importante: o Token API dá acesso aos dados da clínica. Guarde em local seguro e compartilhe apenas com o time de implementação da Leavo.
4. Como configurar
Passo 1: Gerar as credenciais no Clinicorp
- Entre no Clinicorp com um usuário administrador
- Clique no seu usuário, no canto superior direito
- Abra Gerenciar Assinatura
- Entre em Acesso Externo e integrações
- Copie o Usuário API e o Token API
Passo 2: Conectar na Leavo
A conexão é feita junto com o time da Leavo na reunião de implementação, que já vem incluída no teste grátis:
- Informe o Usuário API e o Token API
- Defina quais profissionais e agendas o agente pode usar
- Defina os tipos de consulta que o agente pode marcar (por exemplo, avaliação) e a duração de cada um
Passo 3: Preparar o agente
- Na Base de conhecimento, adicione procedimentos, convênios, endereço e orientações da clínica
- No Treinamento, diga quando o agente deve oferecer a avaliação e quando deve passar para a recepção
- Teste o agente pelo chat de teste antes de ativar no número da clínica
5. Observações e Limitações
| Aspecto | Observação |
|---|---|
| Limite de uso | O Clinicorp limita o uso da API (por padrão, 25 requisições por hora) |
| Permissões | Gere as credenciais com um usuário que tenha acesso à agenda |
| Troca de token | Se um novo token for gerado no Clinicorp, atualize a conexão na Leavo |
| Valores | O agente só fala de preços que você colocar na base de conhecimento |
6. Troubleshooting
6.1 Agente não encontra horários
| Causa | Solução |
|---|---|
| Profissional ou agenda não liberados | ✅ Revise quais agendas o agente pode usar |
| Agenda sem horários livres no período | ✅ Confira a agenda no Clinicorp |
| Limite de requisições atingido | ✅ Aguarde a próxima hora ou fale com o suporte do Clinicorp |
6.2 Erro de autenticação
| Causa | Solução |
|---|---|
| Token gerado de novo ou revogado | ✅ Copie o token atual e atualize na Leavo |
| Usuário API incorreto | ✅ Confira em Acesso Externo e integrações |
7. Casos de Uso Práticos
7.1 Avaliação agendada pelo WhatsApp
Objetivo: transformar quem chega pelo anúncio em avaliação marcada
Fluxo:
- Paciente vê o anúncio e chama a clínica no WhatsApp
- O agente tira as dúvidas com as informações da clínica
- O agente consulta os horários livres no Clinicorp
- O paciente escolhe o horário e a avaliação é agendada
- O contato vai para a etapa "Avaliação agendada" no CRM da Leavo
7.2 Confirmação e lembrete
Objetivo: reduzir as faltas nas avaliações
Fluxo:
- Um dia antes, o paciente recebe a confirmação no WhatsApp
- Se pedir para remarcar, o agente oferece novos horários
- Quem não responde entra numa cadência de lembrete
