No CRM, o que converte é o tempo de resposta. Um lead que acabou de levantar a mão esfria em minutos; uma proposta que fica dias sem retorno vira uma venda perdida. Integrar o WhatsApp por API resolve isso na origem: você reage a cada movimento do lead — novo cadastro, mudança de etapa, proposta enviada e ainda sem resposta — com uma mensagem imediata e personalizada, disparada pelo próprio funil. Como o zapon expõe uma API REST simples, qualquer CRM que saiba disparar um webhook ou fazer uma chamada HTTP consegue acionar o WhatsApp, direto ou via n8n/Make.
Ao longo deste guia você vai ver os termos API WhatsApp CRM, integração WhatsApp CRM e WhatsApp funil de vendas aparecerem com frequência, porque são exatamente as três peças que compõem essa automação: conectar o número, disparar a mensagem por etapa e gravar a resposta de volta no contato. Vamos do zero até um funil de duas vias rodando em produção, com os endpoints, headers e payloads reais da plataforma.
O que você vai construir
O que dá para fazer integrando o zapon ao CRM?
Você monta um funil de WhatsApp de duas vias: o CRM dispara mensagens pela API do zapon a cada transição de etapa — boas-vindas, follow-up, lembrete de proposta — e o webhook devolve cada resposta do lead para o contato. Tudo personalizado com os dados do lead, sem ninguém digitar manualmente.
Ao final deste guia você terá uma régua de relacionamento automática ligada ao seu funil, formada por três blocos que se complementam:
- Um disparo de boas-vindas, que envia a primeira mensagem de WhatsApp assim que um novo lead entra no funil — antes que ele esqueça que pediu contato.
- Um disparo de follow-up por etapa, acionado quando o lead muda de status (de "novo" para "qualificado", de "qualificado" para "proposta enviada"), com a mensagem adequada a cada momento.
- Um retorno via webhook, que registra cada resposta do lead de volta no contato e pode acionar o vendedor responsável, fechando o ciclo entre o canal e o histórico do CRM.
Tudo isso roda sobre um número de WhatsApp comum — não há fila de aprovação da Meta, não há templates obrigatórios, não há custo por mensagem. O número se conecta por QR Code, exatamente como o WhatsApp Web, e passa a ser pilotado pela API a partir dos eventos do seu CRM.
Pré-requisitos
O que eu preciso ter antes de começar?
Três coisas: uma conta no zapon (14 dias grátis, sem cartão) com pelo menos uma conexão de WhatsApp ativa, um CRM capaz de disparar webhooks ou chamadas HTTP nas transições de etapa (RD Station, HubSpot, Pipedrive e similares), e um número de WhatsApp dedicado. Nenhuma conta de API oficial da Meta é necessária.
Antes de mexer no funil, garanta que você tem:
- Conta no zapon. Crie a sua em zapon.dev — são 14 dias grátis, sem cartão de crédito. É nela que você cria as conexões e copia o token de cada número.
- Um CRM que dispare gatilhos. RD Station, HubSpot, Pipedrive ou qualquer outro que permita disparar um webhook ou uma chamada HTTP quando um lead muda de etapa. Se o seu CRM não chama HTTP diretamente, um orquestrador como n8n ou Make faz a ponte: o CRM avisa o orquestrador, que chama a API do zapon.
- Um número de WhatsApp. De preferência um chip dedicado ao comercial, e não o celular pessoal do vendedor. Esse número será conectado ao zapon e pilotado pela API.
Você não precisa de conta na Meta, não precisa do WhatsApp Business API oficial e não precisa cadastrar templates. O zapon conversa diretamente com o WhatsApp do número que você conectar.
Passo 1 — Conecte um número no zapon
Como conectar um número de WhatsApp no zapon?
No painel do zapon, crie uma conexão e leia o QR Code com o WhatsApp do número (ou use o código de pareamento). Assim que a conexão ficar online, copie o token dela — é esse token que autentica todas as chamadas que o seu CRM (ou o orquestrador) fará à API.
Antes de tocar no funil, o número precisa estar conectado e a conexão precisa ter um token. Esse token é a chave que o CRM vai usar para falar com a API.
Crie a conexão e pegue o token
Dentro do painel do zapon, crie uma nova conexão. Cada conexão representa um número de WhatsApp e tem o seu próprio token — uma string única que autentica as requisições daquele número. Copie esse token e guarde-o: nas chamadas, ele entra como um header chamado token (não é Authorization, não é Bearer). Trate-o como uma senha, porque quem tem o token consegue enviar mensagens em nome do seu número.
Dica para equipes comerciais: se cada vendedor atende pelo seu próprio número, crie uma conexão para cada um. Cada token corresponde a um número específico, então o CRM escolhe de qual número a mensagem sai simplesmente trocando o header — útil para que o follow-up saia do número do vendedor dono do negócio.
Conecte por QR Code ou código
Com a conexão criada, falta colocá-la online. Há dois caminhos:
- QR Code: o painel exibe um QR Code. No celular do número, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho → e aponte a câmera para o QR Code. É o mesmo fluxo do WhatsApp Web.
- Código de pareamento: em vez do QR, o zapon gera um código de oito dígitos. Você digita esse código no WhatsApp do número (em Conectar um aparelho → Conectar com número de telefone). Útil quando não dá para escanear a tela.
Assim que o WhatsApp confirma, a conexão muda para o status online no painel. A partir daí o número está pronto para enviar e receber pela API — e o seu funil pode entrar em cena.
Passo 2 — Disparar por etapa do funil
Como disparar uma mensagem de WhatsApp a partir do CRM?
Configure o seu CRM (ou o orquestrador) para fazer um POST em https://api.zapon.dev/chat/send/text quando o lead muda de etapa, com o header token da sua conexão e um body JSON contendo Phone (o telefone do lead) e Body (o texto, montado com o nome e os dados do lead). A API entrega a mensagem e devolve o ID dela.
Este é o coração da integração. Não existe um conector "zapon" exclusivo — e você não precisa de um. Qualquer ação de "chamar URL" / "HTTP request" do seu CRM, ou um cenário no n8n/Make, faz a chamada à API de envio de texto e pronto.
Configurar a chamada HTTP
Na automação do seu CRM, crie uma ação que dispare na transição de etapa desejada e configure-a assim:
- Método:
POST.
- URL:
https://api.zapon.dev/chat/send/text.
- Content-Type:
application/json.
- Body: um objeto com
Phone (o telefone do lead no formato internacional, só dígitos, ex.: 5511988887777) e Body (o texto da mensagem).
O poder da integração aparece na personalização: em vez de fixar o número e o texto, você os puxa dos campos do lead. Em RD Station, HubSpot ou Pipedrive, os campos viram variáveis de mesclagem — algo como {{ lead.telefone }} e {{ lead.nome }} — que o CRM substitui pelo valor real de cada contato no momento do disparo. Assim, a mesma automação manda mensagens diferentes para leads diferentes a cada execução.
Autenticação pelo header token
A API do zapon não usa Bearer nem OAuth. A autenticação é um único header chamado token, cujo valor é o token da conexão que você copiou no Passo 1. Na ação HTTP do CRM, adicione um header com nome token e valor igual ao seu token. (Para não deixá-lo exposto, o ideal é guardá-lo como uma variável segura ou credencial do seu CRM/orquestrador e referenciá-lo.)
Veja a chamada completa de um follow-up por etapa, já com os campos do lead mesclados no texto:
follow-up por etapa do funil
POST https://api.zapon.dev/chat/send/text
token: SEU_TOKEN
Content-Type: application/json
{
"Phone": "5511988887777",
"Body": "Oi, Ana! Vi que você baixou nosso material. Posso ajudar?"
}
Ao executar a ação, a API responde com um JSON confirmando o envio e trazendo o identificador da mensagem:
resposta da API
{
"success": true,
"data": {
"id": "3EB0…"
}
}
Esse id é útil: você pode gravá-lo numa anotação ou campo do lead para registrar que o disparo aconteceu e rastrear cada mensagem de WhatsApp enviada pelo funil. Pronto — a primeira régua de saída está no ar.
Passo 3 — Gravar respostas no CRM (webhook)
Como trazer as respostas do lead de volta para o CRM?
Cadastre, na seção Webhook da sua conexão no painel do zapon, a URL que vai receber os eventos, marcando "mensagem recebida". Cada resposta do lead chega como um POST com o telefone e o texto; um pequeno endpoint (ou um cenário no n8n/Make) usa o telefone para achar o contato e registra a mensagem no histórico.
Sem o retorno, a integração é uma via só: o CRM fala, mas não escuta. Para fechar o ciclo, use um webhook — o zapon entrega cada evento (mensagem recebida, status de entrega) via POST na URL que você indicar, e essa URL é o ponto que vai gravar a conversa de volta no lead.
Defina a URL de recebimento
O destino do webhook pode ser um endpoint próprio (uma rota da sua aplicação) ou — o caminho mais rápido — um cenário no n8n ou no Make começando por um nó de webhook, que já te dá uma URL pronta. Esse ponto recebe o POST do zapon, lê o telefone do remetente e o texto, e então chama a API do seu CRM para localizar o lead por telefone e anexar a mensagem ao histórico do contato. É comum, logo na entrada, filtrar apenas mensagens recebidas de fato dos leads e ignorar as que o próprio número enviou.
Configurar o webhook no zapon
De volta ao painel do zapon, abra a sua conexão e localize a seção Webhook. Lá você:
- Informa a URL que você definiu para receber os eventos (a do seu endpoint ou a do cenário n8n/Make).
- Marca quais eventos deseja receber — tipicamente "mensagem recebida", mas também há status de entrega e leitura, úteis para saber se o lead leu a proposta.
- Salva. A partir desse momento, o WhatsApp do número passa a entregar os eventos como POST na URL configurada.
Feito isso, responda à mensagem de teste a partir de outro celular: o seu endpoint é acionado na hora, encontra o contato pelo telefone e grava o texto no lead. É assim que se monta o registro automático da conversa no CRM sem polling e sem ninguém copiando e colando.
Exemplos de régua e automação
Que automações de funil dá para criar com o CRM e o zapon?
As três mais valiosas: boas-vindas a um novo lead assim que ele entra, follow-up automático a cada mudança de status, e lembrete de proposta enviada e ainda sem resposta. Em todas, o CRM dispara o POST com o texto personalizado; quando o lead responde, o webhook grava o retorno no contato.
Com o disparo por etapa e o webhook de retorno como base, dá para combinar as transições do funil com a API do zapon de várias formas. Três réguas que cobrem a maior parte dos casos:
1. Boas-vindas a um novo lead
Assim que um lead entra no funil (formulário, captura de material rico, importação), a automação dispara a primeira mensagem com o nome dele. O segredo é a velocidade: responder em segundos, enquanto o interesse está quente.
boas-vindas a novo lead
POST https://api.zapon.dev/chat/send/text
token: SEU_TOKEN
{
"Phone": "{{ lead.telefone }}",
"Body": "Olá, {{ lead.nome }}! Recebemos seu contato e já estamos por aqui. Posso te ajudar com alguma dúvida?"
}
2. Follow-up por mudança de status
Quando o lead muda de etapa — de "qualificado" para "proposta enviada", por exemplo — o CRM dispara a mensagem correspondente àquele momento do funil. Cada etapa tem o seu texto, e como cada conexão tem o seu token, dá para fazer a mensagem sair do número do vendedor dono do negócio trocando o header.
follow-up por mudança de status
POST https://api.zapon.dev/chat/send/text
token: SEU_TOKEN
{
"Phone": "{{ lead.telefone }}",
"Body": "{{ lead.nome }}, acabei de te enviar a proposta da {{ empresa }}. Qualquer dúvida, é só me chamar por aqui!"
}
3. Lembrete de proposta sem resposta
Um lead com proposta enviada há X dias e sem retorno é dinheiro parado. Uma automação agendada (no CRM ou via cron no n8n/Make) varre os negócios nessa condição e, para cada um, dispara um lembrete gentil. O id retornado fica registrado para você não repetir o lembrete no dia seguinte.
lembrete de proposta sem resposta
POST https://api.zapon.dev/chat/send/text
token: SEU_TOKEN
{
"Phone": "{{ lead.telefone }}",
"Body": "Oi, {{ lead.nome }}! Passando para saber se você conseguiu ver a proposta. Faz sentido conversarmos?"
}
Testando ponta a ponta
Como testar a integração entre o zapon e o CRM?
Para o disparo, mova um lead de teste de etapa e confirme que a mensagem chegou no WhatsApp e que a resposta trouxe success: true. Para o retorno, cadastre o webhook e responda à mensagem de outro celular, verificando se o endpoint foi acionado e se a conversa apareceu no histórico do contato.
Validar nas duas direções leva poucos minutos:
- Teste de disparo: crie um lead de teste com o seu próprio telefone e mova-o para a etapa que aciona a automação. Confira três coisas — a mensagem chegou no aparelho, a resposta veio com
"success": true e existe um id em data. Se vier um erro de autenticação, revise o header token; se vier erro de número, revise o formato (só dígitos, com DDI e DDD).
- Teste de retorno: com o webhook cadastrado, responda à mensagem a partir de outro celular. O seu endpoint (ou cenário n8n/Make) deve ser acionado imediatamente. Inspecione o lead no CRM para confirmar que a resposta foi gravada no histórico do contato certo.
- Teste de ponta a ponta: com disparo e retorno ligados, simule um funil real — entrada do lead, mudança de etapa, resposta do lead — e acompanhe a conversa fluindo nas duas pontas, tanto no WhatsApp quanto no contato do CRM.
Se o retorno não grava nada, o suspeito número um é a URL do webhook: confirme que ela está acessível pela internet e que a lógica de busca está casando o telefone do remetente com o do lead (atenção a DDI e ao nono dígito).
Boas práticas e limites
Quais os limites e cuidados ao integrar o WhatsApp ao funil?
O zapon não usa a API oficial da Meta: o número conectado é um WhatsApp comum, então a saúde dele depende de você. Dispare só para leads que esperam contato, mantenha o texto relevante e respeite o opt-out. O preço é R$ 27 por número, com mensagens ilimitadas — o que torna a régua financeiramente previsível.
Alguns pontos para a integração durar e converter:
- Preço previsível: R$ 27 por número por mês, com mensagens ilimitadas. Sem custo por mensagem, réguas com muitos follow-ups e lembretes diários não pesam no caixa — você dimensiona pela quantidade de vendedores/números, não pelo volume de mensagens.
- Saúde do número: como é um WhatsApp comum sendo pilotado por API, o número está sujeito às regras de uso normais do WhatsApp. Disparar para listas frias ou para quem nunca pediu contato é o caminho mais rápido para um bloqueio. Trabalhe com leads que entraram por opt-in, mensagens relevantes a cada etapa e um ritmo natural.
- Respeite o opt-out: quando um lead pede para parar, marque isso no CRM e exclua-o das automações. Além de ser respeito, mantém o número saudável e a marca limpa.
- Personalize de verdade: use o nome e o contexto da etapa. Um "Oi, Ana! Sobre a proposta que te enviei…" converte muito mais do que um texto genérico — e é exatamente para isso que servem as variáveis do lead no
Body.
- Idempotência: em automações disparadas por evento, proteja-se contra reenvios. Salve o
id retornado e evite mandar o mesmo lembrete duas vezes se a automação rodar de novo.
- Segurança do token: trate o
token como senha. Prefira guardá-lo como variável segura ou credencial do CRM/orquestrador a deixá-lo escrito na ação HTTP.
Perguntas frequentes
Integra com RD Station, HubSpot ou Pipedrive?
Sim. Qualquer CRM que dispare webhooks ou permita chamadas HTTP consegue acionar a API do zapon, direto ou via n8n/Make. Em RD Station, HubSpot e Pipedrive basta criar uma automação que faça um POST para a URL de envio quando o lead muda de etapa.
Dá para personalizar a mensagem com dados do lead?
Sim. Você monta o texto com nome, etapa e qualquer campo do lead usando as variáveis de mesclagem do seu CRM, e envia o resultado no campo Body da requisição. Cada lead recebe uma mensagem feita com os dados dele.
As respostas do lead voltam para o CRM?
Sim, via webhook. Cada resposta do lead é entregue como POST à URL que você cadastrar; um endpoint ou cenário no n8n/Make usa o telefone para encontrar o contato e grava a mensagem no histórico, fechando o ciclo da conversa.
Como a API autentica? Preciso de token Bearer?
Não. A autenticação é um único header chamado token, cujo valor é o token da sua conexão (copiado no painel do zapon). Não é Bearer nem OAuth: basta adicionar esse header na ação HTTP do seu CRM ou orquestrador.
Qual a URL e o corpo para enviar uma mensagem?
A URL é https://api.zapon.dev/chat/send/text, método POST, com um body JSON contendo Phone (telefone do lead, só dígitos, com DDI e DDD) e Body (o texto personalizado). A resposta traz success true e o id da mensagem.
Meu CRM não chama HTTP diretamente. Tem solução?
Sim. Use o n8n ou o Make como ponte: o CRM dispara um webhook para o orquestrador, que monta a mensagem e chama a API do zapon. É o mesmo resultado, com um intermediário que cuida da chamada HTTP e da lógica.
Preciso da API oficial da Meta ou de uma conta WhatsApp Business?
Não. O zapon conecta um número de WhatsApp comum por QR Code ou código de pareamento. Não há fila de aprovação da Meta, templates obrigatórios nem custo por mensagem.
Quanto custa e tem limite de mensagens?
São R$ 27 por número por mês, com mensagens ilimitadas. Você ainda tem 14 dias grátis, sem cartão, para testar a integração com o seu CRM antes de assinar.