- Los mismos nombres y propiedades en todos los eventos hacen que los flows y
los mensajes sean predecibles:
{{event.order_number}}funciona igual enorder_shippedy enorder_delivered. - Un evento con un nombre del catálogo nace con la naturaleza indicada en
la tabla (
utilityomarketing), devuelta enGET /v1/event-types. - Algunos eventos tienen un flow listo en las recetas de Bevits: Pedido
enviado para
order_shipped(leetracking_code,tracking_urlycarrier), Pix generado parapix_generated(leepix_codeyorder_url, recuerda al cliente 15 minutos después y se detiene cuando llegapayment_confirmedcon el mismoorder_number) y Puntos por vencer parapoints_expiring(leepoints).
Propiedades comunes
Usa estas propiedades, con el mismo nombre, en todos los eventos en los que tengan sentido:
En los eventos sobre un producto,
product es un objeto con sku, name,
price_in_cents, image_url, url y category.
Catálogo
En la API, la naturaleza aparece como
utility (utilidad) o marketing. Los
eventos sin naturaleza (review_submitted, nps_answered) normalmente no
generan un mensaje: sirven para registrar la respuesta del cliente.
Las fechas y horas van como texto en ISO 8601 (2026-11-22 o
2026-11-22T14:00:00-03:00). Los valores monetarios van en centavos.
Tres reglas
1. Naturaleza del evento
Utilidad es un evento sobre algo que el cliente ya hizo: un pedido, un pago, una entrega. Marketing es un evento que se usa para vender, comoback_in_stock o coupon_issued, y el mensaje que genera exige el
consentimiento del cliente.
La naturaleza es una propiedad del tipo de evento. Los nombres del catálogo
nacen con la naturaleza de la tabla; un nombre fuera del catálogo nace sin
naturaleza y sigue la regla de marketing. La naturaleza se puede cambiar en
Configuración → Eventos. Un evento de utilidad alcanza a quien nunca aceptó
marketing, pero no a quien pidió darse de baja; en WhatsApp oficial, la
plantilla también debe ser de utilidad. Detalles en
Quién recibe los mensajes del flow.
2. Los eventos de producto se envían por cliente
back_in_stock y price_dropped le ocurren a un producto, pero la API vincula
cada evento a un cliente. Envía un evento por cada cliente interesado, usando
el envío por lote.
3. Fuera del catálogo a propósito
El restablecimiento de contraseña y los códigos de verificación no están en el catálogo. Son mensajes críticos en tiempo y no pertenecen a un flow de marketing.Si tu tienda no tiene integración nativa
Las integraciones nativas de Bevits ya generan los eventos de pedido creado, pagado, enviado y cancelado, de carrito abandonado y de cliente nuevo. Si envías esos hechos por la API porque no usas una integración nativa, usa los nombres del catálogo:order_placed, payment_confirmed, order_shipped,
order_cancelled, checkout_started y account_created.