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

Gustavo Caetano
30 de dez. de 2025
8 min de leitura

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".

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 e 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 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).

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) e 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 e 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 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:

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 e recusar agendamento.
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:

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 e 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 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:

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 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