Integración de la API de WhatsApp Business: Guía de Comercio Electrónico Brasileño 2026

El e-commerce brasileño se basa en cuatro plataformas dominantes: VTEX (mercado medio y empresarial), Tray (de PYMES a mercado medio), Nuvemshop (PYMES) y Loja Integrada (PYMES). Cada plataforma requiere un patrón de integración específico para conectar la API de WhatsApp Business para la recuperación de carritos abandonados, confirmación de pedidos, actualizaciones de envío, entrega de NF-e y pago Pix dentro de la conversación de WhatsApp. Esta guía detalla la configuración de conectores nativos para las cuatro plataformas brasileñas, además de Shopify Brasil y WooCommerce, con ejemplos de código y mapeo evento por evento.

Respuesta Rápida: ¿Cómo se integra la API de WhatsApp Business con las plataformas de e-commerce brasileñas?

Para las cuatro plataformas de e-commerce brasileñas dominantes, los conectores nativos a través de Message Central WhatsAppNow gestionan la integración de principio a fin: VTEX a través de la aplicación VTEX IO, Tray a través de un puente de webhook REST, Nuvemshop a través de la integración de la App Store y Loja Integrada a través de API directa. El conector recibe eventos de la plataforma (carrito abandonado, pedido creado, pago confirmado, enviado) y activa plantillas de WhatsApp, además de la generación de cargos Pix, según corresponda. La configuración suele tardar de 2 a 5 días hábiles. Para plataformas sin conector nativo (Shopify Brasil, WooCommerce, Magento personalizado), la integración de la API REST con un puente de webhook es el camino estándar, lo que suele implicar de 1 a 2 semanas de trabajo de ingeniería. Consulta nuestra plataforma de API de WhatsApp Business en Brasil.

Las Cuatro Plataformas de E-commerce Brasileñas Relevantes

VTEX

Plataforma de e-commerce de origen brasileño con la mayor presencia en el mercado empresarial y de mercado medio en Brasil. Utilizada por Magazine Luiza, Coca-Cola, Walmart Brasil, Whirlpool y muchas grandes marcas. Construida sobre VTEX IO (una plataforma de desarrollo basada en TypeScript) con capacidad completa de comercio headless. Conector nativo de WhatsApp a través de la aplicación VTEX IO disponible mediante Message Central. Ideal para minoristas brasileños de mercado medio a empresarial.

Tray

Plataforma de e-commerce brasileña propiedad de Locaweb, enfocada en PYMES y mercado medio. Fuerte integración omnicanal con marketplaces (Mercado Livre, Amazon Brasil). API REST para suscripciones de eventos de productos, pedidos y carritos. Conector nativo de WhatsApp a través de Message Central mediante un puente de webhook. Ideal para tiendas online brasileñas de PYMES a mercado medio.

Nuvemshop

Plataforma de e-commerce SaaS enfocada en Latinoamérica (anteriormente Tiendanube), con fuerte presencia en Argentina y Brasil. Ecosistema de App Store con cientos de integraciones nativas. Conector de WhatsApp disponible a través de Message Central como una App de Nuvemshop. Ideal para vendedores pymes latinoamericanos con operaciones en varios países.

Loja Integrada

Plataforma de e-commerce para pymes brasileñas con una sólida estrategia de nivel gratuito. Cientos de miles de tiendas brasileñas activas. API REST para eventos de carrito y pedidos. Integración directa con Message Central. Ideal para pymes y microempresas brasileñas.

Integración con VTEX y la API de WhatsApp Business

Las aplicaciones de VTEX IO son la ruta de integración recomendada para la API de WhatsApp Business. Message Central ofrece una aplicación de VTEX IO publicada que gestiona el flujo de eventos estándar:

• Evento de carrito abandonado (desde la configuración del formulario de pedido): activa una secuencia de recuperación de WhatsApp de 3 toques (1h, 24h, 72h)
• Evento de pedido creado: activa la plantilla de confirmación de pedido a través de la categoría de utilidad de WhatsApp
• Evento de pago confirmado: activa la plantilla de recibo de pago + entrega de NF-e
• Evento de pedido enviado: activa la plantilla de código de seguimiento con estimación de entrega
• Evento de pedido entregado: activa la solicitud de NPS o reseña después de un retraso de 72 horas

Configuración: Ver documentación para desarrolladores de VTEX.

Integración con Tray y la API de WhatsApp Business

Tray utiliza suscripciones de webhook para la integración basada en eventos. Message Central proporciona un puente de webhook que escucha los eventos de Tray y activa la plantilla de WhatsApp adecuada:

• Suscríbase a los webhooks de Tray para: order_created, order_paid, order_shipped, order_delivered, cart_abandoned (si su plan de Tray lo permite)
• Configure el punto final de webhook y el secreto de firma de Message Central en el panel de administración de Tray
• Asigne cada evento a una plantilla en portugués brasileño aprobada por Meta
• Pruebe con pedidos de prueba antes de la puesta en marcha

Tiempo de configuración: 1-2 días hábiles para el mapeo de eventos estándar. Los flujos personalizados (lógica de segmentación específica, disparadores de venta adicional) añaden otros 2-3 días.

Integración de Nuvemshop con la API de WhatsApp Business

Nuvemshop utiliza un modelo de tienda de aplicaciones.

• Instale la aplicación Message Central WhatsApp Now desde la App Store de Nuvemshop
• Otorgue los permisos necesarios (leer pedidos, leer clientes, leer productos, enviar notificaciones)
• Configure la clave API de WhatsApp Business desde el panel de control de Message Central
• Elija qué plantillas en portugués brasileño se activan con qué eventos de Nuvemshop
• Active — puesta en marcha típica en 1-2 días

Para las tiendas Nuvemshop argentinas, mexicanas y colombianas, el mismo conector soporta el enrutamiento de WhatsApp multipaís con identificadores de remitente locales.

Integración de Loja Integrada con la API de WhatsApp Business

Loja Integrada expone una API REST para eventos de pedidos y carritos. Integración con la API de WhatsApp Business de Message Central:

• Genere la clave API de Loja Integrada en el panel de administración
• Configure el conector de Message Central con las credenciales de Loja Integrada
• Asigne los eventos de pedidos/carritos a las plantillas de WhatsApp
• Para carritos abandonados, configure la temporización de la secuencia de recuperación (1h, 24h, 72h)
• Para la confirmación del pedido, adjunte la generación de cobro Pix para pedidos no pagados

Las tiendas Loja Integrada SMB suelen activarse en 1-2 días. Las tiendas de mayor volumen pueden requerir la aprobación de plantillas personalizadas (ciclo de aprobación de Meta de 4 horas a través del pre-filtrado de Message Central).

Integración con Shopify Brasil y WooCommerce

Para empresas brasileñas que usan Shopify o WooCommerce, la integración mediante la API REST es el camino:

Shopify Brasil

Utilice los Webhooks de Shopify para los siguientes eventos: checkouts/create, checkouts/update, orders/create, orders/paid, orders/fulfilled. Configure el endpoint HTTPS en la API de Message Central que recibe y transforma la carga útil de Shopify en el envío de plantillas de WhatsApp. Shopify Brasil admite precios en BRL y se integra con PSP brasileños (Mercado Pago, PagSeguro) para Pix.

WooCommerce

Utilice la API REST de WooCommerce + suscripciones a webhooks. Se requiere un puente de webhook personalizado si no hay un plugin de Message Central para WooCommerce disponible. Trabajo de ingeniería típico: 1-2 semanas.

Mapa de integración evento por evento

Para todas las plataformas, el mapeo estándar de evento a WhatsApp:

Carrito abandonado (1h): Plantilla de marketing, recordatorio suave, sin descuento. Incluye imagen del producto y botón de volver al carrito con un solo toque.

Carrito abandonado (24h): Plantilla de marketing con 5-10% de descuento o envío gratuito. Opción de generación de cobro Pix en la misma conversación.

Carrito abandonado (72h): Plantilla de marketing con un descuento final del 10-15%. Último contacto, no más mensajes después de este para este carrito específico.

Pedido creado (no pagado): Plantilla de utilidad con resumen del pedido y cargo Pix para el pago.

Pago confirmado: Plantilla de utilidad con recibo de pago, número de pedido, fecha de entrega estimada.

NF-e generada: Plantilla de utilidad con archivo PDF de la NF-e adjunto o enlace de descarga.

Pedido enviado: Plantilla de utilidad con nombre del transportista, código de seguimiento, entrega estimada.

Pedido entregado: Categoría de servicio, solicitud de NPS o reseña post-entrega (después de un retraso de 24-72 horas).

Consideraciones sobre la LGPD y la aprobación de plantillas

Cada tipo de evento se asigna a una categoría de conversación de Meta con diferentes requisitos de la LGPD:

• Mensajes de carrito abandonado: categoría de marketing — requieren consentimiento explícito de WhatsApp según la LGPD
• Confirmación de pedido, recibo de pago, envío, NF-e: categoría de utilidad — se rigen por la base legal de ejecución de contrato, no se necesita consentimiento aparte
• Solicitud de NPS/reseña: categoría de servicio si es dentro de las 24 horas, de marketing si es fuera (requiere consentimiento)

Consulta nuestra guía de cumplimiento de la LGPD para WhatsApp Business.

Errores comunes de integración

Error 1: Enviar mensajes de carrito abandonado sin el consentimiento de WhatsApp

‍El consentimiento por correo electrónico no cubre WhatsApp bajo la LGPD. Solución: recopilar el consentimiento de WhatsApp en el proceso de compra (casilla de verificación no marcada previamente).

Error 2: Confundir las categorías de utilidad y marketing

‍Enviar una oferta promocional en una plantilla de utilidad es rechazado por Meta y daña la Calificación de Calidad. Solución: mantener el contenido transaccional en utilidad y el promocional en marketing.

Error 3: Falta de idempotencia en el manejador de webhooks

‍Los reintentos de webhook de VTEX, Tray, Nuvemshop pueden disparar el mismo evento varias veces. Solución: implementar claves de idempotencia.

Error 4: Enviar la NF-e inmediatamente después de la confirmación del pago

‍Pix se liquida en segundos, pero la preparación del pedido podría no haberse registrado aún. Solución: un búfer de 30-60 segundos.

Referencias de Autoridad Externa

Documentación para desarrolladores de VTEX. Documentación de la API de Tray Brasil. Documentación para desarrolladores de Nuvemshop. Documentación de la API de la nube de WhatsApp de Meta. Especificaciones de Pix de BACEN.

Preguntas frecuentes

¿Cuánto tiempo lleva la integración de la API de WhatsApp Business con las plataformas de comercio electrónico brasileñas?

Para las cuatro principales plataformas brasileñas con conectores nativos, la integración suele tardar entre 2 y 5 días hábiles. VTEX a través de la aplicación VTEX IO: 2-3 días. Tray a través de un puente de webhook: 1-2 días. Nuvemshop a través de la App Store: 1-2 días. Loja Integrada a través de la API REST: 1-2 días. Las plataformas sin conector nativo (Shopify Brasil, WooCommerce, Magento personalizado) suelen requerir de 1 a 2 semanas de trabajo de ingeniería.

¿Qué plataformas de comercio electrónico brasileñas admiten la integración nativa de la API de WhatsApp Business?

Las cuatro plataformas brasileñas dominantes todas admiten la integración nativa de la API de WhatsApp Business: VTEX, Tray, Nuvemshop y Loja Integrada. Shopify Brasil y WooCommerce son compatibles mediante la integración de la API REST (se requiere un puente de webhook personalizado). Otras plataformas (Vnda, Linx, compilaciones personalizadas de Magento) pueden integrarse mediante patrones de webhook + API REST.

¿Necesito un consentimiento LGPD separado para los mensajes de carrito abandonado frente a la confirmación de pedido?

Sí para el carrito abandonado, no para la confirmación de pedido. Los mensajes de carrito abandonado son clasificados por Meta como categoría de marketing y por la LGPD como marketing directo, lo que requiere un consentimiento explícito de WhatsApp. La confirmación de pedido, el recibo de pago, la notificación de envío y la entrega de NF-e son categoría de utilidad bajo la base legal de ejecución de contrato, sin requerir un consentimiento separado.

¿Puedo integrar pagos Pix dentro de la conversación de WhatsApp a través de mi plataforma de comercio electrónico?

Sí. Para las cuatro principales plataformas brasileñas, las integraciones de Message Central admiten la generación de cargos Pix dentro de la conversación de WhatsApp. Cuando un cliente responde a un mensaje de carrito abandonado con intención de compra, el conector genera un código QR Pix y un código BR dentro de la conversación. El cliente paga en su aplicación bancaria y la plataforma de comercio electrónico recibe la confirmación de pago a través del webhook del PSP. Consulte nuestro Guía de pagos Pix.

¿Cuál es el esfuerzo de ingeniería típico para la integración de la API de WhatsApp Business con VTEX?

Para VTEX, la integración a través de la aplicación Message Central WhatsApp IO tarda de 2 a 3 días hábiles de principio a fin: instalar la aplicación desde la VTEX App Store, configurar la clave API, mapear eventos a plantillas (carrito abandonado, pedido creado, pago confirmado, enviado, entregado), probar con pedidos de sandbox y entrar en producción. Los flujos personalizados (lógica de segmentación específica, disparadores de upsell, enrutamiento multi-tienda) añaden otros 2-5 días de trabajo de ingeniería.

Próximos pasos

Para integrar la API de WhatsApp Business con tu plataforma de e-commerce brasileña, comienza con la página de la plataforma WhatsApp Business API en Brasil. Para la integración de Pix para cerrar ventas dentro de la conversación, consulta la guía de pagos Pix. Para la estrategia de recuperación de carritos abandonados, consulta la guía de recuperación de carritos. Para los anuncios Click-to-WhatsApp para alimentar tu embudo, consulta la guía de CTWA. Para el cumplimiento de la LGPD, consulta la guía de la LGPD.