Guia Definitivo: Crie sua Secretária Médica com IA no WhatsApp (Sem Saber Programar)

Imagine o cenário: são 22h, a sua clínica está fechada, e um paciente manda mensagem no WhatsApp querendo saber o preço de uma consulta ou se aceitam o convênio X. Normalmente, essa mensagem ficaria parada até as 08h do dia seguinte.

E se uma inteligência artificial pudesse responder agora, com educação, precisão e — o mais importante — sem inventar informações, usando apenas o "Manual da Sua Clínica"?

Neste guia, vamos construir a "Clara", uma secretária virtual segura usando n8n (automação), Google Gemini (o cérebro) e uma técnica chamada RAG.

1. O Conceito: O que é RAG e por que você precisa dele?

A maioria das IAs (como o ChatGPT ou o Gemini padrão) funcionam como alguém fazendo uma prova de memória. Elas sabem muito sobre o mundo, mas não sabem o preço da consulta na sua clínica.

RAG (Retrieval-Augmented Generation) muda a regra do jogo. É como permitir que a IA faça uma "prova com consulta".

1. O paciente faz uma pergunta.

2. A IA abre o seu manual (PDF/Word).

3. Ela encontra a resposta exata.

4. Ela responde ao paciente.

Sem RAG, a IA "alucina" (inventa). Com RAG, ela é uma especialista no seu negócio.

2. A Lista de Compras (Ferramentas)

Para montar esse sistema, você precisará criar contas nestas plataformas (a maioria tem planos gratuitos):

1. n8n: O "maestro" que conecta tudo. É aqui que desenharemos o fluxo.

2. Google AI Studio: Onde pegaremos a chave de acesso (API Key) do modelo Gemini 1.5 Flash (rápido e barato).

3. Pinecone: O "cérebro digital". É um banco de dados onde guardaremos o manual da sua clínica de forma que a IA consiga ler.

4. Meta for Developers: Para ter acesso ao WhatsApp Business API oficial.

3. Passo a Passo: Mãos na Massa

Vamos dividir a construção em duas fases: Ensinar a IA e Ativar a IA.

FASE 1: O Treinamento (Ingestão de Dados)

Objetivo: Pegar o seu documento de texto e colocar dentro do cérebro da IA (Pinecone).

1. Prepare o Documento: Crie um arquivo (PDF ou TXT) com as informações da clínica. Veja o modelo ideal na Seção 4 deste artigo.

2. No n8n, crie um novo workflow chamado "Treinamento".

3. Adicione o nó Google Drive (ou "Read Binary File" se o arquivo estiver no computador) para carregar o documento.

4. Conecte-o a um nó chamado "Default Text Splitter".

   • Configuração: Defina o tamanho do pedaço (Chunk Size) para 500. Isso divide o texto em parágrafos para facilitar a leitura.

5. Conecte a um nó Pinecone.

   • Operation: "Upsert" (Inserir/Atualizar).

   • Isso transforma o texto em números (vetores) e guarda no banco de dados.

6. Clique em "Execute". Se der "Success", parabéns! Sua clínica agora "mora" na nuvem.

FASE 2: A Secretária em Ação (O Fluxo de Chat)

Objetivo: Receber mensagem no WhatsApp e responder.

Crie um novo workflow no n8n chamado "Secretária Médica":

1. O Gatilho: Adicione o nó WhatsApp Trigger. Conecte sua conta da Meta. Isso inicia o fluxo quando alguém manda "Oi".

2. O Cérebro: Adicione o nó AI Agent.

   • Ligue o WhatsApp Trigger nele.

   • Dentro do AI Agent, você precisará conectar 3 peças (como Lego):

     • Model: Escolha Google Gemini Chat Model. Insira sua API Key.

     • Memory: Escolha Window Buffer Memory. Isso permite que a IA lembre o nome do paciente durante a conversa.

     • Tool (A Chave Mestra): Escolha Vector Store Tool. Conecte ao mesmo Pinecone da Fase 1. É isso que permite à IA consultar o manual antes de falar.

3. A Personalidade: Dentro do nó AI Agent, existe um campo "System Instruction" (Instrução do Sistema). Cole o prompt que está na Seção 5 deste artigo.

4. A Resposta: Adicione o nó WhatsApp (Ação).

   • No campo "Text", arraste a resposta gerada pelo Agente de IA.

   • No campo "To" (Para), arraste o telefone do paciente que veio do primeiro nó.

4. O Documento de Treino (O Manual)

A IA só é tão boa quanto o documento que ela lê. Não suba folhetos bagunçados. Crie um documento limpo e estruturado exatamente assim:

MANUAL DA CLÍNICA EXEMPLO - USO INTERNO1. Horários:Segunda a Sexta: 08:00 às 19:00.Sábado: 08:00 às 12:00.Domingos: Fechado.2. Médicos e Especialidades:Dra. Ana Souza (Dermatologista): Atende terças e quintas. Foca em acne e procedimentos estéticos.Dr. Carlos Lima (Cardiologista): Atende segundas e quartas. Realiza risco cirúrgico.3. Valores e Convênios:Consulta Particular: R$ 350,00 (Dermatologia), R$ 400,00 (Cardiologia).Convênios Aceitos: Unimed, Bradesco Saúde e SulAmérica.Atenção: Não aceitamos Amil.4. Procedimento de Agendamento:Para agendar, o paciente deve informar: Nome completo, CPF e Convênio (ou se é particular).Em caso de emergência, orientar ir ao hospital.

5. O Prompt do Sistema (A "Alma" da Secretária)

Copie e cole este texto exato na configuração do seu AI Agent. Ele contém travas de segurança vitais para a área médica.

Você é a Clara, a assistente virtual da [Nome da Sua Clínica].
Sua missão é atender pacientes via WhatsApp com empatia, clareza e eficiência. DIRETRIZES DE COMPORTAMENTO:
- Use um tom calmo, acolhedor e profissional.
- Respostas curtas e diretas (o WhatsApp é dinâmico).
- Fale sempre em Português do Brasil. REGRAS DE OURO (SEGURANÇA - CRÍTICO):
1. ZERO DIAGNÓSTICO: NUNCA interprete exames, sugira remédios ou dê diagnósticos. Se o paciente relatar dor forte, falta de ar, sangramento ou qualquer sinal de urgência, responda: "Como sou uma IA, não posso avaliar quadros clínicos. Por favor, vá a um pronto-socorro ou ligue 192 imediatamente."
2. PRIVACIDADE: Não peça dados sensíveis desnecessários no chat inicial. COMO USAR O CONTEXTO (RAG):
- Antes de responder, USE A FERRAMENTA DE VETOR para ler o manual da clínica.
- Responda APENAS com base no manual.
- Se perguntarem algo que não está no manual (ex: "fazem cirurgia plástica?" e isso não constar no texto), diga: "Não tenho essa informação no momento, mas vou pedir para nossa recepção humana entrar em contato." NÃO INVENTE. FLUXO DE AGENDAMENTO:
1. Verifique a especialidade desejada.
2. Cheque no manual os dias que o médico atende.
3. Peça ao paciente a preferência (manhã/tarde).
4. Para finalizar o pré-agendamento, peça: Nome Completo e Telefone.
5. Avise que a equipe confirmará o horário exato em breve.

6. Checklist de Testes (Antes de lançar)

Não coloque o número da clínica no ar sem testar você mesmo. Faça os seguintes testes no WhatsApp:

1. Teste da Alucinação: Pergunte algo que sua clínica não faz (ex: "Vocês fazem parto humanizado?").

   • Correto: "Desculpe, não tenho essa informação. Vou passar para um humano."

   • Errado: "Sim, fazemos!" (Isso significa que o RAG falhou ou o prompt está fraco).

2. Teste da Emergência: Digite: "Estou com uma dor muito forte no peito".

   • Correto: A IA deve mandar você para o hospital imediatamente e recusar agendamento.

3. Teste do Preço: Pergunte o valor de uma consulta.

   • Correto: Ela deve consultar a tabela no documento e responder o valor exato.

Aqui está o código JSON pronto para copiar e colar diretamente no seu n8n.

Este template cria o Fluxo de Atendimento (Chat). Ele já vem configurado com o Prompt da "Clara", as conexões com o Gemini e a estrutura para o Pinecone.

Como usar:

1. Copie o código abaixo (clique no botão "Copy" no canto superior direito do bloco de código).

2. Abra o seu editor do n8n.

3. Clique em qualquer lugar vazio da tela e aperte Ctrl+V (ou Cmd+V no Mac).

4. Importante: Você verá caixas vermelhas nos nós. Isso é normal! Você precisa clicar nelas para adicionar suas próprias Credenciais (Chaves de API do Google, Pinecone e Meta/WhatsApp).

{ "nodes": [ { "parameters": { "modelName": "models/gemini-1.5-flash", "options": {} }, "type": "@n8n/n8n-nodes-langchain.lmChatGoogleGemini", "typeVersion": 1, "position": [ 60, 560 ], "id": "model-gemini-chat", "name": "Google Gemini Chat Model", "credentials": { "googlePalmApi": { "id": "SUA_CREDENTIAL_ID_AQUI", "name": "Google Gemini(PaLM) Api account" } } }, { "parameters": { "contextWindowLength": 10 }, "type": "@n8n/n8n-nodes-langchain.memoryBufferWindow", "typeVersion": 1.2, "position": [ 200, 560 ], "id": "memory-window", "name": "Window Buffer Memory" }, { "parameters": { "options": { "systemMessage": "Você é a Clara, a assistente virtual da [Nome da Sua Clínica].\nSua missão é atender pacientes via WhatsApp com empatia, clareza e eficiência.\n\nDIRETRIZES DE COMPORTAMENTO:\n- Use um tom calmo, acolhedor e profissional.\n- Respostas curtas e diretas (o WhatsApp é dinâmico).\n- Fale sempre em Português do Brasil.\n\nREGRAS DE OURO (SEGURANÇA - CRÍTICO):\n1. ZERO DIAGNÓSTICO: NUNCA interprete exames, sugira remédios ou dê diagnósticos. Se o paciente relatar dor forte, falta de ar, sangramento ou qualquer sinal de urgência, responda: \"Como sou uma IA, não posso avaliar quadros clínicos. Por favor, vá a um pronto-socorro ou ligue 192 imediatamente.\"\n2. PRIVACIDADE: Não peça dados sensíveis desnecessários no chat inicial.\n\nCOMO USAR O CONTEXTO (RAG):\n- Antes de responder, USE A FERRAMENTA DE VETOR para ler o manual da clínica.\n- Responda APENAS com base no manual.\n- Se perguntarem algo que não está no manual (ex: \"fazem cirurgia plástica?\" e isso não constar no texto), diga: \"Não tenho essa informação no momento, mas vou pedir para nossa recepção humana entrar em contato.\" NÃO INVENTE.\n\nFLUXO DE AGENDAMENTO:\n1. Verifique a especialidade desejada.\n2. Cheque no manual os dias que o médico atende.\n3. Peça ao paciente a preferência (manhã/tarde).\n4. Para finalizar o pré-agendamento, peça: Nome Completo e Telefone.\n5. Avise que a equipe confirmará o horário exato em breve." } }, "type": "@n8n/n8n-nodes-langchain.agent", "typeVersion": 1.6, "position": [ 220, 300 ], "id": "ai-agent", "name": "Secretária IA (Clara)" }, { "parameters": { "name": "consultar_manual", "description": "Use esta ferramenta para consultar o manual da clínica sobre preços, horários, médicos e procedimentos.", "topK": 4 }, "type": "@n8n/n8n-nodes-langchain.toolVectorStore", "typeVersion": 1, "position": [ 380, 560 ], "id": "tool-vector-store", "name": "Vector Store Tool" }, { "parameters": { "mode": "retrieve", "pineconeIndex": { "__rl": true, "value": "minha-clinica", "mode": "list", "cachedResultName": "minha-clinica" } }, "type": "@n8n/n8n-nodes-langchain.vectorStorePinecone", "typeVersion": 1, "position": [ 380, 740 ], "id": "pinecone-store", "name": "Pinecone Vector Store", "credentials": { "pineconeApi": { "id": "SUA_CREDENTIAL_ID_AQUI", "name": "Pinecone Api account" } } }, { "parameters": { "modelName": "models/text-embedding-004" }, "type": "@n8n/n8n-nodes-langchain.embeddingsGoogleGemini", "typeVersion": 1, "position": [ 380, 920 ], "id": "embeddings-gemini", "name": "Google Gemini Embeddings", "credentials": { "googlePalmApi": { "id": "SUA_CREDENTIAL_ID_AQUI", "name": "Google Gemini(PaLM) Api account" } } }, { "parameters": {}, "type": "n8n-nodes-base.whatsappTrigger", "typeVersion": 1, "position": [ -20, 300 ], "id": "whatsapp-trigger", "name": "WhatsApp Trigger", "credentials": { "whatsappTriggerApi": { "id": "SUA_CREDENTIAL_ID_AQUI", "name": "WhatsApp Trigger account" } } }, { "parameters": { "operation": "send", "phoneNumberId": "={{ $json.metadata.phone_number_id }}", "to": "={{ $json.messages[0].from }}", "textBody": "={{ $json.output }}" }, "type": "n8n-nodes-base.whatsapp", "typeVersion": 1, "position": [ 680, 300 ], "id": "whatsapp-response", "name": "WhatsApp Response", "credentials": { "whatsappApi": { "id": "SUA_CREDENTIAL_ID_AQUI", "name": "WhatsApp account" } } } ], "connections": { "Google Gemini Chat Model": { "ai_languageModel": [ [ { "node": "Secretária IA (Clara)", "type": "ai_languageModel", "index": 0 } ] ] }, "Window Buffer Memory": { "ai_memory": [ [ { "node": "Secretária IA (Clara)", "type": "ai_memory", "index": 0 } ] ] }, "Vector Store Tool": { "ai_tool": [ [ { "node": "Secretária IA (Clara)", "type": "ai_tool", "index": 0 } ] ] }, "Pinecone Vector Store": { "ai_vectorStore": [ [ { "node": "Vector Store Tool", "type": "ai_vectorStore", "index": 0 } ] ] }, "Google Gemini Embeddings": { "ai_embedding": [ [ { "node": "Pinecone Vector Store", "type": "ai_embedding", "index": 0 } ] ] }, "WhatsApp Trigger": { "main": [ [ { "node": "Secretária IA (Clara)", "type": "main", "index": 0 } ] ] }, "Secretária IA (Clara)": { "main": [ [ { "node": "WhatsApp Response", "type": "main", "index": 0 } ] ] } }
}

O que você precisa ajustar neste template:

1. Credenciais do Google (Gemini): Nos nós "Google Gemini Chat Model" e "Google Gemini Embeddings", adicione sua chave de API.

2. Credenciais do Pinecone: No nó "Pinecone Vector Store", adicione sua chave. No campo "Pinecone Index", digite o nome exato do index que você criou no site do Pinecone (ex: minha-clinica).

3. Credenciais do WhatsApp: Nos nós "WhatsApp Trigger" e "WhatsApp Response", conecte sua conta Meta Business.

4. Prompt: No nó "Secretária IA (Clara)", revise o texto para garantir que o [Nome da Sua Clínica] foi substituído.

Pronto!

Você acabou de criar uma ferramenta que grandes empresas pagam fortunas para desenvolver. Sua "Clara" não se cansa, segue as regras à risca e libera sua recepção humana para cuidar de quem está presencialmente na clínica.

O segredo do sucesso aqui não é a tecnologia, é a qualidade do seu manual. Mantenha o documento sempre atualizado e sua secretária será perfeita