Integração n8n + Kommo + IA

Arquitetura Geral

Objetivo: Implementar um assistente virtual inteligente no WhatsApp do HOA que entende linguagem natural, consulta agendas reais dos médicos e agenda consultas automaticamente, 24 horas por dia.

Canal de Comunicação

Interface com o paciente

WhatsApp via Kommo

CRM

Gestão de leads e pipeline

Kommo

Orquestrador

Automação de fluxos

n8n

Motor de IA

Compreensão e geração de linguagem

Claude API / OpenAI

Sistema Externo

Agenda médica e prontuário

Software da clínica

Fluxo Geral do Sistema

Paciente envia mensagem no WhatsApp

Kommo recebe a mensagem e dispara webhook para o n8n

n8n recebe o webhook, busca contexto da conversa e monta o prompt

IA analisa a intenção do paciente e gera resposta + ações

n8n executa ações (consulta agenda, cria agendamento, atualiza lead)

Kommo envia resposta ao paciente via WhatsApp

Paciente recebe a resposta no WhatsApp

Papel do Kommo CRM

Funções do Kommo nesta arquitetura

Recebe e envia mensagens do WhatsApp
Armazena leads e contatos
Gerencia o pipeline de atendimento
Dispara webhooks para o n8n quando eventos ocorrem
Exibe o histórico de conversas para atendentes humanos

API do Kommo utilizada pelo n8n

Ação	Endpoint	Método
Enviar mensagem	API de Chats	POST
Criar/atualizar lead	/api/v4/leads	POST/PATCH
Criar contato	/api/v4/contacts	POST
Adicionar nota	/api/v4/leads/{id}/notes	POST
Criar tarefa (agendamento)	/api/v4/tasks	POST
Atualizar tarefa	/api/v4/tasks/{id}	PATCH
Mover lead no pipeline	/api/v4/leads/{id}	PATCH
Adicionar tags	/api/v4/leads/{id}/tags	POST

Papel do n8n (Orquestrador)

O n8n é o cérebro operacional do sistema. Ele recebe eventos, processa com IA, executa ações e responde ao paciente. Tudo passa pelo n8n.

Funções do n8n

Recebe webhooks do Kommo quando uma mensagem chega

Recupera o contexto da conversa (histórico, dados do lead)

Envia a mensagem + contexto para a IA processar

Interpreta a resposta da IA e identifica ações necessárias

Executa ações automáticas (consultar agenda, agendar, cancelar)

Responde ao paciente via API do Kommo

Atualiza o lead no Kommo (campos, etapa, tags)

Workflows do n8n

Workflow	Gatilho	Função
1. Atendimento Principal	Webhook (mensagem recebida)	Processar mensagem com IA, executar ações, responder
2. Follow-up Automático	Agendado (a cada 1h)	Enviar lembrete para leads sem resposta há 24h
3. Lembrete de Consulta	Agendado (diário às 8h)	Enviar lembrete 24h antes da consulta
4. Pós-consulta	Agendado (diário às 10h)	Mensagem de acompanhamento 3 dias após consulta

Nodes do n8n utilizados

Node	Função
Webhook	Receber eventos do Kommo
HTTP Request	Chamar APIs (Kommo, IA, sistema de agendamento)
IF / Switch	Lógica condicional (roteamento por intenção)
Set	Transformar e preparar dados
Code	Lógica customizada (formatar prompts, parsear respostas)
Schedule Trigger	Disparar workflows em horários programados
Merge	Combinar dados de múltiplas fontes

Papel da Inteligência Artificial

Funções da IA

Capacidade	Descrição
Compreender	Interpreta a intenção do paciente em linguagem natural
Manter contexto	Lembra do que foi conversado (memória de curto prazo)
Gerar respostas	Cria respostas humanizadas e profissionais
Classificar	Identifica a intenção em ações executáveis
Extrair dados	Identifica nome, convênio, especialidade na conversa

Classificação de Intenções

A IA classifica cada mensagem em uma das seguintes intenções, que determinam a ação do n8n:

Intenção	Gatilhos (exemplos)	Ação do n8n
greeting	"olá", "oi", "bom dia"	Responder com saudação
schedule	"agendar", "marcar", "consulta"	Iniciar fluxo de agendamento
reschedule	"remarcar", "mudar horário"	Buscar agendamentos + novos horários
cancel	"cancelar", "desmarcar"	Buscar agendamentos + cancelar
surgery_info	"cirurgia", "catarata", "laser"	Informar + oferecer agendamento
emergency	"emergência", "urgente", "perdi a visão"	Enviar dados de emergência
insurance	"convênio", "plano", "valor"	Listar convênios ou transferir
hospital_info	"endereço", "horário", "telefone"	Enviar informações do hospital
transfer_human	"atendente", "humano", "pessoa"	Transferir para atendente
farewell	"obrigado", "tchau", "até logo"	Encerrar conversa

Formato de Resposta da IA

A IA responde sempre em JSON estruturado para que o n8n possa interpretar e executar ações:

{
  "message": "Texto da resposta para o paciente",
  "intent": "schedule",
  "action": {
    "type": "check_availability",
    "data": {
      "specialty": "Oftalmologia Geral",
      "date_start": "2026-06-15"
    }
  },
  "extracted_data": {
    "patient_name": "João Silva",
    "insurance": "IPASGO"
  },
  "tags": ["#agendamento"],
  "lead_stage": "Qualificado"
}

Fluxo Detalhado de Agendamento

Exemplo real de conversa com agendamento

Paciente: "Quero marcar uma consulta de oftalmologia"

IA identifica: intent=schedule, specialty=Oftalmologia Geral

Bot responde: "Para agendar sua consulta, você possui convênio?"

Paciente: "Sim, IPASGO"

Bot responde: "IPASGO é aceito. Tem preferência de horário?"

Paciente: "De manhã, semana que vem"

n8n chama API: GET /availability?professional_id=101

Bot responde: "Dr. Augusto tem horários: Seg 08:00, 08:30, 10:00 | Ter 09:00, 09:30"

Paciente: "Segunda às 10h"

n8n executa: Cria agendamento na API + Task no Kommo + Atualiza lead

Bot confirma: "Consulta agendada! Dr. Augusto - 15/06 às 10:00 - IPASGO"

Comparativo: Salesbot Nativo vs n8n + IA

Tabela comparativa

Aspecto	Salesbot Nativo (Kommo)	n8n + IA
Compreensão de linguagem	Palavras-chave fixas	Linguagem natural (IA)
Respostas	Mensagens pré-definidas	Dinâmicas e contextuais
Fluxo de conversa	Árvore de decisão fixa	Conversa livre e adaptativa
Integração com sistemas	Limitado	Ilimitado (qualquer API)
Consulta de agenda em tempo real	Não suportado	Sim, via API
Agendamento automático	Apenas calendário Kommo	Sistema externo + Kommo
Triagem por sintomas	Menu fixo numérico	IA entende descrição livre
Manutenção	Editar cada bloco do bot	Atualizar prompt de texto

Exemplo prático: Paciente descreve sintomas

Salesbot Nativo (sem IA)

Bot: "Em qual especialidade você gostaria de agendar? 1 - Oftalmologia Geral, 2 - Oftalmopediatria..."

Paciente: "Estou vendo umas manchinhas flutuantes e minha visão fica embaçada"

Bot: "Desculpe, não entendi. Por favor, escolha uma das opções de 1 a 11."

O bot falha porque espera um número, não uma descrição.

n8n + IA

Bot: "Como posso ajudar você hoje?"

Paciente: "Estou vendo umas manchinhas flutuantes e minha visão fica embaçada"

Bot: "Entendo sua preocupação, João. Os sintomas que você descreve podem estar relacionados à retina. Recomendo uma consulta com nosso especialista em Retina e Vítreo. Gostaria de agendar?"

A IA entende linguagem natural e direciona corretamente.

Infraestrutura e Custos

n8n

Opção	Descrição	Custo estimado
n8n Self-hosted	VPS próprio com Docker	R$ 50-100/mês
n8n Cloud Starter	Hospedagem gerenciada	US$ 24/mês
n8n Cloud Pro	Mais execuções e recursos	US$ 60/mês

API de IA

Provedor	Modelo	Custo por mensagem
Anthropic	Claude Haiku 4.5	~US$ 0,0008
OpenAI	GPT-4o mini	~US$ 0,0003
Anthropic	Claude Sonnet 4	~US$ 0,003
OpenAI	GPT-4o	~US$ 0,005

Estimativa: 1.000 conversas/mês com ~10 mensagens cada = Claude Haiku ~US$ 8/mês

Kommo CRM

Plano	Preço	Observação
Base	US$ 15/usuário/mês	Mínimo para integração
Advanced	US$ 25/usuário/mês	Recomendado

Custo total estimado por mês

~R$ 450

~US$ 82 (Kommo + n8n + IA)

Cronograma de Implementação

Semana 1

Configuração Base

Configurar conta n8n (cloud ou self-hosted)
Configurar integração Kommo + WhatsApp
Criar webhook no Kommo apontando para n8n
Testar envio/recebimento de mensagens
Configurar API key da IA

Semana 2

Workflow Principal

Criar workflow de atendimento principal no n8n
Desenvolver e refinar o prompt da IA
Implementar gestão de contexto de conversa
Implementar classificação de intenções
Testar fluxo completo de conversa

Semana 3

Integração com Agenda

Integrar com API do sistema de agendamento
Implementar consulta de disponibilidade
Implementar criação de agendamento
Implementar reagendamento e cancelamento
Testar fluxo completo com agenda real

Semana 4

Automações e Refinamento

Criar workflows de follow-up, lembrete e pós-consulta
Refinar prompts com base nos testes
Configurar tratamento de erros e fallbacks
Treinar equipe no uso do sistema

Segurança e Conformidade (LGPD)

Proteção de Dados

Requisito LGPD	Implementação
Consentimento	Primeira mensagem solicita aceite do paciente
Finalidade	Dados usados apenas para agendamento e atendimento
Minimização	Coletar apenas dados necessários
Armazenamento	Dados ficam no Kommo (servidor seguro)
Exclusão	Paciente pode solicitar exclusão dos dados

Segurança das Integrações

Aspecto	Medida
Webhooks	Validação de assinatura do Kommo
APIs	Tokens com escopo mínimo necessário
n8n	Acesso protegido por autenticação
Dados sensíveis	Credenciais em variáveis de ambiente
Logs	Não registrar dados pessoais em logs

Resumo Executivo

O que será feito

Implementação de um assistente virtual inteligente no WhatsApp do HOA que:

Atende 24 horas por dia, sem depender de horário comercial
Entende linguagem natural - o paciente pode escrever como quiser
Consulta a agenda real dos médicos em tempo real
Agenda, reagenda e cancela consultas automaticamente
Faz triagem inteligente - identifica a especialidade pelos sintomas
Mantém o contexto - lembra do que foi conversado
Transfere para humano quando necessário, com todo o contexto
Envia lembretes de consulta e acompanhamento pós-consulta

Como funciona tecnicamente

Kommo recebe as mensagens do WhatsApp e gerencia os leads
n8n orquestra toda a lógica, conectando Kommo, IA e sistema de agendamento
IA entende o que o paciente quer e gera respostas humanizadas
API de agendamento permite consultar e agendar na agenda real dos médicos

Resultado esperado

Redução significativa no tempo de resposta ao paciente
Atendimento disponível fora do horário comercial
Menos carga de trabalho para a equipe de atendimento humano
Agendamentos mais precisos (especialidade correta, horário disponível)
Melhor experiência para o paciente (conversa natural, sem espera)

Atendimento Inteligente via WhatsApp