Integração WhatsApp CRM ERP: arquitetura completa da API ao backend

Integração WhatsApp CRM ERP: arquitetura completa para conectar a WhatsApp Business API ao Salesforce, SAP e Protheus com eventos confiáveis e sem perda.

Por CCX Company6 de julho de 20266 min de leitura
Integração WhatsApp CRM ERP: arquitetura completa da API ao backend

A integração entre WhatsApp Business API, CRM e ERP consiste em conectar a plataforma de mensagens ao seu sistema de relacionamento (Salesforce, por exemplo) e ao seu backend transacional (SAP S/4HANA, TOTVS Protheus) por meio de uma camada de integração assíncrona baseada em eventos. Na prática, isso significa que uma conversa no WhatsApp vira um lead ou caso no CRM, e um pedido confirmado no ERP dispara uma notificação de status no WhatsApp, tudo com rastreabilidade e sem perda de mensagens. O ponto crítico não é o conector em si, mas a arquitetura de confiabilidade que garante que nenhum evento se perca nem seja processado duas vezes.

Por que não basta um conector pronto

Plugins prontos resolvem o caminho feliz: enviar uma mensagem, receber uma resposta. O problema aparece na escala enterprise, quando o volume de webhooks do WhatsApp cresce, o ERP fica indisponível por manutenção ou a rede oscila. Sem uma camada de integração desenhada para falhas, você acumula pedidos duplicados, clientes recebendo a mesma notificação três vezes e leads que simplesmente somem entre o CRM e o backend.

Integração enterprise é sobre o que acontece quando algo dá errado. WhatsApp Business API, CRM e ERP têm modelos de consistência, latências e janelas de disponibilidade diferentes. A arquitetura precisa absorver essas diferenças sem propagar erro para o cliente final.

Arquitetura de referência: os três planos

Estruturamos a integração em três planos que operam de forma independente e resiliente:

  • Ingestão (WhatsApp para dentro): os webhooks da WhatsApp Business API chegam a um endpoint que valida a assinatura, responde rápido e publica o evento em um broker (Kafka ou RabbitMQ). O processamento pesado acontece de forma assíncrona, nunca no ciclo de request do webhook.
  • Orquestração (o meio): a camada de integração — SAP CPI/BTP Integration Suite ou MuleSoft Anypoint no modelo API-led — roteia, transforma e enriquece o evento, decidindo se ele vira um caso no CRM, um pedido no ERP ou ambos.
  • Egress (de dentro para o WhatsApp): mudanças de estado no ERP (pedido faturado, nota emitida) e no CRM disparam mensagens de saída via CCX Message, nossa plataforma de WhatsApp Business API, usando templates aprovados.

Cada plano fala com o outro por eventos, não por chamadas síncronas encadeadas. Isso evita que a lentidão do ERP trave a recepção de mensagens do cliente.

Os padrões de confiabilidade que não podem faltar

A diferença entre uma integração que sobrevive à produção e uma que gera incidentes está em um conjunto de padrões de engenharia. Aplicamos:

  • Idempotência: cada evento carrega uma chave única (message id do WhatsApp, número do pedido no ERP). Reprocessar o mesmo evento não cria duplicidade.
  • Retry com backoff exponencial: quando o CRM ou o ERP recusa temporariamente, a tentativa é reagendada com intervalo crescente, sem enxurrada de chamadas.
  • Dead Letter Queue (DLQ): eventos que falham após todas as tentativas vão para uma fila separada para inspeção, sem bloquear o fluxo saudável.
  • Outbox pattern: a escrita no banco e a publicação do evento acontecem na mesma transação, eliminando o risco de gravar o pedido e perder a notificação.
  • Reconciliação: um processo periódico compara o estado do WhatsApp, do CRM e do ERP e corrige divergências, porque em sistemas distribuídos a diferença sempre aparece.

Aprofundamos a lógica desses mecanismos no artigo sobre APIs enterprise: idempotência, DLQ e versionamento explicados para o negócio, que vale a leitura para quem vai patrocinar o projeto internamente.

Como a CCX conduz a integração

Somos Meta Business Solution Provider e temos CCX Message como plataforma própria de WhatsApp Business API, além de parceria SAP Build, Salesforce Commerce e VTEX Premium. Isso significa que dominamos tanto a ponta da mensagem quanto os dois backends onde ela precisa aterrissar. Já entregamos mais de 200 projetos e integrações enterprise no Brasil e na LATAM, e a integração de mensageria com CRM e ERP segue nossa disciplina de engenharia de integração — Kafka/RabbitMQ, SAP CPI/BTP, MuleSoft Anypoint API-led e TOTVS Protheus via REST/WS.

Nosso processo típico segue etapas claras:

  1. Diagnóstico gratuito de 60 minutos para mapear volumes, sistemas envolvidos e casos de uso (atendimento, notificação transacional, recuperação de venda).
  2. Desenho da arquitetura de eventos e definição de contratos de API, chaves de idempotência e templates de mensagem a serem aprovados na Meta.
  3. Implementação da camada de ingestão de webhooks com broker e Outbox pattern, isolando o processamento do ciclo de request.
  4. Construção da orquestração no CPI/BTP ou MuleSoft, com transformação, roteamento para CRM/ERP e tratamento de erros com retry e DLQ.
  5. Integração do egress com CCX Message para disparos transacionais a partir de eventos do Protheus, S/4HANA ou do CRM.
  6. Testes de resiliência (indisponibilidade simulada, reprocessamento, carga), reconciliação e go-live acompanhado.
  7. Sustentação em modelo AMS, com SLA, monitoramento das filas e evolução contínua.

Você recebe um plano por fases com TCO e cronograma em até 7 dias após o diagnóstico. Essa abordagem faz parte da nossa prática de integração de sistemas da CCX, que conecta e-commerce, CRM, ERP e mensageria sob uma mesma governança.

Quanto custa e do que depende

Sendo honesto: o custo depende de escopo. O que move o número é a quantidade de sistemas integrados, o volume de mensagens, a complexidade das transformações e o nível de SLA da sustentação. Uma integração pontual WhatsApp mais CRM é bem diferente de um fluxo transacional completo com S/4HANA ou Protheus e reconciliação diária.

Para referência de faixa em projetos maiores, squads dedicados começam a partir de R$ 35 mil por mês, e programas que envolvem plataformas Salesforce Commerce partem de R$ 250 mil, com licenças de fabricante (Salesforce, SAP) cobradas à parte. Ambientes SAP Commerce enterprise costumam ficar entre R$ 1,5 e 6 milhões por ano somando licença, infra e sustentação. Números finais só depois do diagnóstico.

Perguntas frequentes

É possível integrar o WhatsApp direto no ERP sem um CRM no meio?

Sim. O WhatsApp pode disparar e receber eventos transacionais diretamente do ERP, por exemplo notificações de pedido e nota fiscal a partir do Protheus ou do S/4HANA. O CRM entra quando você também quer gestão de relacionamento, atendimento e histórico de conversa. A arquitetura de eventos suporta os dois cenários sem retrabalho.

Como a integração evita mensagens e pedidos duplicados?

Pelo uso combinado de idempotência e Outbox pattern. Cada evento carrega uma chave única, então reprocessar não gera duplicidade, e a publicação do evento acontece na mesma transação da gravação no banco. Falhas persistentes vão para uma Dead Letter Queue para análise, sem impactar o cliente final.

Em quanto tempo recebo uma estimativa de custo e prazo?

Após o diagnóstico gratuito de 60 minutos, entregamos em até 7 dias um plano por fases com TCO e cronograma. Você pode falar com a CCX pelo WhatsApp +55 11 96140-1372 ou pela página de contato para agendar. A estimativa considera seus sistemas reais, volumes e nível de SLA desejado.

Receba os próximos Insights por e-mail

No máximo um e-mail por semana, com os artigos novos. Sem spam.

Ao assinar, você concorda em receber os Insights da CCX por e-mail, conforme a Política de Privacidade e a LGPD. Sem spam; cancele quando quiser, em qualquer e-mail.

Leve a discussão para a sua operação.

Trinta minutos com um engenheiro da CCX, sem custo, para entender seu cenário de plataforma, integrações e dados.