Skip to content
Desarrolladores y API

Registra eventos

Los eventos son lo que hacen tus clientes: “signed_up”, “added_to_cart”, “purchased”. Transmítelos a Climails y se convierten en el combustible de los segmentos, los disparadores de automatización y la atribución de ingresos.

6 min de lectura

Lo que necesitarás

  • Una API key con permiso para escribir eventos
  • Un backend o frontend que pueda hacer POST cuando ocurra algo

Envía un evento

Haz POST a /v1/events con el nombre del evento, a quién pertenece y cualquier propiedad. Identifica al contacto por id, external_id o email.

POST /v1/events
curl https://api.climails.com/v1/events \
  -H "Authorization: Bearer sb_live_<prefix>.<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "purchased",
    "contact": { "email": "[email protected]" },
    "occurred_at": "2026-07-01T10:24:00Z",
    "properties": { "amount": 49.0, "currency": "USD", "plan": "pro" }
  }'

Envía eventos en masa

¿Rellenas datos históricos o agrupas? Haz POST de hasta 1000 eventos a la vez a /v1/events/bulk en lugar de una petición por cada uno.

Pon los eventos a trabajar

  • Segmentos: crea condiciones sobre eventos, p. ej. hizo “purchased” en los últimos 30 días, o lo hizo al menos 3 veces.
  • Automatizaciones: inicia un flujo en el momento en que llega un evento (disparador de evento).
  • Ingresos: adjunta una propiedad amount y la campaña de origen para atribuir ingresos en la analítica.
occurred_at te permite registrar cuándo ocurrió algo realmente, lo que importa para los rellenos históricos y las condiciones de segmento por ventana temporal.

Preguntas frecuentes

¿Cómo identifico al contacto en un evento?

Por id, external_id o email. Si el contacto aún no existe, el evento se asocia igualmente en cuanto se crea con un identificador coincidente.

¿Cuál es el límite en masa?

Hasta 1000 eventos por llamada a /v1/events/bulk.

¿Puedo segmentar por cuántas veces ocurrió un evento?

Sí: las condiciones de evento admiten un operador de recuento y una ventana temporal (p. ej. ≥ 3 veces en los últimos 30 días).

Empieza a enviar en minutos

Crea una cuenta gratuita, conecta tu dominio y llega a tu audiencia en todos los canales, sin tarjeta de crédito.

Plan gratuito para siempre · Sin tarjeta de crédito · Listo en minutos

Registra eventos de cliente con la API para segmentos y automatizaciones — Climails