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, é 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) é uma técnica chamada RAG . 1. O Conceito: O que é RAG é 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". O paciente faz uma pergunta. A IA abre o seu manual (PDF/Word).

Ela encontra a resposta exata. 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): n8n: O "maestro" que conecta tudo.

É aqui que desenharemos o fluxo. Google AI Studio: Onde pegaremos a chave de acesso (API Key) do modelo Gemini 1.5 Flash (rápido é barato). Pinecone: O "cérebro digital".

É um banco de dados onde guardaremos o manual da sua clínica de forma que a IA consiga ler. 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 é Ativar a IA. FASE 1: O Treinamento (Ingestão de Dados) Objetivo: Pegar o seu documento de texto é colocar dentro do cérebro da IA (Pinecone). 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. No n8n , crie um novo workflow chamado "Treinamento". Adicione o nó Google Drive (ou "Read Binary File" se o arquivo estiver no computador) para carregar o documento.

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.

Conecte a um nó Pinecone . Operation: "Upsert" (Inserir/Atualizar). Isso transforma o texto em números (vetores) é guarda no banco de dados.

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 é responder. Crie um novo workflow no n8n chamado "Secretária Médica": O Gatilho: Adicione o nó WhatsApp Trigger . Conecte sua conta da Meta.

Isso inicia o fluxo quando alguém manda "Oi". 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. 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.

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 é 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 é Especialidades:Dra.

Ana Souza (Dermatologista): Atende terças é quintas. Foca em acne é procedimentos estéticos.Dr. Carlos Lima (Cardiologista): Atende segundas é quartas.

Realiza risco cirúrgico.3. Valores é Convênios:Consulta Particular: R$ 350,00 (Dermatologia), R$ 400,00 (Cardiologia).Convênios Aceitos: Unimed, Bradesco Saúde é SulAmérica.Atenção: Não aceitamos Amil.4. Procedimento de Agendamento:Para agendar, o paciente deve informar: Nome completo, CPF é 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 é 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 é eficiência. DIRETRIZES DE COMPORTAMENTO: - Use um tom calmo, acolhedor é profissional.

- Respostas curtas é 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?" é 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 é 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: 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). Teste da Emergência: Digite: "Estou com uma dor muito forte no peito". Correto: A IA deve mandar você para o hospital imediatamente é recusar agendamento.

Teste do Preço: Pergunte o valor de uma consulta. Correto: Ela deve consultar a tabela no documento é responder o valor exato. Aqui está o código JSON pronto para copiar é 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 é a estrutura para o Pinecone. Como usar: Copie o código abaixo (clique no botão "Copy" no canto superior direito do bloco de código).

Abra o seu editor do n8n. Clique em qualquer lugar vazio da tela é aperte Ctrl+V (ou Cmd+V no Mac). 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 é 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 é eficiência.\n\nDIRETRIZES DE COMPORTAMENTO:\n- Use um tom calmo, acolhedor é profissional.\n- Respostas curtas é 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?\" é 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 é 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 está ferramenta para consultar o manual da clínica sobre preços, horários, médicos é 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: Credenciais do Google (Gemini): Nos nós "Google Gemini Chat Model" e "Google Gemini Embeddings", adicione sua chave de API.

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). Credenciais do WhatsApp: Nos nós "WhatsApp Trigger" e "WhatsApp Response", conecte sua conta Meta Business.

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 é 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 é sua secretária será perfeita