Como integrar WhatsApp com CRM via webhooks: guia prático

Para integrar o WhatsApp com um CRM sem migrar para a API oficial, o caminho prático é o webhook: a cada evento no WhatsApp Web — lead novo no funil, cartão movido de etapa, negócio ganho — a extensão dispara um POST HTTP para uma URL que o seu CRM recebe e transforma em contato, negócio ou linha de planilha. Na Zapext, os webhooks fazem parte do plano Plus (R$79/mês, sem custo por mensagem) e funcionam com RD Station, HubSpot, Pipedrive, Bitrix24 e Google Sheets. Abaixo, o passo a passo conceitual e dois casos completos.

Entenda a direção da seta antes de tudo

Um webhook é um aviso automático entre sistemas: quando algo acontece na ferramenta A, ela envia uma requisição HTTP com os dados do evento para uma URL da ferramenta B. Sem sincronização agendada, sem exportar CSV, sem digitação dupla.

Nos webhooks da Zapext, a seta aponta numa direção só: de dentro do WhatsApp Web para fora. A extensão notifica o CRM sobre o que aconteceu no atendimento; ela não recebe comandos de volta — quem responde mensagem continua sendo você, seu time ou o chatbot por regras configurado na própria extensão. Os eventos são processados localmente, no seu computador, e saem apenas para as URLs que você cadastrar, via HTTPS. Precisa de mão dupla (o CRM disparando mensagens no WhatsApp)? Pule para a seção de honestidade no fim.

Os eventos que a Zapext envia:

• Novo contato adicionado ao funil;
• Tag aplicada ou removida em um contato;
• Conversa movida entre colunas do Kanban;
• Atendimento iniciado, encerrado ou transferido;
• Mensagem rápida disparada;
• Lembrete ou agendamento concluído.

No plano Plus, os webhooks cobrem os principais eventos do funil e do atendimento. A lista completa está na página de integrações da Zapext.

O passo a passo conceitual (vale para qualquer destino)

Os detalhes de tela mudam, mas a lógica é sempre a mesma, em cinco passos:

1. Escolha o evento que importa. Comece com um só. "Novo contato no funil" e "cartão movido para Ganho" são os dois de maior retorno imediato.
2. Gere a URL de recebimento no destino. Cada CRM tem a sua porta de entrada (detalhes por ferramenta abaixo). O resultado é sempre uma URL que aceita POST.
3. Cadastre o par evento → URL na Zapext. Dentro da extensão, você cola a URL e escolhe qual evento dispara para ela. Sem código.
4. Teste com um evento de verdade. Mova um cartão de teste no Kanban e confira se o registro apareceu no destino com os campos certos (nome, telefone, etapa).
5. Ative e defina um dono. Alguém do time confere na primeira semana se os dados estão chegando limpos e completos.

Como cada plataforma recebe o evento

É a parte que varia — e que os tutoriais genéricos ignoram. O resumo, verificado nas documentações oficiais (jul/2026):

Destino	Porta de entrada	Precisa de intermediário?
Bitrix24	Webhook de entrada nativo (REST)	Não
HubSpot	Gatilho de workflow "webhook recebido"	Depende do plano
RD Station	API de conversões ou Zapier	Em geral, sim
Pipedrive	Zapier ou Make	Sim
Google Sheets	Apps Script (doPost) ou intermediário	Opcional

Bitrix24: o caminho mais direto

O Bitrix24 tem webhooks de entrada nativos: na área de recursos para desenvolvedores, você gera uma URL que chama métodos da API REST, como o de criação de lead, segundo a documentação oficial do Bitrix24 (jul/2026). Na prática: gera a URL lá, cola na Zapext, e o lead novo do WhatsApp nasce como lead no Bitrix24 — sem ferramenta no meio. Um cuidado: a URL contém a chave de autorização; trate-a como senha.

HubSpot: gatilho de workflow

A base de conhecimento do HubSpot (jul/2026) documenta o gatilho "quando um webhook é recebido", que inscreve o registro num workflow de automação. Dois detalhes: o payload precisa ser JSON, e o fluxo depende de uma propriedade que identifique o contato — o telefone, no nosso caso. A disponibilidade dos recursos de automação varia conforme o plano contratado — confirme antes de montar o fluxo.

RD Station: conversão ou intermediário

No RD Station Marketing, a documentação de desenvolvedores (jul/2026) descreve o evento de conversão via API, que cria ou atualiza contatos na base de leads — e a RD mantém integração oficial com o Zapier. O caminho de menor atrito para quem não quer tocar em API é o intermediário: Zapier ou Make recebem o webhook da Zapext e criam a conversão no RD, que por sua vez dispara a régua de automação.

Pipedrive: intermediário

Os webhooks nativos do Pipedrive são de saída (dele para outros sistemas); para dados entrando, o caminho documentado pelo próprio suporte do Pipedrive (jul/2026) passa por um intermediário como o Zapier, que recebe o evento e cria ou atualiza pessoa e negócio no funil.

Google Sheets: a planilha que se preenche sozinha

Duas rotas: um script no Google Apps Script publicado como web app — a função doPost recebe o POST e adiciona a linha na planilha, padrão documentado pelo Google (jul/2026) — ou um intermediário com o passo "adicionar linha". A primeira é gratuita; a segunda, mais confortável para quem não quer ver código.

Caso 1: lead novo no WhatsApp vira contato no CRM

O cenário mais comum: o lead chama no WhatsApp, o atendente qualifica na conversa e adiciona o contato ao funil da extensão. Nesse instante o webhook dispara: o contato nasce no RD Station, HubSpot ou Bitrix24 com nome, telefone e etiqueta de origem — sem que ninguém abra o CRM para digitar.

Por que isso importa mais do que parece: lead respondido na primeira hora tem 7 vezes mais chance de qualificação^[1], e 80% das vendas exigem pelo menos cinco follow-ups^[2]. O lead que entra no CRM em tempo real entra também na régua de automação — e-mails, tarefas, lembretes — enquanto ainda está quente. O lead anotado "depois" num caderno é o lead que a régua nunca alcança.

Caso 2: negócio ganho vira linha na planilha

Segunda montagem, ainda mais simples: quando o cartão é movido para a coluna "Ganho" do CRM Kanban, o evento de mudança de coluna dispara para o Apps Script, que registra data, contato e etapa na planilha. Resultado: um histórico de fechamentos que se alimenta sozinho, pronto para tabela dinâmica, meta do mês e comissão do vendedor — sem ninguém precisar "lembrar de atualizar a planilha" no fim do dia.

A mesma lógica serve para o outro lado do funil: cartão movido para "Perdido" pode alimentar uma aba de motivos de perda — matéria-prima honesta para a reunião comercial de segunda-feira.

Quando a Zapext não é a escolha certa

Três cenários em que a resposta honesta é "não instale":

• Sua equipe vive dentro do RD Station CRM. A própria RD oferece o WhatStation, extensão gratuita de Chrome que leva o CRM deles para dentro do WhatsApp Web, disponível a partir do plano Free, segundo a central de ajuda da RD Station (jul/2026). Se o funil mora no RD CRM e o WhatsApp é só o canal de conversa, a extensão nativa deles resolve sem custo extra. A Zapext soma no cenário inverso: o funil acontece no WhatsApp — Kanban, etiquetas, distribuição de atendimento — e o CRM corporativo é o registro que precisa ser alimentado.
• Você precisa de mão dupla. Se o requisito é o CRM disparar mensagens automaticamente no WhatsApp (notificação transacional, cobrança a partir do ERP), o caminho é a API oficial do WhatsApp Business, com templates aprovados e custo por mensagem. Webhook de saída não faz isso — e desconfie de quem prometer o contrário.
• O WhatsApp é canal secundário. Se 90% dos seus leads chegam por formulário e e-mail, comece pela automação nativa do seu CRM e volte a este guia quando o WhatsApp virar o gargalo.

Por onde começar

Escolha um único fluxo — lead novo → CRM é o de maior impacto —, monte, teste com três contatos reais e só então adicione o segundo. Antes de integrar, organize a casa: um funil bem estruturado dentro do WhatsApp é o que dá sentido aos eventos que saem dele, e o guia de CRM no WhatsApp mostra como montar esse funil do zero. Os webhooks fazem parte do plano Plus da Zapext (R$79/mês, sem custo por mensagem, 7 dias de garantia) — dá para montar o primeiro fluxo em uma tarde.

Fontes

1. [1] The Short Life of Online Sales Leads — Harvard Business Review (2011-03). acessado em 2026-05-19.
2. [2] 80% of sales require five follow-ups — Marketing Donut / NSA (2023). acessado em 2026-05-19.