InícioCasos de uso › API de WhatsApp para CRM

Como integrar a API de WhatsApp do zapon ao seu CRM

Ligue o WhatsApp ao seu CRM e faça o funil andar sozinho: cada mudança de etapa dispara a mensagem certa, no momento certo, com o nome e os dados do lead. E quando ele responde, a conversa volta para o contato pelo webhook — sem ninguém digitar nada.

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:

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:

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:

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:

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

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:

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:

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.

Outros casos de uso

Conecte seu WhatsApp e comece a integrar com o CRM hoje.

14 dias grátis, sem cartão. Crie a conta, leia o QR Code e dispare a primeira mensagem do seu funil.