Integrar ERP com WhatsApp: Arquitetura, Custos e Armadilhas
Boleto, NF-e e pedido saindo do ERP direto para o WhatsApp do cliente: o desenho que aguenta escala e quanto custa de verdade.
por Cleverson Gouvêa
Integrar ERP com WhatsApp é o pedido que mais ouço de empresa que já fatura bem e ainda cobra cliente copiando boleto do sistema e colando no celular. O ERP sabe que a fatura venceu. O WhatsApp é onde o cliente responde. Entre os dois, alguém do financeiro faz o trabalho de um webhook. Este guia mostra a arquitetura que funciona, quanto custa de verdade depois da mudança de preços de outubro de 2026 e as armadilhas que vi derrubar projetos.
TL;DR
- O caminho seguro para integrar ERP com WhatsApp é a API oficial (Cloud API da Meta) com uma camada intermediária sua: fila, banco de eventos e tratamento de erro. Ligar o ERP direto na Meta funciona na demonstração e quebra na primeira semana de volume.
- Desde 1º de outubro de 2026, a Meta cobra também as mensagens de atendimento dentro da janela de 24 horas, no mesmo valor das mensagens de utilidade. Na tabela em reais que vigorava desde julho de 2026, utilidade custava R$ 0,035 por mensagem e marketing R$ 0,3217.
- O custo maior raramente é a Meta. É o desenvolvimento da ponte, a hospedagem e a manutenção quando a API do ERP ou a da Meta muda de versão.
- Não faça a integração se o seu volume é de poucas dezenas de mensagens por dia ou se o cadastro de telefones no ERP está sujo. Arrume o dado antes.
Por que integrar ERP com WhatsApp virou prioridade em 2026
O cliente brasileiro responde no WhatsApp. E-mail de cobrança vai para o spam, SMS parece golpe, ligação ninguém atende. A conta é simples: se a mensagem que gera caixa (boleto, Pix, nota fiscal, rastreio) sai pelo canal onde o cliente está, ela é lida.
O que mudou em 2026 não foi a demanda. Foi o custo de fazer errado. Três movimentos da Meta mexeram no projeto de quem quer integrar ERP com WhatsApp neste ano:
- Cobrança em reais. Desde 1º de julho de 2026, empresas com faturamento no Brasil podem criar contas do WhatsApp Business (WABA) cobradas em BRL, com nota emitida pelo Facebook Brasil. A migração de todas as contas para BRL é obrigatória até 30 de junho de 2027; a partir de 1º de julho de 2027, a Meta para de entregar mensagens de contas que não migraram (documentação oficial de preços).
- Fim da resposta grátis. Desde 1º de outubro de 2026, mensagens de atendimento (texto livre) e templates de utilidade enviados dentro da janela de 24 horas passaram a ser cobrados, com o mesmo preço da categoria utilidade em cada mercado (página da Meta sobre mensagens sem template).
- Limites por portfólio. Desde 7 de outubro de 2025, o limite de mensagens iniciadas pela empresa vale para o portfólio inteiro, não para cada número.
Detalhei o calendário completo em mudanças na API do WhatsApp de 2026 a 2028. Aqui o foco é outro: como desenhar a integração para que essas mudanças não virem incêndio.
A arquitetura certa para integrar ERP com WhatsApp
Em mais de 15 anos montando integrações (Moodle com sistema acadêmico, loja com gateway, ERP com CRM), aprendi que o desenho que sobrevive tem sempre o mesmo formato: o ERP nunca conversa direto com a Meta. Entre os dois existe um serviço seu, que chamo de middleware (camada intermediária).
As quatro peças
- Conector do ERP. Lê eventos do ERP (fatura emitida, pedido faturado, título vencido) por webhook, quando o ERP oferece, ou por consulta periódica (polling), quando não oferece.
- Fila de mensagens. Cada envio vira um item numa fila (Redis, RabbitMQ ou uma tabela de banco bem indexada). A fila absorve picos e permite reenviar sem duplicar.
- Cliente da Cloud API. Envia templates aprovados, guarda o ID que a Meta devolve e trata os códigos de erro.
- Receptor de webhooks. Recebe da Meta os status (enviado, entregue, lido, falhou) e as respostas do cliente, e escreve de volta no ERP quando faz sentido.
Por que não ligar o ERP direto na Meta
Porque os dois lados têm regras de tráfego que não combinam. A Cloud API aceita, por padrão, 80 mensagens por segundo por número. O ERP costuma aceitar bem menos. A API do Omie, por exemplo, limita a 240 chamadas por minuto para cada combinação de IP, App Key e método, aceita no máximo 4 requisições simultâneas e bloqueia o acesso por 30 minutos na 10ª requisição com erro (limites de consumo da API do Omie). Se cada mensagem lida no WhatsApp disparar uma consulta ao ERP sem controle, você bloqueia a própria integração numa manhã de régua de cobrança.
O middleware é onde você coloca o freio: lotes, cache e espera exponencial entre tentativas. Quem tenta integrar ERP com WhatsApp sem essa camada descobre o limite do ERP em produção, não no teste.
Fluxo típico de uma cobrança
- O ERP marca o título como "a vencer em 3 dias".
- O conector lê o evento e grava na fila: cliente, valor, link do boleto ou Pix copia e cola.
- O cliente da Cloud API envia o template de utilidade aprovado.
- A Meta devolve o status por webhook; o middleware grava "entregue" e "lido".
- Se o cliente responde "já paguei", a conversa vai para um atendente, com o histórico do título ao lado.
- Quando o ERP baixa o pagamento, o middleware encerra a régua daquele cliente.
API oficial ou não oficial: a escolha que define o projeto
Muita empresa que quer integrar ERP com WhatsApp começa por uma biblioteca que simula o WhatsApp Web, porque não paga por mensagem. Já atendi cliente que chegou até nós depois de perder o número principal num bloqueio, com a carteira inteira de contatos dentro.
| Critério | API oficial (Cloud API) | Solução não oficial (WhatsApp Web emulado) |
|---|---|---|
| Custo por mensagem | Sim, por mensagem entregue | Não |
| Risco de bloqueio do número | Baixo, se seguir as políticas | Alto, viola os termos de uso |
| Webhook de status e respostas | Nativo, com reenvio por até 7 dias | Depende da biblioteca |
| Templates para iniciar conversa | Obrigatórios e aprovados pela Meta | Não existem (e é por isso que bloqueia) |
| Escala | 80 msg/s por padrão, até 1.000 msg/s | Limitada a uma sessão de celular |
| Contrato e nota fiscal | Meta ou provedor oficial | Nenhum |
Para ERP, que dispara mensagem iniciada pela empresa todo dia, a não oficial é aposta contra a casa. Comparei os dois modelos em detalhe em WhatsApp Business app vs API oficial.
Quanto custa integrar ERP com WhatsApp: as três contas
O orçamento de quem vai integrar ERP com WhatsApp tem três linhas. Quase todo mundo só olha a primeira.
1. Mensagens (Meta)
Desde julho de 2025 a Meta cobra por mensagem de template entregue, com preço por categoria e país do destinatário. Na tabela em BRL que passou a valer em 1º de julho de 2026, os valores para o Brasil eram:
| Categoria | Uso típico no ERP | Preço por mensagem (BRL, jul/2026) |
|---|---|---|
| Utilidade | Boleto, NF-e, confirmação de pedido, rastreio | R$ 0,035 |
| Autenticação | Código de acesso ao portal do cliente | R$ 0,035 |
| Marketing | Promoção, reativação, oferta | R$ 0,3217 |
| Atendimento (texto livre na janela de 24h) | Resposta do financeiro ao cliente | Mesmo valor de utilidade, desde 01/10/2026 |
A Meta só altera preços no primeiro dia de cada trimestre, e utilidade e autenticação têm faixas de desconto por volume, somadas no portfólio. Confira sempre o arquivo de preços em BRL na página oficial antes de fechar a conta. Para um aprofundamento só nesta parte, veja custo por conversa na API oficial do WhatsApp.
Exemplo de régua de cobrança: 2.000 títulos por mês, com aviso 3 dias antes e no dia do vencimento, somam 4.000 templates de utilidade. A R$ 0,035, são R$ 140 por mês. Se 15% dos clientes respondem e o financeiro troca 4 mensagens com cada um, são mais 1.200 mensagens de atendimento, ou R$ 42. O canal custa menos que uma hora de estagiário.
Quem vai integrar ERP com WhatsApp precisa cuidar também da categoria. Uma armadilha comum: template de utilidade com "aproveite e conheça nossa nova linha" é reclassificado como marketing, e o preço sobe quase dez vezes. Escreva a régua de cobrança seca e transacional.
2. Desenvolvimento
Aqui mora o grosso. Os itens que determinam o tamanho do projeto:
- Qualidade da API do ERP. Bling, Omie e Tiny têm APIs REST documentadas. Protheus e SAP Business One costumam exigir camada própria ou acesso ao banco. ERP feito em casa, sem API, exige criar a API primeiro.
- Número de fluxos. Só cobrança é um projeto. Cobrança, pedido, rastreio, NPS e atendimento com retorno ao ERP é outro.
- Escrita de volta no ERP. Só ler é simples. Gravar resposta do cliente, baixar título ou abrir chamado exige regra de negócio e testes.
Na Agathas Web, o desenvolvimento sob medida começa justamente por esse levantamento, antes de qualquer número de prazo.
3. Hospedagem e manutenção
O middleware precisa estar no ar 24 horas, com HTTPS válido, para receber webhooks. A Meta tenta reenviar um webhook que falhou por até 7 dias e avisa que isso gera notificações duplicadas. Payloads chegam a 3 MB (visão geral de webhooks da Meta). Some servidor, monitoramento, backup do banco de eventos e as horas para acompanhar mudanças de versão da Graph API e do ERP.
Quando integrar ERP com WhatsApp não vale a pena
Sou o primeiro a dizer não quando o projeto não se paga. Integrar ERP com WhatsApp não é obrigação de toda empresa. Evite (ou adie) se:
- O volume é baixo. Com 30 boletos por mês, um atendente com o WhatsApp Business e respostas rápidas resolve. A integração não se paga.
- O cadastro está sujo. Telefone fixo no campo de celular, número sem DDD, cliente com três contatos diferentes. Integração não limpa dado; ela espalha erro em escala. Faça a higienização primeiro.
- Não existe opt-in. As políticas da Meta exigem consentimento para mensagens iniciadas pela empresa, e a LGPD exige base legal para o tratamento. Se o cliente nunca autorizou contato por WhatsApp, comece coletando isso no cadastro e no checkout.
- O ERP vai ser trocado em seis meses. Espere a migração. Integrar o sistema que vai morrer é pagar duas vezes.
- O objetivo é disparo em massa de promoção. Marketing a R$ 0,3217 por mensagem, com limite diário por portfólio e risco de queda na qualidade do número, pede outra estratégia, não uma integração com ERP.
As armadilhas que mais derrubam integrações
Mensagem duplicada
É o problema número um de quem acaba de integrar ERP com WhatsApp sem idempotência. Webhook reenviado, fila que reprocessa, operador que clica duas vezes. O cliente recebe o mesmo boleto três vezes e reclama. A defesa é idempotência: cada envio tem uma chave única (ID do título + etapa da régua) e o middleware recusa a segunda tentativa. Do lado dos webhooks, grave o ID de cada evento e ignore repetidos.
Resposta lenta ao webhook
Se o receptor processa tudo antes de responder, a Meta entende como falha e reenvia. Responda HTTP 200 imediatamente, grave o evento e processe depois, numa fila.
Telefone como chave do cliente
É a armadilha nova de 2026. Com os nomes de usuário do WhatsApp, o contato pode chegar identificado por um BSUID (identificador por empresa), e não pelo número de telefone. Integração que casa cliente só pelo telefone vai criar cadastro duplicado. Expliquei o impacto em usernames do WhatsApp e BSUID.
Limite de mensagens e qualidade
O limite conta clientes únicos alcançados fora da janela de atendimento em 24 horas, nos degraus 250, 2 mil, 10 mil, 100 mil e ilimitado. Ele sobe sozinho quando a qualidade é boa e você usou pelo menos metade do limite nos últimos 7 dias. Uma régua mal escrita que gera bloqueios e denúncias derruba a qualidade e trava a escala.
Token e versão expirando
Token de usuário expira; use token de usuário de sistema. Cada versão da Graph API tem data de fim. Integração sem dono técnico para de funcionar numa segunda-feira sem aviso.
Checklist para integrar ERP com WhatsApp com segurança
Antes de assinar qualquer orçamento, confira:
- Conta verificada. Portfólio empresarial verificado na Meta e número dedicado à API (o mesmo número não roda no app comum e na API ao mesmo tempo).
- Forma de pagamento cadastrada e plano para migrar a WABA para BRL até junho de 2027.
- Templates aprovados para cada etapa, na categoria certa.
- Mapa de eventos do ERP: quais eventos existem, se há webhook ou só consulta, quais são os limites da API.
- Opt-in registrado com data e origem, por cliente.
- Idempotência e fila no desenho, não como "melhoria futura".
- Monitoramento: alerta quando a taxa de falha passa de um limite, quando a fila acumula ou quando o webhook para de chegar.
- Dono técnico definido para tokens, versões e mudanças de preço.
Se três ou mais itens ainda estão em aberto, o projeto não está pronto para começar. Está pronto para planejar.
Como a Agathas Web resolve isso
Trabalhamos com a API oficial do WhatsApp em produção, mantemos servidores Linux com hospedagem gerenciada e desenvolvemos integrações desde 2008, de plataformas Moodle com sistemas acadêmicos a ERPs com gateways de pagamento. Quando um cliente pede para integrar ERP com WhatsApp, o projeto segue quatro etapas.
O que está incluso
- Diagnóstico de 1 a 2 semanas: leitura da API do seu ERP, mapa de eventos, cálculo de volume e de custo mensal na Meta, e uma recomendação franca (inclusive "não faça agora", se for o caso).
- Configuração da conta oficial: verificação do portfólio, número, templates e cobrança em BRL.
- Middleware sob medida: fila, idempotência, receptor de webhooks, painel de status e escrita de volta no ERP quando o fluxo pedir.
- Hospedagem e monitoramento na nossa infraestrutura gerenciada, com HTTPS, backup e alertas.
- Manutenção contínua: acompanhamos as mudanças de versão da Graph API, da tabela de preços e da API do ERP.
Como funciona na prática
Começamos pelo fluxo que mais gera caixa (quase sempre a régua de cobrança), colocamos em produção e medimos. Os fluxos seguintes entram em cima da mesma base. Se o seu problema é atendimento com vários atendentes no mesmo número, e não integração, o Voyia já resolve sem código sob medida.
Como contratar
Fale com a gente pela página de desenvolvimento de sistemas e integrações, conte qual ERP você usa e quantos títulos ou pedidos emite por mês. Respondemos com o escopo do diagnóstico e o próximo passo.
Conclusão: integre o que gera caixa, do jeito que aguenta escala
Integrar ERP com WhatsApp vale a pena quando o volume justifica, o cadastro está limpo e o cliente autorizou o contato. A Meta deixou as regras mais caras e mais claras em 2026: tudo que sai pela API tem preço, e quem não migrar para BRL até junho de 2027 para de enviar. O que separa uma integração estável de um problema recorrente é a camada do meio: fila, idempotência, webhooks bem tratados e alguém olhando as mudanças.
Se você quer começar pela régua de cobrança e medir o retorno antes de ampliar, fale com a equipe de desenvolvimento da Agathas Web.
Perguntas frequentes
Quanto custa integrar ERP com WhatsApp?
São três contas. A Meta cobra por mensagem: na tabela em reais de julho de 2026, utilidade (boleto, NF-e, rastreio) custava R$ 0,035 e marketing R$ 0,3217, e desde 1º de outubro de 2026 as respostas dentro da janela de 24 horas também são cobradas no valor de utilidade. A segunda conta é o desenvolvimento da camada intermediária, que varia com a qualidade da API do ERP e o número de fluxos. A terceira é hospedagem e manutenção, porque o serviço precisa ficar no ar 24 horas para receber webhooks. Na maioria dos projetos, o custo da Meta é a menor das três.
Posso integrar ERP com WhatsApp usando o WhatsApp Business comum?
Não de forma segura. O aplicativo WhatsApp Business não tem API para sistemas externos. As ferramentas que automatizam o app emulam o WhatsApp Web, violam os termos de uso e colocam o número em risco de bloqueio, o que é grave quando a carteira de clientes inteira conversa por ele. Para mensagens iniciadas pela empresa, como cobrança e confirmação de pedido, o caminho é a API oficial da Meta (Cloud API), com templates aprovados e webhooks de status.
Meu ERP não tem API. Ainda dá para integrar com o WhatsApp?
Dá, mas o projeto cresce. Quando o ERP não oferece API nem webhooks, a alternativa é ler os dados por outra via: acesso controlado ao banco de dados, exportação agendada de arquivos ou uma API própria construída ao lado do ERP. Cada uma tem riscos, como depender da estrutura interna do banco, que pode mudar numa atualização. Se a troca de ERP está prevista para os próximos meses, normalmente compensa esperar e integrar o sistema novo.
Quanto tempo leva para colocar a integração no ar?
Depende do ERP e do escopo. Um fluxo único, como a régua de cobrança, num ERP com API REST documentada, costuma ser o projeto mais curto. A verificação do portfólio na Meta e a aprovação dos templates correm em paralelo e podem atrasar se a documentação da empresa estiver desatualizada. Fluxos que escrevem de volta no ERP, como baixar título ou abrir chamado, exigem mais testes. Por isso começamos sempre com um diagnóstico de uma a duas semanas antes de comprometer prazo.
A integração precisa de consentimento do cliente (LGPD)?
Sim. As políticas da Meta exigem opt-in para mensagens iniciadas pela empresa, e a LGPD exige base legal para tratar o telefone do cliente. Na prática, registre o consentimento no cadastro, no checkout ou no contrato, guardando data e origem. Integração que dispara para quem nunca autorizou gera bloqueios e denúncias, derruba a qualidade do número e trava o aumento do limite de mensagens.
Posts relacionados
Site da empresa no AI Overviews: como ser citado pelo Google
A IA do Google responde antes do clique. Veja o que muda no seu site para virar fonte da resposta, e não só mais um link ignorado.
Refazer Site Legado em PHP sem Parar a Operação
PHP 8.1 sem suporte, 8.2 no fim: como trocar o sistema velho por partes, sem desligar nada e sem perder clientes no caminho.
Hospedagem Gerenciada vs VPS: Quem Cuida do Quê Quando o Site Cai
Seu site caiu às 2h da manhã. Na VPS, o problema é seu; na gerenciada, de uma equipe. Veja a divisão real e o custo de cada lado.