Como Integrar VTEX com WhatsApp Business API: Guia para E-commerce Enterprise
VTEX é a plataforma de e-commerce preferida por varejistas de médio e grande porte no Brasil. Integrar com o WhatsApp Business API permite automatizar notificações de pedido, recuperar carrinhos e criar experiências conversacionais de compra diretamente no canal mais usado pelos consumidores brasileiros.
Arquitetura de integração VTEX e WhatsApp
A VTEX oferece múltiplos pontos de integração que podem acionar automações de WhatsApp: Order Hook para eventos de pedido, Master Data para dados de clientes e Cart para recuperação de carrinho.
A integração mais comum para notificações de pedido usa o Order Hook, que é um webhook configurado para receber eventos de mudança de status de pedido em tempo real.
- Order Hook: webhook de eventos de pedido. Use para confirmação, pagamento, envio e entrega.
- Master Data Triggers: ações automáticas baseadas em dados do cliente. Use para reativação.
- Cart API: acesso a carrinhos abandonados com dados do produto e cliente.
- VTEX IO Apps: apps instalados na sua loja que fazem as chamadas ao WhatsApp.
- Integração via middleware: uma API intermediária (em Node.js, Python, etc.) que recebe os webhooks e aciona o WhatsApp.
Configurando o Order Hook para notificações de WhatsApp
O Order Hook da VTEX dispara um POST para um URL configurado cada vez que um pedido muda de status. Seu middleware recebe esse evento, extrai os dados necessários e aciona o template de WhatsApp correspondente.
- No Admin VTEX, acesse Configurações da Loja > Integrações > Order Hook
- Configure o endpoint do seu middleware como URL de callback
- Defina quais estados de pedido devem disparar o hook (aguardando pagamento, pagamento aprovado, em preparação, enviado, entregue)
- No middleware, mapeie cada status para o template de WhatsApp correspondente
- Use o número de telefone do cliente do Order Hook para o destinatário
- Implemente fila (Redis + BullMQ) para processar os hooks de forma assíncrona
Recuperação de carrinho abandonado na VTEX
A VTEX tem uma API de carrinho (Cart) que permite buscar carrinhos abandonados. Combine com o Master Data para ter o telefone do cliente e acionar o template de WhatsApp.
A estratégia mais eficaz é usar o Master Data Trigger: configure um gatilho que roda periodicamente buscando carrinhos com data de atualização há mais de 30 a 60 minutos sem conversão.
Usando VTEX IO para integração mais limpa
VTEX IO é o framework de desenvolvimento de apps da VTEX. Você pode criar um app VTEX IO que integra com o WhatsApp Business API de forma mais estruturada e mantida como parte do ecossistema da loja.
- Crie um service app no VTEX IO com Node.js
- Use os eventos nativos do VTEX IO para subscribir a mudanças de pedido
- Implemente o cliente do WhatsApp Business API no service
- Deploy na infraestrutura da VTEX: escalabilidade garantida
- Gerenciamento de templates direto no painel da VTEX IO ou via plataforma externa
Integração com plataformas de CRM e atendimento
Para lojas VTEX de médio e grande porte, o atendimento de WhatsApp precisa de uma plataforma robusta com histórico de pedidos integrado, atribuição de atendentes e SLA monitorado.
- Integre a Unnica com a VTEX via Zapier ou webhook para sincronização de pedidos
- Configure a visualização de pedidos VTEX no card do CRM da Unnica
- Use o número do pedido VTEX como identificador nas automações de WhatsApp
- Configure escalada automática para pedidos com reclamação (NPS abaixo de 7)
Considerações de escala e performance
Lojas VTEX de grande porte processam milhares de pedidos por hora em períodos de pico. A integração com WhatsApp precisa ser preparada para esse volume.
- Use fila de processamento assíncrono para não bloquear o Order Hook
- Implemente circuit breaker: se a API do WhatsApp falhar, não faça o Order Hook falhar também
- Guarde log de todas as notificações tentadas e enviadas com referência ao número do pedido
- Monitore a latência: notificação de WhatsApp deve chegar em menos de 2 minutos após o evento
- Respeite os rate limits da Meta: não dispare mais de 80 mensagens por segundo
Perguntas frequentes
VTEX tem alguma integração nativa com WhatsApp?
A VTEX tem parcerias com provedores de WhatsApp Business API no VTEX App Store. Existem apps prontos que oferecem notificações de pedido e chat no site sem desenvolvimento customizado. Para automações mais avançadas, a integração via Order Hook é mais flexível.
É possível integrar sem equipe de desenvolvimento?
Para funcionalidades básicas (botão de WhatsApp no site, notificações simples), sim com apps do VTEX App Store. Para integração completa com Order Hook e recuperação de carrinho, é necessário um desenvolvedor Node.js com experiência em VTEX IO.
O Master Data da VTEX tem o telefone de todos os clientes?
Depende do formulário de cadastro e checkout da sua loja. O telefone precisa ter sido coletado em algum ponto do fluxo. Verifique o schema do seu Master Data. Se o campo não estiver preenchido para muitos clientes, considere uma campanha para atualizar os dados via e-mail.
Como testar a integração sem impactar clientes reais?
Use o ambiente de teste (sandbox) da VTEX para disparar Order Hooks com pedidos de teste. Configure um número de WhatsApp de teste na integração para receber as notificações antes de apontar para produção.
O que fazer com pedidos internacionais na integração?
Para clientes internacionais, verifique se o número de telefone tem o código do país correto. A API do WhatsApp Business suporta múltiplos países. Configure a lógica de formatação do número considerando o DDI de acordo com o endereço de entrega.