El pedido, el carrito, el pago, el envío, la cancelación o el registro se realizan en el sistema de origen.
API de eventos
Envía eventos de tu tienda o ERP para activar automatizaciones en WhatsApp.
Use la Events API cuando su propio sistema necesite informar carrito, pedido, pago, envío, cancelación o creación de cliente a WPP Marketing.
La Events API recibe el evento comercial y utiliza las automatizaciones configuradas. Para enviar un mensaje directamente, use la Messaging API. Para rastrear entrega, lecturas y errores, use el webhooks de estado.
Flujo
Tu sistema informa el evento. WPP Marketing decide la automatización.
La Events API es ideal para tiendas personalizadas, ERPs, back offices e integraciones que no disponen de un conector plug-and-play.
Tu backend envía el evento con token, identificador, cliente, valores y enlaces disponibles.
WPP Marketing verifica si existe una automatización activa para ese evento y cliente.
El cliente recibe mensajes de WhatsApp de recuperación, pago, pedido, envío, campaña o posventa.
Eventos comerciales compatibles.
La nomenclatura final y los campos obligatorios deben seguir la documentación de la Events API.
POST
cart.created
Registra la intención de compra y permite automatizaciones de seguimiento inicial.
Carrinho
POST
cart.abandoned
Activa recuperación de carrito con recordatorio y enlace de retorno cuando esté disponible.
Recuperação
POST
order.created
Informa pedido creado o en espera de pago para mensajes transaccionales.
Pedido
POST
order.paid
Confirma el pago y permite un mensaje de confirmación, instrucciones y próximos pasos.
Pagamento
POST
order.shipped
Envía actualizaciones de envío, seguimiento o estado logístico para reducir tickets manuales.
Envio
POST
order.cancelled
Registra la cancelación del pedido para activar la comunicación configurada para este evento.
Cancelamento
POST
customer.created
Alimenta la base de contactos para bienvenidas, gestión de relaciones, etiquetas y campañas.
Cliente
Datos recomendados
Cuanto mejor el evento, mejor la automatización.
La Events API debe recibir datos suficientes para identificar al cliente, la compra, el importe, el estado y enlaces útiles para el mensaje.
Teléfono, nombre, correo electrónico, país e identificador externo ayudan con la deduplicación y la segmentación.
Número, ID externo, total, moneda, estado, método de pago e artículos hacen el mensaje más útil.
La página de pago, checkout, seguimiento o del pedido puede usarse en mensajes automáticos.
Proporcione external_id u order.id y mantenga la fuente estable. La deduplicación considera la cuenta, la fuente normalizada, el tipo de evento y el identificador externo. Los eventos repetidos devuelven HTTP 200 con la indicación Duplicate event ignored. Este endpoint no utiliza el encabezado Idempotency-Key de la Messaging API.
HTTP 200 confirma que el evento fue procesado, no que un mensaje se haya entregado. El envío requiere una automatización activa para el evento, datos de cliente válidos y una conexión configurada. Realice el seguimiento del mensaje mediante informes y webhooks de estado.
Crea una credencial con events:write y envía eventos desde el servidor. Mantén el token fuera del frontend y de repositorios públicos. Usa customer.phone para el teléfono y los objetos customer y order según el ejemplo y el contrato OpenAPI.
¿Deseas conectar una tienda personalizada o un ERP?
Abra la documentación de la Events API para validar payloads, autenticación y ejemplos antes de enviar eventos en producción.