Integração da API do WhatsApp Business: Guia de E-commerce Brasileiro 2026

O e-commerce brasileiro opera em quatro plataformas dominantes: VTEX (médias e grandes empresas), Tray (PMEs a médias empresas), Nuvemshop (PMEs) e Loja Integrada (PMEs). Cada plataforma exige um padrão de integração específico para conectar a API do WhatsApp Business para recuperação de carrinho abandonado, confirmação de pedido, atualizações de envio, entrega de NF-e e checkout Pix dentro da conversa do WhatsApp. Este guia detalha a configuração de conectores nativos para todas as quatro plataformas brasileiras, além de Shopify Brasil e WooCommerce, com exemplos de código e mapeamento evento a evento.

Resposta Rápida: Como a API do WhatsApp Business se Integra com Plataformas de E-commerce Brasileiras?

Para as quatro plataformas de e-commerce brasileiras dominantes, conectores nativos através da Message Central WhatsAppNow lidam com a integração de ponta a ponta: VTEX via aplicativo VTEX IO, Tray via ponte de webhook REST, Nuvemshop via integração com a App Store e Loja Integrada via API direta. O conector recebe eventos da plataforma (carrinho abandonado, pedido criado, pagamento confirmado, enviado) e aciona modelos do WhatsApp, além da geração de cobrança Pix, conforme necessário. A configuração geralmente leva de 2 a 5 dias úteis. Para plataformas sem conector nativo (Shopify Brasil, WooCommerce, Magento personalizado), a integração via API REST com ponte de webhook é o caminho padrão — geralmente 1 a 2 semanas de trabalho de engenharia. Veja nossa plataforma da API do WhatsApp Business no Brasil.

As Quatro Plataformas de E-commerce Brasileiras Que Importam

VTEX

Plataforma de e-commerce brasileira com a maior presença no mercado corporativo e de médias empresas no Brasil. Utilizada por Magazine Luiza, Coca-Cola, Walmart Brasil, Whirlpool e muitas grandes marcas. Construída sobre VTEX IO (uma plataforma de desenvolvimento baseada em TypeScript) com capacidade completa de headless commerce. Conector nativo do WhatsApp via aplicativo VTEX IO disponível através da Message Central. Ideal para varejistas brasileiros de médio a grande porte.

Tray

Plataforma de e-commerce brasileira de propriedade da Locaweb, focada em PMEs a médias empresas. Forte integração omnichannel com marketplaces (Mercado Livre, Amazon Brasil). API REST para assinaturas de eventos de produto, pedido e carrinho. Conector nativo do WhatsApp através da Message Central via ponte de webhook. Ideal para lojas online brasileiras de PMEs a médias empresas.

Nuvemshop

Plataforma de e-commerce SaaS focada na América Latina (anteriormente Tiendanube), com forte presença argentina e brasileira. Ecossistema de App Store com centenas de integrações nativas. Conector WhatsApp disponível via Message Central como um App Nuvemshop. Ideal para vendedores PMEs latino-americanos com atuação em múltiplos países.

Loja Integrada

Plataforma brasileira de e-commerce para PMEs com forte estratégia de plano gratuito. Centenas de milhares de lojas brasileiras ativas. API REST para eventos de carrinho e pedidos. Integração direta com Message Central. Ideal para PMEs e microempresas brasileiras.

Integração VTEX com a API do WhatsApp Business

Os apps VTEX IO são o caminho de integração recomendado para a API do WhatsApp Business. O Message Central oferece um app VTEX IO publicado que gerencia o fluxo de eventos padrão:

• Evento de carrinho abandonado (da Configuração do Formulário de Pedido): aciona sequência de recuperação de WhatsApp de 3 toques (1h, 24h, 72h)
• Evento de pedido criado: aciona modelo de confirmação de pedido via categoria de utilidade do WhatsApp
• Evento de pagamento confirmado: aciona recibo de pagamento + modelo de entrega de NF-e
• Evento de pedido enviado: aciona modelo de código de rastreamento com estimativa de entrega
• Evento de pedido entregue: aciona solicitação de NPS ou avaliação após 72 horas

Configuração: Veja documentação para desenvolvedores VTEX.

Integração Tray com a API do WhatsApp Business

O Tray utiliza assinaturas de webhook para integração orientada a eventos. O Message Central oferece uma ponte de webhook que escuta eventos do Tray e aciona o modelo de WhatsApp apropriado:

• Assine os webhooks do Tray para: pedido_criado, pedido_pago, pedido_enviado, pedido_entregue, carrinho_abandonado (onde suportado pelo seu plano Tray)
• Configure o endpoint de webhook e o segredo de assinatura do Message Central no painel administrativo do Tray
• Mapeie cada evento para um modelo em português do Brasil aprovado pelo Meta
• Teste com pedidos de sandbox antes de entrar em produção

Tempo de configuração: 1-2 dias úteis para mapeamento de eventos padrão. Fluxos personalizados (lógica de segmentação específica, gatilhos de upsell) adicionam mais 2-3 dias.

Integração Nuvemshop com a API do WhatsApp Business

A Nuvemshop utiliza um modelo de App Store.

• Instale o aplicativo Message Central WhatsApp Now da App Store da Nuvemshop
• Conceda as permissões necessárias (ler pedidos, ler clientes, ler produtos, enviar notificações)
• Configure a chave da API do WhatsApp Business no painel do Message Central
• Escolha quais modelos em português do Brasil serão acionados em quais eventos da Nuvemshop
• Ative — ativação típica em 1-2 dias

Para lojas Nuvemshop argentinas, mexicanas e colombianas, o mesmo conector suporta roteamento de WhatsApp multi-país com IDs de remetente locais.

Integração Loja Integrada com a API do WhatsApp Business

A Loja Integrada expõe uma API REST para eventos de pedido e carrinho. Integração com a API do WhatsApp Business do Message Central:

• Gere a chave da API da Loja Integrada no painel administrativo
• Configure o conector do Message Central com as credenciais da Loja Integrada
• Mapeie eventos de pedido/carrinho para modelos de WhatsApp
• Para carrinho abandonado, configure o tempo da sequência de recuperação (1h, 24h, 72h)
• Para confirmação de pedido, anexar geração de cobrança Pix para pedidos não pagos

Lojas Loja Integrada SMB geralmente entram no ar em 1-2 dias. Lojas de maior volume podem precisar de aprovação de template personalizado (ciclo de aprovação Meta de 4 horas via pré-seleção do Message Central).

Shopify Brasil e Integração WooCommerce

Para empresas brasileiras no Shopify ou WooCommerce, a integração via REST API é o caminho:

Shopify Brasil

Use os Webhooks do Shopify para os seguintes eventos: checkouts/create, checkouts/update, orders/create, orders/paid, orders/fulfilled. Configure o endpoint HTTPS na API do Message Central que recebe e transforma o payload do Shopify em envio de template do WhatsApp. O Shopify Brasil suporta preços em BRL e se integra com PSPs brasileiros (Mercado Pago, PagSeguro) para Pix.

WooCommerce

Use a REST API do WooCommerce + assinaturas de webhook. Ponte de webhook personalizada necessária se não houver plugin do Message Central para WooCommerce disponível. Trabalho de engenharia típico: 1-2 semanas.

Mapeamento de Integração Evento a Evento

Para todas as plataformas, o mapeamento padrão de evento para WhatsApp:

Carrinho abandonado (1h): Template de marketing, lembrete suave, sem desconto. Inclui imagem do produto e botão de retorno ao carrinho com um toque.

Carrinho abandonado (24h): Template de marketing com 5-10% de desconto ou frete grátis. Opção de geração de cobrança Pix na mesma conversa.

Carrinho abandonado (72h): Template de marketing com desconto final de 10-15%. Último contato, nenhuma outra mensagem após esta para este carrinho específico.

Pedido criado (não pago): Modelo de utilidade com resumo do pedido e cobrança Pix para pagamento.

Pagamento confirmado: Modelo de utilidade com recibo de pagamento, número do pedido, data prevista de entrega.

NF-e gerada: Modelo de utilidade com anexo PDF da NF-e ou link para download.

Pedido enviado: Modelo de utilidade com nome da transportadora, código de rastreamento, previsão de entrega.

Pedido entregue: Categoria de serviço, solicitação de NPS ou avaliação pós-entrega (após um período de 24 a 72 horas).

Considerações sobre LGPD e Aprovação de Modelos

Cada tipo de evento corresponde a uma categoria de conversa do Meta com diferentes requisitos da LGPD:

• Mensagens de carrinho abandonado: categoria de marketing — exigem opt-in explícito no WhatsApp conforme a LGPD
• Confirmação de pedido, recibo de pagamento, envio, NF-e: categoria de utilidade — se enquadram na base legal de execução de contrato, sem necessidade de opt-in separado
• Solicitação de NPS/avaliação: categoria de serviço se dentro da janela de 24 horas, marketing se fora (exige opt-in)

Veja nosso guia de conformidade LGPD para WhatsApp Business.

Erros Comuns de Integração

Erro 1: Enviar mensagens de carrinho abandonado sem opt-in para WhatsApp

‍O opt-in de e-mail não cobre o WhatsApp sob a LGPD. Solução: coletar o opt-in para WhatsApp no checkout (caixa de seleção não pré-marcada).

Erro 2: Confundir categorias de utilidade e marketing

‍Enviar uma oferta promocional em um modelo de utilidade é rejeitado pelo Meta e prejudica a Classificação de Qualidade. Solução: manter conteúdo transacional em utilidade, promocional em marketing.

Erro 3: Ausência de idempotência no manipulador de webhook

‍As novas tentativas de webhook da VTEX, Tray, Nuvemshop podem disparar o mesmo evento várias vezes. Solução: implementar chaves de idempotência.

Erro 4: Enviar NF-e imediatamente após a confirmação do pagamento

‍O Pix é liquidado em segundos, mas o fulfillment pode ainda não ter registrado o pedido. Solução: buffer de 30-60 segundos.

Referências de Autoridade Externa

Documentação para desenvolvedores VTEX. Documentação da API da Tray Brasil. Documentação para desenvolvedores Nuvemshop. Documentação da API Cloud do WhatsApp da Meta. Especificações do Pix do BACEN.

Perguntas Frequentes

Quanto tempo leva a integração da API do WhatsApp Business com plataformas de e-commerce brasileiras?

Para as quatro principais plataformas brasileiras com conectores nativos, a integração geralmente leva de 2 a 5 dias úteis. VTEX via aplicativo VTEX IO: 2-3 dias. Tray via ponte de webhook: 1-2 dias. Nuvemshop via App Store: 1-2 dias. Loja Integrada via API REST: 1-2 dias. Plataformas sem conector nativo (Shopify Brasil, WooCommerce, Magento personalizado) geralmente levam de 1 a 2 semanas de trabalho de engenharia.

Quais plataformas de e-commerce brasileiras suportam a integração nativa da API do WhatsApp Business?

As quatro plataformas brasileiras dominantes suportam todas a integração nativa da API do WhatsApp Business: VTEX, Tray, Nuvemshop e Loja Integrada. Shopify Brasil e WooCommerce são suportados via integração de API REST (requer ponte de webhook personalizada). Outras plataformas (Vnda, Linx, construções personalizadas de Magento) podem integrar via padrões de webhook + API REST.

Preciso de um opt-in LGPD separado para mensagens de carrinho abandonado versus confirmação de pedido?

Sim para carrinho abandonado, não para confirmação de pedido. Mensagens de carrinho abandonado são classificadas pela Meta como categoria de marketing e pela LGPD como marketing direto, exigindo opt-in explícito no WhatsApp. Confirmação de pedido, recibo de pagamento, notificação de envio e entrega de NF-e são categoria de utilidade sob a base legal de execução de contrato, não exigindo opt-in separado.

Posso integrar pagamentos Pix dentro da conversa do WhatsApp através da minha plataforma de e-commerce?

Sim. Para as quatro principais plataformas brasileiras, as integrações do Message Central suportam a geração de cobrança Pix dentro da conversa do WhatsApp. Quando um cliente responde a uma mensagem de carrinho abandonado com intenção de compra, o conector gera um código QR Pix e um BR Code dentro da conversa. O cliente paga em seu aplicativo bancário e a plataforma de e-commerce recebe a confirmação do pagamento via webhook do PSP. Veja nosso Guia de pagamentos Pix.

Qual é o esforço de engenharia típico para a integração da API do WhatsApp Business com a VTEX?

Para a VTEX, a integração via aplicativo Message Central WhatsApp IO leva de 2 a 3 dias úteis do início ao fim: instale o aplicativo da VTEX App Store, configure a chave da API, mapeie evento-para-modelo (carrinho abandonado, pedido criado, pagamento confirmado, enviado, entregue), teste com pedidos de sandbox e entre em operação. Fluxos personalizados (lógica de segmentação específica, gatilhos de upsell, roteamento multi-loja) adicionam mais 2 a 5 dias de trabalho de engenharia.

Próximos Passos

Para integrar a API do WhatsApp Business com sua plataforma de e-commerce brasileira, comece com a página da plataforma WhatsApp Business API no Brasil. Para integração Pix para fechar vendas dentro da conversa, consulte o guia de pagamentos Pix. Para estratégia de recuperação de carrinho abandonado, consulte o guia de recuperação de carrinho. Para anúncios Click-to-WhatsApp para alimentar seu funil, consulte o guia CTWA. Para conformidade com a LGPD, consulte o guia LGPD.