Gerenciar o atendimento e agendamento de consultas em clínicas com mais de uma unidade física é um desafio operacional recorrente. No setor veterinário e de saúde, tutores e pacientes buscam agilidade pelo WhatsApp, mas erros de alocação de agenda, conflitos de horário e falta de contexto entre atendentes manuais geram atrito e perda de receita.
A solução para essa complexidade não reside em chatbots lineares baseados em árvores de decisão engessadas, mas na união de três camadas tecnológicas: WhatsApp Cloud API (WABA), modelos de linguagem avançados (como Claude da Anthropic) e orquestração visual de dados com o n8n conectada a um CRM robusto como o GoHighLevel (GHL).
Neste artigo, você entenderá como arquitetar um agente inteligente no n8n capaz de compreender linguagem natural, identificar a unidade correta e processar agendamentos diretamente no calendário do GoHighLevel.
Arquitetura da Solução
O ecossistema divide-se em quatro pilares fundamentais:
- WhatsApp Cloud API (Meta): Recebe e envia mensagens oficiais via Webhooks com segurança e estabilidade.
- n8n (Motor de Orquestração): Processa os payloads, mantém a memória de conversa, executa lógica condicional e conecta APIs externas.
- Claude (LLM via n8n AI Agent): Analisa a intenção da mensagem, extrai entidades (nome do pet, especialidade, unidade desejada) e aciona funções (
tool calling). - GoHighLevel (CRM & Agendamento): Armazena o cadastro do contato, gerencia os diferentes Calendars vinculados a cada Location ID (unidade) e confirma a reserva.
Passo a Passo da Implementação no n8n
1. Recepção e Validação do Webhook do WhatsApp
O fluxo inicia com o nó Webhook do n8n configurado para capturar eventos de messages da Meta.
- Configure a verificação de assinatura (
hub.challenge) para a validação inicial do webhook. - Filtre mensagens de status (
sent,delivered,read) usando um nó If ou Switch, garantindo que apenas novas mensagens de texto ou áudio entrem no fluxo. - Normalize os dados: extraia o número de telefone (formato E.164) e o conteúdo da mensagem.
2. Consulta de Perfil no GoHighLevel
Antes de acionar a inteligência artificial, o n8n consulta a API do GoHighLevel para recuperar o histórico do cliente:
- Utilize o nó HTTP Request autenticado com a API Key ou OAuth do GoHighLevel.
- Busque o contato pelo telefone (
/contacts/search/duplicate?phone={{{ $json.phone }}}). - Se o contato existir, recupere campos personalizados como unidade preferencial e histórico de pets cadastrados.
3. Configuração do n8n AI Agent com Claude
No n8n, utilize o nó AI Agent conectado a um Chat Model (Anthropic/Claude 3.5 Sonnet) e um Window Buffer Memory para manter o contexto dos últimos diálogos.
O System Prompt deve conter regras operacionais claras:
- Identificar o motivo da consulta (ex: rotina, vacina, ortopedia).
- Perguntar ou confirmar a unidade de atendimento desejada.
- Chamar as ferramentas de verificação de horários antes de confirmar qualquer agendamento.
- Regra de segurança: Se for identificada uma emergência grave, o agente deve orientar o tutor a se dirigir imediatamente ao pronto-socorro mais próximo e pausar a IA.
4. Integração de Tools (Ferramentas) de Agendamento
O agente utiliza nós do tipo Custom Tool no n8n para consultar e gravar dados no GoHighLevel:
- Tool 1:
consultar_disponibilidade - Entradas:
location_id,calendar_id,data_inicio,data_fim. - Ação: Faz requisição ao endpoint
/calendars/{calendarId}/free-slotsdo GHL e retorna as janelas livres para a IA. - Tool 2:
criar_agendamento - Entradas:
contact_id,calendar_id,selected_slot. - Ação: Dispara POST para
/calendars/events/appointmentsregistrando o agendamento oficial.
5. Resposta Formatada no WhatsApp
Após a execução das ferramentas pelo LLM, a resposta em texto natural é enviada de volta ao usuário via nó HTTP Request (ou nó dedicado do WhatsApp Cloud API), confirmando data, horário, unidade e instruções pré-consulta.
Boas Práticas e Tratamento de Exceções
Como especialista em n8n e arquiteturas de atendimento automatizado, recomendo implementar três camadas de controle em produção:
- Fallback Humano: Se a IA não atingir um grau de confiança ou se o usuário solicitar um operador, altere o campo
statusno GHL para ‘Atendimento Manual’ e pause o acionamento do agente para aquele número. - Validação de Timezone: Certifique-se de que todas as requisições de slots de agenda no GHL convertam horários UTC para o fuso horário correto de cada clínica.
- Bloqueio de Loops: Limite a quantidade de iterações do AI Agent por ciclo para evitar consumo desnecessário de tokens de API.
Conclusão e Próximos Passos
Estruturar um agente de WhatsApp inteligente com n8n e GoHighLevel transforma o atendimento receptivo em uma esteira autônoma de agendamento, reduzindo a sobrecarga da equipe e eliminando erros de marcação entre diferentes unidades.
Se a sua empresa precisa de uma arquitetura personalizada de automação com IA, n8n e integração avançada a CRMs, entre em contato para desenvolvermos uma solução sob medida para o seu modelo de negócio.
