Como integrar o WhatsApp ao ERP: 3 caminhos

Resposta rápida (TL;DR)

Integrar o WhatsApp ao ERP vale quando existe informação que já mora no sistema de gestão e hoje é lida e digitada por uma pessoa: status de pedido, emissão de nota, cobrança em aberto e disponibilidade de estoque. Há três caminhos. O conector nativo do ERP é o mais rápido e o menos flexível. O middleware (plataforma de integração ou de atendimento com conector) resolve a maior parte dos casos sem código próprio. O desenvolvimento sob medida entrega controle total e cobra manutenção. Antes de escolher, defina quem é dono de cada campo, como o telefone e o CNPJ serão normalizados e qual evento do ERP dispara qual mensagem.

O que a integração entre WhatsApp e ERP resolve de verdade

A integração existe para que o dado que já está no ERP chegue ao cliente sem alguém digitar, e para que a resposta do cliente volte ao sistema sem alguém copiar. O ERP guarda o pedido, a nota fiscal, o título em aberto e o saldo de estoque. O WhatsApp tem a atenção do cliente. Quase toda a economia vem de eliminar consulta manual: o atendente deixa de abrir duas telas para responder onde está o pedido.

Um teste simples decide se o projeto se justifica. Conte, por uma semana, quantas mensagens recebidas pedem informação que já existe no ERP. Se a maior parte do volume for isso, a integração se paga em tempo de atendente. Se a maior parte for negociação, dúvida técnica ou reclamação, o ganho está em outro lugar e o ERP não é o gargalo.

Os quatro casos que pagam a integração

Nem tudo que o ERP tem precisa virar mensagem. Quatro casos concentram o retorno porque são repetitivos, previsíveis e ligados a um evento claro do sistema.

Caso de uso	Dado que vem do ERP	O que dispara	Categoria do modelo
Status de pedido	Número, etapa, previsão, transportadora	Mudança de situação do pedido	Utilidade
Nota fiscal	Chave, número, link do documento	Emissão autorizada	Utilidade
Cobrança	Título, vencimento, linha digitável ou chave Pix	Boleto gerado, vencimento próximo, título vencido	Utilidade
Estoque	Saldo, previsão de reposição	Pergunta do cliente ou retorno de item	Utilidade na resposta, marketing no aviso de volta

A distinção de categoria importa mais do que parece. Modelo de utilidade trata de uma transação que o cliente já tem com a empresa. Assim que a mensagem mistura utilidade com oferta, ela vira marketing aos olhos da Meta, e conteúdo misto é justamente um dos motivos de reclassificação de modelo. O aviso de que um item voltou ao estoque é promocional por natureza e exige consentimento. O detalhamento das três categorias está no guia completo da API oficial do WhatsApp.

Decida antes: quem é dono do dado

Integração de ERP não costuma falhar por limitação técnica. Falha por decisão não tomada. Três definições precedem qualquer configuração.

1. Fonte de verdade por campo, não por sistema

A resposta raramente é "o ERP manda em tudo". O ERP costuma ser dono de pedido, financeiro, nota e estoque. A plataforma de atendimento costuma ser dona da conversa, do consentimento e do responsável pelo contato. Cadastro do cliente é o campo disputado: escolha um lado e faça o outro apenas ler.

2. Chave de identificação do cliente

No ERP o cliente é identificado por CNPJ, CPF ou código interno. No WhatsApp ele é um número de telefone. A ponte entre os dois precisa ser explícita e gravada, porque o telefone muda, é compartilhado dentro da empresa e às vezes pertence ao comprador, não ao titular do cadastro. Sem essa tabela de vínculo, a integração vira adivinhação.

3. Qual evento do ERP vira mensagem

Um pedido pode mudar de situação dez vezes até chegar ao cliente. Mandar dez mensagens é o caminho mais rápido para o bloqueio. Escolha de três a quatro marcos que o cliente reconhece: confirmado, faturado, despachado, entregue.

Caminho 1: conector nativo do ERP

Alguns ERPs brasileiros já trazem um módulo de WhatsApp ou um conector oficial de parceiro. Configura rápido, usa a base de clientes que já está lá e não exige time técnico.

O limite aparece cedo. O conector nativo costuma cobrir o envio de aviso e o disparo de documento, mas entrega pouco do lado do atendimento: sem fila, sem distribuição entre vendedores, sem histórico organizado por atendente. Serve quando o objetivo é notificar, não conversar.

Caminho 2: middleware

É o caminho mais comum. Uma plataforma fica entre os dois lados: pode ser uma ferramenta de integração genérica ou uma plataforma de atendimento com WhatsApp na API oficial e conector de ERP. O ERP publica o evento, o middleware traduz e a mensagem sai pelo modelo aprovado.

O ganho é operacional: a conversa acontece num lugar preparado para atendimento, com fila, transferência e automação, enquanto o ERP segue sendo o sistema de registro. O que exige atenção:

Direção da sincronia. Bidirecional sem regra de precedência faz um lado sobrescrever o outro.
Frequência. Lote atrasa o aviso ao cliente. Tempo real gera mais chamadas e mais custo.
Campos mapeados. Comece pelo mínimo que resolve os quatro casos e cresça depois.
Limite de requisições. ERP e plataforma têm teto de chamadas. Sincronizar tudo em operação de volume alto encosta nesse teto.

Caminho 3: desenvolvimento próprio

Faz sentido quando a regra de negócio não cabe em conector pronto, quando o ERP é legado ou desenvolvido internamente, ou quando o volume torna o custo do middleware maior que o da manutenção. A empresa recebe os eventos por webhook, aplica a lógica e envia pela API oficial. O funcionamento do webhook está detalhado em como funciona o webhook do WhatsApp.

Cinco itens precisam ser tratados desde o primeiro dia:

Idempotência. O mesmo evento pode chegar duas vezes. Sem chave de deduplicação, o cliente recebe a mensagem em dobro.
Ordem dos eventos. "Despachado" pode chegar antes de "faturado". Grave e compare pelo horário do evento, não pelo de recebimento.
Fila com nova tentativa. Quando o ERP ou a API respondem erro, o evento não pode simplesmente sumir.
Janela de 24 horas. Fora dela só sai modelo aprovado. O código precisa saber em qual dos dois estados está.
Registro de auditoria. Guardar o que foi enviado e a resposta recebida. Sem isso, investigar divergência vira adivinhação.

Comparativo dos três caminhos

Critério	Nativo do ERP	Middleware	Desenvolvimento
Tempo até funcionar	Dias	Semanas	Meses
Recursos de atendimento	Mínimos	Completos	O que for construído
Flexibilidade de regra	Baixa	Média	Total
Quem mantém quando quebra	Fornecedor do ERP	Fornecedor da plataforma	Time interno

Duplicidade: o erro que mais aparece

Duplicidade de contato e duplicidade de mensagem são os dois defeitos clássicos, e têm causas diferentes.

O contato duplica por formato de telefone. O mesmo cliente aparece como +55 48 99999-9999, 5548999999999 e (48) 99999-9999. Grave sempre no mesmo formato, apenas dígitos com código do país, e trate a diferença entre celulares de oito e nove dígitos depois do DDD, comum em cadastro antigo de ERP.

A mensagem duplica por reprocessamento. O ERP reenvia o evento, a fila tenta de novo, o cliente recebe a mesma nota duas vezes. A defesa é uma chave única por evento, algo como número do pedido mais situação mais data, verificada antes de enviar.

Armadilhas de produção

Teste rodando em cima da base real. Homologação apontando para o ERP de produção manda mensagem de verdade para cliente de verdade.
Modelo reprovado no meio da campanha. Sem alternativa aprovada, o aviso simplesmente não sai e ninguém percebe.
Falha silenciosa fora da janela. O fluxo dispara, a Meta recusa por falta de modelo e o time só descobre quando o cliente cobra.
Cobrança sem consentimento claro. Aviso de vencimento é utilidade, mas insistência com tom de pressão gera denúncia e derruba a nota do número.
Ninguém dono da integração. Quando quebra, fornecedor do ERP e da plataforma apontam um para o outro. Defina um responsável interno.
Estoque desatualizado virando promessa. Se a consulta lê um saldo em cache, o cliente compra o que não existe.

Roteiro de implantação

Liste os eventos do ERP que o cliente reconhece e corte o resto.
Defina fonte de verdade por campo e a chave que liga telefone a cadastro.
Padronize o formato de telefone dos dois lados antes de ligar qualquer fluxo.
Aprove os modelos de utilidade correspondentes e mantenha uma alternativa para cada um.
Rode com um número secundário e um grupo pequeno de clientes reais por pelo menos uma semana.
Verifique duplicidade buscando o mesmo cliente em formatos diferentes.
Só então ligue cobrança automática e disparo em volume.

Se a operação também precisa registrar a conversa no funil comercial, o raciocínio é o mesmo aplicado ao CRM, descrito em como integrar o WhatsApp ao HubSpot.

Perguntas frequentes (FAQ)

Como integrar o WhatsApp ao ERP da minha empresa?

Por três caminhos. O conector nativo, quando o ERP já oferece um módulo de WhatsApp, resolve envio de aviso com pouca configuração. O middleware, plataforma de integração ou de atendimento com conector, cobre a maior parte dos casos e ainda entrega fila e distribuição. O desenvolvimento próprio via API oficial dá controle total e cobra manutenção. Antes de escolher, defina quem é dono de cada campo e qual evento do ERP vira mensagem.

Quais mensagens vale a pena automatizar a partir do ERP?

Quatro casos concentram o retorno: status de pedido, emissão de nota fiscal, cobrança (boleto gerado, vencimento próximo, título vencido) e consulta de estoque. Todos são repetitivos e ligados a um evento claro do sistema. Escolha de três a quatro marcos que o cliente reconhece, como confirmado, faturado, despachado e entregue. Notificar cada mudança interna de situação irrita o cliente e derruba a qualidade do número.

Preciso de modelo aprovado para mandar status de pedido pelo WhatsApp?

Sim, sempre que a mensagem sair fora da janela de 24 horas contada a partir da última mensagem do cliente. Avisos de pedido, nota e cobrança se encaixam na categoria utilidade, que trata de uma transação já existente. Se o texto misturar a informação com oferta ou promoção, a Meta pode reclassificar o modelo como marketing, o que muda as regras de consentimento e de custo.

Por que a integração cria contatos duplicados?

Quase sempre por formato de telefone. O mesmo cliente é gravado como +55 48 99999-9999 em um sistema e 5548999999999 em outro, e os dois lados deixam de se reconhecer. Padronize a gravação em apenas dígitos com código do país e trate a diferença entre celulares de oito e nove dígitos após o DDD, comum em cadastro antigo. Limpeza periódica remedia, mas não resolve a causa.

Vale a pena desenvolver a integração em vez de contratar uma pronta?

Vale quando a regra de negócio não cabe em conector pronto, quando o ERP é legado ou interno, ou quando o volume torna o custo da plataforma maior que o da manutenção. Em troca, é preciso tratar desde o início idempotência de webhook, ordem de eventos, fila de reprocessamento, controle da janela de 24 horas e registro de auditoria. Sem esses cinco itens, a integração falha em silêncio.

Continue lendo

Histórico de revisões

2026-07-27 · v1.0 · publicação inicial.

Sobre as marcas mencionadas

Este portal cita marcas de terceiros para fins editoriais e comparativos. Todas as marcas são propriedade de seus respectivos donos e não possuem vínculo formal com este site. Os dados apresentados foram coletados de fontes públicas e podem mudar. Em caso de erro factual, escreva para contato@botaihub.com.br.