# Integração WhatsApp e CRM com n8n: guia para imobiliárias e clínicas

Autor: Sauro Rodrigues Jr, Desenvolvedor Full Stack e Engenheiro de Automação (Agência MR Marketing)
Publicado: 2026-10-29 · Atualizado: 2026-10-29
URL: https://www.agenciamrmarketing.com.br/blog/integracao-whatsapp-crm-n8n

> Integrar o WhatsApp ao CRM com n8n significa fazer cada mensagem recebida pela API oficial do WhatsApp Business chegar a um fluxo do n8n, que encontra ou cria o contato no CRM, registra a conversa, avisa o responsável e envia respostas ou lembretes. Assim nenhum lead ou paciente fica preso no celular de uma pessoa e todo o histórico fica na ficha do cliente.

Na imobiliária, o cliente manda mensagem perguntando do apartamento de três quartos que viu no anúncio. Quem responde é o corretor de plantão, no celular dele. Duas semanas depois o corretor sai da empresa e leva junto a conversa, o histórico e o contato. No CRM, aquele lead aparece como "sem retorno".

Na clínica, a recepção confirma as consultas do dia seguinte uma a uma, pelo WhatsApp do balcão. Às 17h ainda faltam vinte pacientes. Quem desmarca avisa por mensagem, mas a agenda do sistema só é atualizada quando alguém lembra de abrir a conversa.

Os dois casos têm a mesma causa: o WhatsApp virou o principal canal com o cliente, mas está desligado do sistema onde a empresa guarda os dados. Este guia mostra como ligar as duas pontas com o n8n, o que custa, quais cuidados a Meta e a LGPD exigem e quais fluxos fazem mais diferença em imobiliárias e clínicas.

## O que muda quando o WhatsApp conversa com o CRM

Integrar não é só "mandar mensagem automática". É fazer com que cada conversa vire informação dentro do CRM, e que o CRM consiga disparar mensagens quando algo acontece lá dentro.

Na prática, a integração resolve quatro problemas:

- **Contato sem dono.** Toda mensagem nova encontra ou cria a ficha do cliente e tem um responsável definido.
- **Histórico espalhado.** A conversa fica registrada na ficha, e não no celular de quem atendeu.
- **Tarefa que depende de memória.** Confirmação de consulta, lembrete de visita e retorno de proposta saem na hora certa, sem alguém precisar lembrar.
- **Gestão às cegas.** O gestor passa a ver quantos contatos chegaram, quanto tempo levaram para ser atendidos e por quem.

O n8n é a peça do meio. Ele é uma ferramenta de automação em que você monta fluxos ligando blocos (os "nós"): um nó recebe a mensagem do WhatsApp, outro consulta o CRM, outro decide quem atende, outro responde. Ele pode rodar no seu próprio servidor ou na nuvem do n8n.

Se você está comparando ferramentas de automação de forma mais ampla, explicamos as diferenças entre n8n e Make no guia de [automação de atendimento com n8n e Make](/blog/automacao-b2b-n8n-make). Aqui o foco é a ligação WhatsApp e CRM, passo a passo.

## API oficial ou gateway não oficial: a primeira decisão

Para um sistema enviar e receber mensagens pelo WhatsApp, existem dois caminhos. A escolha afeta custo, estabilidade e risco para o seu número.

| Critério | API oficial (WhatsApp Business Platform) | Gateway não oficial |
|---|---|---|
| Como funciona | Conexão direta com a Meta, pela Cloud API | Simula o WhatsApp Web em um número comum |
| Permitido pelos termos do WhatsApp | Sim | Não; os termos proíbem mensagens automáticas por meios não autorizados |
| Risco de bloqueio do número | Baixo, se a política for seguida | Alto, principalmente com envio em volume |
| Custo | Cobrança por mensagem, conforme a categoria | Mensalidade do serviço, sem cobrança da Meta |
| Mensagens fora da janela de 24 horas | Só com modelos aprovados | Livres, o que aumenta o risco de denúncia |
| Nó nativo no n8n | Sim (WhatsApp Business Cloud e WhatsApp Trigger) | Depende do serviço, em geral via HTTP Request |

Os Termos de Serviço do WhatsApp proíbem o envio de mensagens em massa e mensagens automáticas fora dos meios autorizados, e preveem suspensão da conta em caso de violação. Para uma imobiliária ou clínica, perder o número que está no site, no Google e nos anúncios é um prejuízo difícil de recuperar.

Por isso, em projetos de clientes, usamos a **API oficial**. O gateway pode servir para um teste interno, nunca para o número principal da empresa.

## Quanto custa a API oficial em 2026 e quais regras ela impõe

Desde 1º de julho de 2025 a Meta cobra **por mensagem entregue**, e não mais por conversa. O valor depende da categoria da mensagem e do código do país do destinatário. Mensagens enviadas pelo cliente para a empresa não são cobradas.

| Categoria | Quando é usada | Exemplo |
|---|---|---|
| Serviço | Resposta dentro da janela de 24 horas, sem modelo | Responder a dúvida que o cliente mandou |
| Utilidade (modelo) | Aviso ligado a algo que o cliente já pediu ou contratou | Confirmação de consulta, lembrete de visita |
| Marketing (modelo) | Oferta, novidade, reativação | Lançamento de empreendimento, campanha de check-up |
| Autenticação (modelo) | Código de verificação | Código para acessar o portal do paciente |

Algumas regras que mudam o orçamento:

- **Janela de atendimento de 24 horas.** Ela abre quando o cliente manda mensagem ou liga, e reinicia a cada nova mensagem dele. Com a janela aberta, a empresa pode responder livremente. Fechada, só pode enviar modelos aprovados.
- **Cota gratuita de serviço.** Cada número tem 1.000 mensagens de serviço gratuitas por mês, que não acumulam.
- **Mudança de 1º de outubro de 2026.** A partir dessa data, mensagens de serviço acima da cota gratuita e mensagens de utilidade enviadas com a janela aberta passaram a ser cobradas. Até então, as duas eram gratuitas. Se você fez as contas no começo do ano, refaça.
- **Anúncios de clique para WhatsApp.** Quando o cliente chega por um anúncio desse tipo e a empresa responde dentro da janela, abre-se um período gratuito de até 7 dias para as categorias principais.
- **Faturamento em reais.** A cobrança em BRL para o Brasil começou em julho de 2026, e a migração das contas brasileiras para reais deve ocorrer até 30 de junho de 2027.

Os valores por mensagem mudam a cada trimestre. Antes de montar o orçamento, consulte a tabela atual na página de preços da Meta, listada nas fontes deste artigo.

### Regras de uso que valem para qualquer segmento

Algumas exigências da Meta se aplicam tanto à imobiliária quanto à clínica, e ignorá-las coloca em risco a qualidade do número:

- **Consentimento antes do contato.** A empresa só pode iniciar conversa com quem forneceu o número e aceitou receber mensagens dela. A Meta recomenda pedir consentimento por categoria (avisos de agendamento são diferentes de ofertas). Registre no CRM quando e onde o consentimento foi dado.
- **Respeito ao pedido de saída.** Quem pede para não receber mais mensagens deve sair da lista, inclusive se pedir por outro canal. Crie um campo no CRM e faça todos os fluxos consultarem esse campo antes de enviar.
- **Caminho para uma pessoa.** Automação é permitida dentro da janela de 24 horas, desde que haja uma forma clara e direta de falar com um atendente.
- **Modelos bem categorizados.** Um aviso de consulta com uma oferta no final deixa de ser utilidade. Modelos mal categorizados podem ser reclassificados ou rejeitados, e o custo muda.

## Como a integração funciona por dentro

Vale entender as peças antes de abrir o n8n, porque a maior parte dos problemas que encontramos em integrações prontas vem de uma delas mal configurada.

1. **Conta na Meta.** Um portfólio empresarial (Business Manager), uma conta do WhatsApp Business (WABA) e um número de telefone registrado nela.
2. **Aplicativo da Meta.** Criado no painel Meta for Developers, com o produto WhatsApp adicionado. É ele que conversa com o n8n.
3. **Webhook.** O endereço do n8n que a Meta chama a cada mensagem recebida. A Meta só aceita **um webhook por aplicativo**: se você trocar a URL de teste pela de produção, a anterior deixa de receber.
4. **n8n.** Recebe o webhook, processa e chama o CRM e a API do WhatsApp.
5. **CRM.** Precisa de API ou de nó pronto no n8n para ler e gravar contatos, negócios e atividades.

Dois detalhes técnicos que costumam travar a primeira integração:

- **Token de acesso.** O token gerado na tela de configuração da API é um token de usuário, que expira em poucas horas. Para um fluxo que roda todos os dias, a Meta orienta usar um token de **usuário do sistema** (System User). Se o fluxo "para do nada" no dia seguinte, quase sempre é isso.
- **Inscrição do aplicativo na conta.** Publicar o fluxo registra o webhook, mas não inscreve o aplicativo na conta do WhatsApp Business. Sem essa inscrição as mensagens não chegam ao n8n e nenhum erro aparece. A documentação do n8n explica como conferir isso pela API de aplicativos inscritos.

### n8n no seu servidor ou na nuvem

| Critério | n8n em servidor próprio | n8n Cloud |
|---|---|---|
| Onde ficam os dados processados | No seu servidor | Na infraestrutura do n8n |
| Custo | Servidor e manutenção | Plano mensal |
| Manutenção e atualizações | Por sua conta ou da agência | Feitas pelo n8n |
| Indicado para | Volume constante, dados sensíveis, como os de saúde | Começar rápido, volume menor |

Para clínicas, que lidam com dados de saúde, costumamos recomendar o servidor próprio: fica mais simples saber exatamente onde os dados estão e quem tem acesso a eles.

## Passo a passo: montando o fluxo no n8n

O exemplo abaixo é o fluxo base que serve para os dois segmentos: receber a mensagem, achar o cliente no CRM, registrar e avisar o responsável.

### 1. Prepare a conta e as credenciais

No painel da Meta, crie o aplicativo, adicione o produto WhatsApp e registre o número. No n8n, crie duas credenciais:

- **WhatsApp Business Cloud (API):** token de acesso e ID da conta do WhatsApp Business. Usada para enviar mensagens.
- **WhatsApp OAuth (Trigger):** ID e chave secreta do aplicativo (App ID e App Secret). Usada para receber mensagens.

### 2. Receba as mensagens com o WhatsApp Trigger

Adicione o nó **WhatsApp Trigger** e marque o evento **Messages**. Ao publicar o fluxo, o n8n registra o webhook na Meta. Para cada mensagem, a Meta envia um conteúdo parecido com este (dados fictícios):

```json
{
  "contacts": [{ "profile": { "name": "Maria Exemplo" }, "wa_id": "5511900000000" }],
  "messages": [{
    "from": "5511900000000",
    "type": "text",
    "text": { "body": "Oi, quero saber do apartamento da Rua Exemplo" }
  }]
}
```

Os campos que importam são o telefone (`from`), o nome do perfil e o texto. No n8n você usa esses valores nos próximos nós por expressões. Confira na aba de saída do nó o caminho exato, porque ele varia conforme a versão do nó.

### 3. Padronize o telefone

Este é o erro mais comum que encontramos: o WhatsApp entrega o número como `5511900000000`, e o CRM guarda como `(11) 90000-0000`. A busca não encontra e o fluxo cria um contato duplicado a cada mensagem.

Use um nó **Code** ou **Edit Fields** para deixar o telefone sempre no mesmo formato (só dígitos, com código do país) antes de consultar o CRM. Em alguns números brasileiros, o identificador do WhatsApp chega sem o nono dígito; trate os dois formatos na busca.

### 4. Encontre ou crie o contato no CRM

Com o telefone padronizado, consulte o CRM:

- Se o CRM tem nó próprio no n8n (HubSpot e Pipedrive, por exemplo), use a operação de busca de contato.
- Se não tem, use o nó **HTTP Request** com a API do CRM.

Depois, um nó **If** separa os dois caminhos: contato existente segue para o registro da conversa; contato novo é criado com nome, telefone e origem ("WhatsApp").

### 5. Registre a conversa e defina o responsável

Grave a mensagem como atividade ou nota na ficha do contato. Se o contato é novo, aplique a regra de distribuição: rodízio, região, tipo de imóvel, especialidade ou unidade da clínica. Um nó **Switch** resolve a maioria dos casos.

### 6. Avise quem vai atender

Envie ao responsável uma notificação com nome, telefone, mensagem e link da ficha no CRM. Pode ser pelo próprio WhatsApp (para um número interno), e-mail ou o app do CRM.

### 7. Responda o cliente e controle o prazo

Com a janela de 24 horas aberta, o nó **WhatsApp Business Cloud** envia uma resposta de serviço, por exemplo: "Oi, Maria. Recebemos sua mensagem e o corretor João vai te atender em instantes."

Por fim, crie um controle de prazo: um nó **Wait** aguarda o tempo combinado e verifica no CRM se alguém assumiu o atendimento. Se não, avisa o gestor. É esse passo que impede o lead de receber a primeira resposta e depois ficar esperando do mesmo jeito.

### 8. Mensagens que partem do CRM

O caminho inverso é um segundo fluxo: o CRM dispara um webhook quando algo muda (visita agendada, consulta marcada, proposta enviada) e o n8n envia um **modelo aprovado** pelo nó WhatsApp Business Cloud, operação "Send Template". Os modelos são criados no Gerenciador do WhatsApp, passam por revisão automática que pode levar até 24 horas e aceitam variáveis como `{{nome}}` e `{{data}}`.

## Fluxos que mais ajudam uma imobiliária

Em imobiliária, o lead chega por portal, anúncio, site e indicação, e quase sempre vai parar no WhatsApp. O objetivo da integração é que nenhum desses contatos fique sem dono e que o corretor chegue rápido, com o histórico na mão.

| Fluxo | Gatilho | O que acontece |
|---|---|---|
| Primeiro atendimento | Mensagem nova ou lead de portal | Cria o lead com origem e imóvel de interesse, distribui ao corretor e responde em segundos |
| Qualificação inicial | Primeira conversa | Pergunta objetivos simples (compra ou aluguel, região, faixa de valor) e grava nos campos do CRM |
| Agendamento de visita | Corretor marca a visita no CRM | Envia confirmação com endereço e horário, e lembrete no dia anterior |
| Retomada | Lead parado há X dias na mesma etapa | Avisa o corretor ou envia um modelo de retomada, que para quando o cliente responde |
| Pós-visita | Visita marcada como realizada | Pergunta a impressão do cliente e cria tarefa para o corretor |

Três cuidados específicos do segmento:

- **O número é da imobiliária, não do corretor.** Com a API oficial, o atendimento sai do celular pessoal e fica no sistema. Quando um corretor sai, a carteira continua na empresa.
- **Qualificação curta.** Duas ou três perguntas bastam. Um menu longo afasta justamente o cliente de alto padrão, que espera falar com uma pessoa.
- **Lançamentos são marketing.** Mensagem sobre um empreendimento novo para quem não pediu informação dele é modelo de marketing, com custo maior e exigência de consentimento para esse tipo de mensagem.

Foi esse tipo de operação que estruturamos para a [Easy Vendas, case de gestão de leads e WhatsApp no mercado imobiliário](/projetos/easy-vendas): resposta em segundos pelo WhatsApp, corretor avisado na hora e visitas registradas no mesmo sistema. O sistema não vende imóveis, quem vende são os corretores. O que ele faz é garantir que nenhum contato fique sem retorno.

## Fluxos que mais ajudam uma clínica

Na clínica, o WhatsApp concentra agendamento, confirmação, dúvida de preparo de exame e reagendamento. A integração aqui é menos sobre distribuir leads e mais sobre manter a agenda certa com menos trabalho da recepção.

| Fluxo | Gatilho | O que acontece |
|---|---|---|
| Confirmação de consulta | Consulta marcada para o dia seguinte | Envia modelo com data, horário e botões "Confirmar" e "Remarcar" |
| Atualização da agenda | Paciente toca em um botão | O n8n atualiza o status no sistema da clínica ou no CRM |
| Reagendamento | Paciente pede para remarcar | Avisa a recepção ou oferece horários livres, se o sistema de agenda tiver API |
| Preparo de exame | Exame agendado | Envia as orientações padrão de preparo definidas pela clínica |
| Retorno | Prazo de retorno do procedimento | Lembra o paciente de agendar o retorno |

### LGPD e política do WhatsApp na área da saúde

Dados de saúde são **dados pessoais sensíveis** pela LGPD (art. 5º, II), e o tratamento deles só é permitido nas hipóteses do art. 11, entre elas o consentimento específico e a tutela da saúde por profissionais e serviços de saúde. A lei também exige medidas de segurança desde a concepção do sistema (art. 46).

Na prática, isso leva a algumas regras de projeto:

- **Mensagem mínima.** O lembrete diz data, horário e unidade. Não precisa dizer o nome do exame, a especialidade ou o motivo da consulta. Lembre que o celular pode ser visto por outra pessoa.
- **Dados só onde precisam estar.** O fluxo não deve gravar laudos, resultados ou descrições clínicas em planilhas, logs do n8n ou ferramentas de terceiros. Configure a retenção de execuções do n8n para não guardar mais do que o necessário.
- **Robô não orienta tratamento.** Automação pode confirmar horário e enviar preparo padrão. Dúvida sobre sintoma, medicação ou resultado vai para uma pessoa da equipe.
- **Direitos do paciente.** O paciente pode pedir acesso, correção e exclusão dos dados (art. 18). Saiba em quais sistemas o fluxo grava informação para conseguir atender o pedido.

A Política de Mensagens do WhatsApp Business também proíbe usar o WhatsApp para telemedicina ou para trocar informações de saúde quando a lei aplicável não permitir o envio desses dados a sistemas que não cumprem os requisitos para dados de saúde. Antes de colocar o fluxo no ar, valide com o responsável jurídico ou o encarregado de dados (DPO) da clínica o que pode trafegar pelo canal.

## Erros comuns e por onde começar

Os problemas que mais vemos em integrações que chegam para revisão:

- **Contatos duplicados** por telefone fora de padrão. Resolva no passo 3, antes de qualquer outra coisa.
- **Token que expira** porque o fluxo usa o token temporário da tela de configuração.
- **Mensagens que não chegam** porque o aplicativo não foi inscrito na conta do WhatsApp Business, ou porque alguém trocou a URL do webhook para testar e esqueceu de voltar.
- **Automatizar sem regra definida.** Se a equipe não sabe quem atende qual contato, o fluxo só distribui a confusão mais rápido. Defina a regra no papel primeiro.
- **Não medir.** Acompanhe o tempo até o primeiro atendimento humano, a porcentagem de contatos com responsável e, na clínica, a taxa de confirmação e de faltas. São esses números que mostram se a integração está fazendo o trabalho dela.

O melhor ponto de partida é o fluxo base deste guia: receber a mensagem, achar ou criar o contato, registrar e avisar o responsável. Ele já tira o atendimento do celular pessoal e gera os dados para decidir o próximo fluxo, seja o agendamento de visitas ou a confirmação de consultas.

Se quiser saber onde os contatos estão se perdendo na sua operação, o [diagnóstico gratuito](/diagnostico) mapeia o caminho do lead ou do paciente e aponta as prioridades. E se já sabe que precisa dessa integração, veja como funciona o nosso serviço de [automação de atendimento e integração com CRM](/servicos/automacao).

## Perguntas frequentes

### Posso usar o mesmo número de WhatsApp que a empresa já usa no aplicativo?

Sim, mas o número precisa ser migrado para a plataforma da Meta. Depois da migração ele passa a funcionar pela API e o atendimento é feito por um sistema conectado a ela, não mais pelo aplicativo comum no celular. Vale planejar a troca para um dia de movimento menor.

### Preciso trocar de CRM para fazer essa integração?

Normalmente não. Se o CRM tem API ou aceita webhooks, o n8n consegue ler e gravar dados nele, com nó próprio ou com o nó HTTP Request. Só vale trocar quando o CRM atual não permite nenhum tipo de integração.

### O n8n cobra por mensagem enviada?

Não. Instalado em servidor próprio, o custo do n8n é o do servidor e da manutenção. Na versão em nuvem, a cobrança é por plano. As mensagens do WhatsApp são cobradas à parte pela Meta, conforme a categoria e o país do destinatário.

### Dá para colocar um robô com inteligência artificial para responder?

Dá, e o n8n tem nós para isso. Recomendamos limitar o robô a tarefas objetivas, como tirar dúvidas frequentes e coletar dados, e sempre oferecer a passagem para uma pessoa, o que a própria política do WhatsApp exige. Em clínica, o robô não deve orientar sobre sintomas ou tratamento.

### Quanto tempo leva para colocar a integração no ar?

Um fluxo básico de registro de contatos e aviso ao responsável costuma levar poucas semanas, contando a verificação da conta na Meta, a aprovação dos modelos de mensagem e os testes. CRMs sem API ou regras de distribuição muito específicas levam mais.

## Fontes

- [Meta for Developers: preços da plataforma WhatsApp Business](https://developers.facebook.com/docs/whatsapp/pricing)
- [Meta for Developers: fundamentos dos modelos de mensagem (templates)](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview)
- [Meta for Developers: tokens de acesso da API do WhatsApp](https://developers.facebook.com/docs/whatsapp/access-tokens)
- [WhatsApp: Política de Mensagens do WhatsApp Business](https://whatsappbusiness.com/pt-br/policy/)
- [WhatsApp: Termos de Serviço](https://www.whatsapp.com/legal/terms-of-service)
- [Documentação do n8n: nó WhatsApp Business Cloud](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.whatsapp/)
- [Documentação do n8n: nó WhatsApp Trigger](https://docs.n8n.io/integrations/builtin/trigger-nodes/n8n-nodes-base.whatsapptrigger/)
- [Documentação do n8n: credenciais do WhatsApp Business Cloud](https://docs.n8n.io/integrations/builtin/credentials/whatsapp/)
- [Lei nº 13.709/2018 (Lei Geral de Proteção de Dados Pessoais)](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm)