Saltar al contenido principal
La API acepta cualquier nombre de evento que siga el formato (letras minúsculas, números y guiones bajos). Este catálogo es una convención, no una regla: nada de lo que aparece aquí se valida, y puedes enviar eventos y propiedades que no están en la lista. Vale la pena seguir el catálogo por dos motivos:
  • Los mismos nombres y propiedades en todos los eventos hacen que los flows y los mensajes sean predecibles: {{event.order_number}} funciona igual en order_shipped y en order_delivered.
  • Un evento con un nombre del catálogo nace con la naturaleza indicada en la tabla (utility o marketing), devuelta en GET /v1/event-types.
  • Algunos eventos tienen un flow listo en las recetas de Bevits: Pedido enviado para order_shipped (lee tracking_code, tracking_url y carrier), Pix generado para pix_generated (lee pix_code y order_url, recuerda al cliente 15 minutos después y se detiene cuando llega payment_confirmed con el mismo order_number) y Puntos por vencer para points_expiring (lee points).
Consulta cómo enviarlos en Eventos personalizados.

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.
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, como back_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.