A IA de WhatsApp que integra com o Clinicorp precisa fazer três coisas que um chatbot comum não faz: consultar os horários livres direto na agenda do Clinicorp, criar a ficha do paciente quando ele ainda não existe, e gravar o agendamento no mesmo lugar onde a recepção já trabalha. Sem isso, a IA marca num sistema paralelo e alguém da clínica tem que digitar tudo de novo — que é exatamente o trabalho que ela deveria eliminar.

Este texto explica o que a integração faz, o que a API do Clinicorp entrega e o que ela não entrega, e quais decisões a clínica precisa tomar antes de ligar. É informação técnica de quem implementou, não folheto.

O que a integração faz na prática

O paciente escreve no WhatsApp da clínica. A IA entende o que ele busca, consulta a disponibilidade real dos profissionais no Clinicorp, oferece horários concretos e, quando ele escolhe, cria o agendamento — com a ficha do paciente montada na hora, se ele for novo.

Na prática, isso cobre o ciclo inteiro:

Consulta de horários por profissional, dia da semana e período ("terça de manhã", "quinta às 15h").
Criação do paciente no Clinicorp com nome, telefone e data de nascimento.
Agendamento gravado na agenda que a clínica já usa, com a queixa do paciente na observação.
Remarcação e cancelamento pelo próprio WhatsApp.
Lembrete e confirmação de presença antes da consulta, com o horário liberado se ninguém confirmar.

A recepção não digita nada. Ela abre o Clinicorp de manhã e o dia já está montado.

O que a API do Clinicorp entrega — e o que não entrega

Esta é a parte que ninguém conta antes de vender, e é a que mais atrasa implantação.

A API do Clinicorp devolve, entre outras coisas, a lista de procedimentos com a especialidade de cada um ("Peeling Salicílico" pertence a "Dermatologia") e a lista de profissionais da clínica. Duas listas completas e confiáveis.

O que ela não devolve é a ligação entre as duas. Em nenhum endpoint existe "a Dra. Fulana faz endodontia". A resposta de profissionais traz apenas identificador, nome e CPF — nada sobre especialidade.

Isso tem uma consequência concreta: se ninguém informar quem faz o quê, a IA não tem como recusar um agendamento errado. Ela vai oferecer a agenda de um profissional para um procedimento que ele não realiza, porque do ponto de vista da API os dois existem e nada os desmente.

A solução não é complicada, mas precisa ser feita: a clínica informa, uma vez, quais especialidades cada profissional atende. São três ou quatro linhas. Com essa metade que falta, o sistema passa a recusar a combinação errada antes de oferecer o horário — e ainda diz quem realiza aquele procedimento, para a IA redirecionar em vez de só negar.

Vale insistir num ponto: deduzir esse mapa a partir do catálogo é arriscado. O erro por excesso é silencioso — a IA recusa um agendamento legítimo, o paciente marca em outro lugar, e ninguém liga para reclamar de uma recusa.

Perguntas frequentes sobre a integração com o Clinicorp

A IA precisa pedir CPF para agendar no Clinicorp?

Não. O Clinicorp cria a ficha do paciente com nome e telefone; o CPF é opcional. É uma dúvida comum porque algumas integrações exigem o documento e travam o agendamento sem ele — e pedir CPF no primeiro contato derruba conversão, já que boa parte das pessoas não passa documento por WhatsApp. Se a clínica quiser coletar CPF, isso é uma escolha dela, não uma exigência do sistema.

Quais dados a IA coleta antes de agendar?

O mínimo que a clínica definir. Na maioria dos casos: nome completo, data de nascimento e o que a pessoa está buscando. Cada item a mais é uma pergunta a mais antes de fechar o horário, e isso tem custo de conversão — por isso a lista deve ser curta e decidida pela clínica, não pelo fornecedor.

A integração funciona se a clínica agenda por cadeira, e não por profissional?

Sim. O Clinicorp permite os dois modos, e o agendamento é gravado no formato certo em cada um. Uma ressalva honesta: a consulta de horários livres continua sendo por profissional nos dois casos, porque a API do Clinicorp não oferece disponibilidade por cadeira. Numa clínica que raciocina em cadeiras, é bom saber disso antes de começar.

E se a conta tiver mais de uma unidade?

Funciona, mas a unidade precisa ser informada explicitamente na configuração. Sem isso, o sistema escolheria uma unidade sozinho — e agendar na unidade errada é o tipo de erro que só aparece quando o paciente chega no endereço errado.

A IA consegue dizer o preço dos procedimentos?

A API devolve o nome do procedimento e a especialidade, mas não o valor. Preço, quando a clínica quiser que a IA fale, é informação configurada à parte — e a recomendação é quase sempre não falar valor por WhatsApp em procedimento que depende de avaliação.

O que acontece se o paciente já tiver ficha no Clinicorp?

O sistema procura pelo telefone antes de criar qualquer coisa. Se a ficha existe, o agendamento entra nela; se não existe, a ficha é criada. O cuidado importante é com telefone compartilhado — mãe que agenda para o filho, casal que usa o mesmo número —, e aí o nome informado na conversa é que decide de quem é o agendamento.

Quanto tempo leva para ligar a integração?

A parte técnica é rápida: usuário e token da API do Clinicorp, e o sistema já lê profissionais, procedimentos e agenda. O que leva tempo é o resto — as regras da clínica, quem atende o quê, quando cobra avaliação, o que fazer com emergência. Essa parte não dá para acelerar sem pagar depois.

Os erros que aparecem quando a configuração fica pela metade

Integração ligada não é o mesmo que IA pronta. Os defeitos mais comuns têm sempre a mesma origem — falta de contexto, não falta de tecnologia:

Oferecer o horário de um profissional que não faz aquele procedimento — o mapa de especialidades não foi informado.
Negar um horário que existe — a lista de horários mostrada é uma amostra, e a IA a trata como completa.
Agendar sem procedimento — o horário fica ocupado na agenda com o motivo em branco, e a profissional descobre no dia.
Perder a queixa do paciente — quando o ponto de entrada é sempre a avaliação, todo agendamento sai com o mesmo nome, e quem atende abre a agenda sem saber o que a pessoa veio buscar.

Nenhum desses é problema do Clinicorp. São decisões que a clínica precisa tomar e alguém precisa perguntar.

Como começar

Três coisas, nesta ordem:

Usuário e token da API do Clinicorp — a clínica gera nas configurações de integrações.
Quem faz o quê, por especialidade. É a informação que o Clinicorp não tem e ninguém consegue adivinhar.
As regras de atendimento: horário de funcionamento, quando cobra avaliação, o que fazer com emergência, o que a IA nunca deve dizer.

Com isso, a IA passa a atender à noite, no fim de semana e no feriado, e o agendamento cai direto na agenda que a clínica já usa — sem ninguém redigitar nada.

Qual IA de WhatsApp integra com o Clinicorp e agenda direto na agenda da clínica