No seu ERP, o zapon vira só mais uma chamada HTTP: quando um pedido é confirmado, uma nota é emitida ou um boleto vence, o sistema dispara uma mensagem de WhatsApp para o cliente automaticamente. Funciona com ERP próprio, SAP, TOTVS, Tiny, Bling — qualquer um que faça requisições HTTP — direto ou via n8n e Make.
Um ERP é o cérebro operacional da empresa: concentra pedidos, estoque, financeiro, faturamento e logística num só lugar. Toda vez que algo acontece ali dentro — um pedido entra, uma nota fiscal é emitida, um boleto vence, uma carga sai para entrega — existe uma informação que o cliente, ou a sua própria equipe, gostaria de receber na hora. O problema é que, na maioria das operações, esse aviso depende de alguém lembrar de ligar, mandar e-mail ou digitar uma mensagem. Com a API REST do zapon, esse passo deixa de ser manual: cada evento do ERP pode virar uma mensagem de WhatsApp em segundos, sem ninguém no meio do caminho.
A boa notícia é que você não precisa de um módulo proprietário, de um plugin específico nem de uma integração homologada. Se o seu ERP consegue fazer uma chamada HTTP — e praticamente todos conseguem, seja por código, por um gatilho nativo ou por uma ferramenta de automação como o n8n ou o Make — ele consegue falar com o zapon. Ao longo deste guia você vai montar uma integração WhatsApp ERP de duas vias: o ERP dispara mensagens a partir dos seus eventos e recebe de volta, via webhook, as respostas que o cliente mandar. Tudo sobre um número de WhatsApp comum, sem a API oficial da Meta, sem fila de aprovação e sem custo por mensagem.
Você cria uma integração de WhatsApp de duas vias acionada pelo ERP: cada evento do sistema — pedido confirmado, nota emitida, boleto vencendo, entrega a caminho — dispara uma mensagem automática pela API do zapon, e as respostas do cliente voltam para o ERP por webhook. Tudo sem programar um servidor de mensagens.
Ao final deste guia você terá dois caminhos funcionando, que juntos cobrem praticamente qualquer necessidade de comunicação que nasce dentro de um ERP:
Tudo isso roda sobre um número de WhatsApp comum, conectado por QR Code exatamente como o WhatsApp Web. Não há fila de aprovação da Meta, não há templates obrigatórios e não há custo por mensagem: o número se conecta uma vez e passa a ser pilotado pela API a partir de qualquer evento que o seu sistema gere.
Três coisas: uma conta no zapon (14 dias grátis, sem cartão) com uma conexão de WhatsApp ativa, um ERP capaz de fazer chamadas HTTP (direto, por gatilho ou via n8n/Make) e o número de WhatsApp da empresa para conectar. Nenhuma conta de API oficial da Meta é necessária.
Antes de tocar no seu ERP, 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 de mensagem. O zapon conversa diretamente com o WhatsApp do número que você conectar, e o seu ERP só precisa saber fazer um POST.
No painel do zapon, crie uma conexão e leia o QR Code com o WhatsApp do número comercial (ou use o código de pareamento). Assim que a conexão ficar online, copie o token dela — é esse token que o seu ERP vai usar para autenticar cada chamada de envio.
Antes de qualquer linha de código no ERP, o número precisa estar conectado e a conexão precisa ter um token. Esse token é a chave que o seu sistema vai apresentar a cada requisição.
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 em local seguro: no seu ERP ele entra como um header chamado token (não é Authorization, não é Bearer, não é OAuth). Trate-o como uma senha, porque quem tem o token consegue enviar mensagens em nome do número da empresa. O lugar certo para ele é o cofre de segredos ou a tabela de configurações do seu sistema, nunca escrito direto no código-fonte.
Dica para operações com vários números: se a empresa usa um número para vendas e outro para o financeiro, por exemplo, crie uma conexão para cada um. Cada token corresponde a um número específico, então o ERP escolhe de qual número a mensagem sai apenas trocando o valor do header — útil quando você quer que a cobrança saia do número do financeiro e a confirmação de pedido saia do número do comercial.
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 ERP pode começar a disparar mensagens.
No ponto do ERP onde o evento acontece, faça uma requisição HTTP do tipo POST para https://api.zapon.dev/chat/send/text, com o header token da sua conexão e um body JSON contendo Phone (o número do cliente) e Body (o texto). O zapon entrega a mensagem e devolve o ID dela.
Este é o coração da integração. Não existe SDK obrigatório nem biblioteca proprietária: qualquer linguagem que faça uma requisição HTTP serve. O segredo é encontrar, dentro do ERP, o ponto exato em que o evento ocorre — o método que confirma o pedido, o gatilho que autoriza a nota, a rotina que fecha o título — e ali emitir o POST.
A chamada tem três partes fixas e duas variáveis. As fixas são o método, a URL e o header de autenticação:
POST.https://api.zapon.dev/chat/send/text.token, com o valor copiado no Passo 1.As partes variáveis são os dois campos do corpo JSON: Phone, o número do cliente no formato internacional (só dígitos, com DDI e DDD, ex.: 5511999999999), e Body, o texto da mensagem. No seu ERP, esses dois campos virão dos dados do próprio evento — o telefone cadastrado no cliente e um texto montado com os dados do pedido, da nota ou do título.
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. No código do seu ERP, basta incluir esse header na requisição. Como ele é sensível, leia-o de uma variável de ambiente ou de uma configuração protegida do sistema — nunca o deixe fixo no código que vai para o repositório.
Veja a chamada completa, no exemplo de uma confirmação de pedido:
POST https://api.zapon.dev/chat/send/text token: SEU_TOKEN Content-Type: application/json { "Phone": "5511999999999", "Body": "Pedido #4821 confirmado!" }
Ao receber a requisição, a API responde com um JSON confirmando o envio e trazendo o identificador da mensagem:
{
"success": true,
"data": {
"id": "3EB0…"
}
}Esse id é valioso: guarde-o no próprio registro do ERP (no pedido, no título, na ordem de entrega) para ter rastreabilidade — você passa a saber, dentro do sistema, que aquele evento gerou uma notificação de WhatsApp e qual foi o identificador dela. Pronto: o caminho de saída está completo, e qualquer evento do ERP agora pode virar mensagem.
Há três formas comuns de acoplar a chamada ao ERP, em ordem de simplicidade:
POST. É o caminho mais direto e o que dá mais controle sobre o texto.POST ao zapon.Configure um webhook no painel do zapon: informe a URL de um endpoint do seu ERP e marque os eventos desejados, como mensagem recebida. A partir daí, sempre que o cliente responde, o zapon envia um POST com os dados da mensagem para o seu sistema, que registra ou trata a interação.
Avisar o cliente é metade da integração. A outra metade é ouvir a resposta dele dentro do mesmo sistema, sem ninguém olhando o aparelho de WhatsApp. Isso é feito com um webhook: o zapon entrega cada evento (mensagem recebida, status de entrega, leitura) via POST na URL que você indicar — e essa URL é um endpoint do seu ERP.
No seu ERP, exponha uma rota HTTP capaz de receber um POST com corpo JSON. Esse endpoint precisa estar acessível pela internet para que o zapon consiga alcançá-lo — em sistemas internos, isso costuma significar publicar a rota num domínio público ou atrás de um gateway. Ao receber a chamada, o seu código lê os dados da mensagem (remetente, texto, tipo) e decide o que fazer: registrar a resposta no histórico do cliente, atualizar o status de um pedido, abrir uma tarefa para o atendimento ou simplesmente armazenar para auditoria.
Uma boa prática é tratar o webhook de forma idempotente e responder rápido (com um 200), deixando o processamento mais pesado para uma fila. Assim, picos de mensagens não travam a recepção.
De volta ao painel do zapon, abra a sua conexão e localize a seção Webhook. Lá você:
POST na URL configurada.Feito isso, peça para alguém responder a uma mensagem enviada pelo número: o endpoint do ERP é acionado na hora, com os dados da resposta. É assim que a conversa do WhatsApp passa a viver dentro do sistema, e não num celular esquecido na mesa.
Praticamente todas as que nascem de um evento do sistema: no módulo de vendas, confirmação de pedido; no financeiro, aviso de nota fiscal e cobrança de boleto ou Pix; na logística, status de entrega; no estoque, alertas internos para a equipe. Em todos, o ERP só precisa disparar o mesmo POST com um texto diferente.
Com o caminho de saída do Passo 2 como base, cada módulo do ERP vira uma fonte de mensagens. Quatro cenários cobrem a maioria das operações:
No momento em que o pedido é registrado ou aprovado, o ERP monta o texto com o número e o valor do pedido e dispara a confirmação para o cliente. É o aviso que mais reduz ligações do tipo "meu pedido entrou?".
POST https://api.zapon.dev/chat/send/text token: SEU_TOKEN { "Phone": "5511999999999", "Body": "Pedido #4821 confirmado! Total R$ 320,00." }
Quando a nota fiscal é autorizada, o ERP envia o aviso com o link de download. E quando um título se aproxima do vencimento, uma rotina diária varre os boletos a vencer e dispara o lembrete com o Pix ou o código de barras. São dois dos usos de maior retorno, porque atacam diretamente a inadimplência e a dúvida sobre a nota.
POST https://api.zapon.dev/chat/send/text token: SEU_TOKEN { "Phone": "5511999999999", "Body": "Seu boleto do pedido #4821 vence amanhã. Pague via Pix: ..." }
A cada mudança no módulo de logística — pedido despachado, em rota, entregue — o ERP avisa o cliente. Como o status já existe no sistema, basta amarrar a chamada à transição de etapa: o evento que muda o status é o mesmo que dispara o POST. O resultado é um rastreamento por WhatsApp sem nenhum portal extra.
Nem toda mensagem é para o cliente. Quando um item cruza o estoque mínimo, o ERP pode disparar um alerta para o WhatsApp do comprador ou do gestor — trocando apenas o Phone de destino para o número interno. É a mesma mecânica de envio, mas voltada para dentro da operação, garantindo que ninguém descubra a ruptura tarde demais.
Para o envio, dispare a chamada com um número de teste e confirme que a mensagem chegou e que a resposta trouxe success: true com um id. Para o recebimento, cadastre o webhook e responda a uma mensagem do número conectado, verificando se o endpoint do ERP foi acionado com os dados corretos.
Validar nas duas direções leva poucos minutos:
POST para um número seu. 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).Se algo não dispara no recebimento, o suspeito número um é a URL do webhook: confirme que ela está acessível pela internet. Em ERPs internos, esse é o erro mais comum — o endpoint existe, mas só responde dentro da rede da empresa.
O zapon não usa a API oficial da Meta: o número é um WhatsApp comum, então a saúde dele depende de você. Mande só mensagens transacionais que o cliente espera (pedido, nota, cobrança, entrega), evite disparos em massa para quem não pediu e proteja o token. O preço é R$ 27 por número, com mensagens ilimitadas.
Alguns pontos para a integração durar e render:
id retornado e marque no ERP que aquele evento já notificou, para não mandar a mesma mensagem duas vezes.token como senha. No ERP, leia-o de uma variável de ambiente ou de uma configuração protegida, nunca do código-fonte versionado.Sim. Como a integração é por API REST (HTTP), funciona com qualquer ERP que permita chamadas HTTP — próprio, SAP, TOTVS, Tiny, Bling e outros — diretamente no código, por webhook de saída do ERP ou via uma camada de automação como o n8n ou o Make.
A URL é https://api.zapon.dev/chat/send/text, método POST, com o header token e um body JSON contendo Phone (número do cliente, só dígitos, com DDI e DDD) e Body (o texto). A resposta traz success true e o id da mensagem.
Por um único header chamado token, cujo valor é o token da sua conexão (você o copia no painel do zapon). Não é Bearer nem OAuth: basta incluir esse header na requisição que o ERP faz.
Sim. Configure um webhook no painel do zapon apontando para um endpoint do seu ERP. Quando o cliente responde, o zapon envia um POST com os dados da mensagem, e o seu sistema registra ou trata a interação.
Não necessariamente. Você pode conectar o número comercial que a empresa já usa, lendo o QR Code uma vez. Se preferir separar áreas, pode criar uma conexão para o número de vendas e outra para o financeiro.
Sim. Se o ERP tiver webhook de saída ou se você usar o n8n ou o Make ligado a ele, a ferramenta de automação captura o evento e faz a chamada à API do zapon — sem nenhuma linha de código no ERP.
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.
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 ERP antes de assinar.
14 dias grátis, sem cartão. Crie a conta, leia o QR Code e dispare a primeira notificação do seu sistema.