Eventos para automatizaciones

POST /events registra un evento externo asociado a un contacto activo del workspace. Requiere events:write e Idempotency-Key.

curl "$SENDIRO_API_BASE/v1/workspaces/$SENDIRO_WORKSPACE_ID/events" \
  -H "Authorization: Bearer $SENDIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: purchase-unique-source-event" \
  --data '{"contactId":"CONTACT_ID","eventName":"purchase.completed","occurredAt":"2026-10-18T15:30:00Z"}'

Define el nombre y el instante

eventName admite entre 1 y 128 caracteres: letras ASCII, números, guion, punto y guion bajo. Usa un nombre estable y configura el mismo nombre en el activador externo de la automatización.

occurredAt es un instante UTC con Z, con precisión máxima de microsegundos. El recibo incluye id, workspaceId, contactId, kind: "custom_event", eventName, occurredAt y acceptedAt.

No se admite un payload arbitrario ni variables externas para personalizar acciones. Si cambió el perfil, actualízalo mediante contactos antes de registrar el evento. Registrar el evento no suscribe ni autoriza un envío.

Comprende cuándo inicia trabajo

Una automatización activa necesita un activador coincidente, inscripción habilitada, capacidad y política de reingreso compatible. Si coinciden varios activadores de esa automatización, el primero en su orden decide el origen del recorrido.

Una espera de evento usa el momento de aceptación: debe aceptarse estrictamente después de registrar la espera y antes de su fecha límite. Un occurredAt antiguo no convierte un evento aceptado tarde en uno recibido a tiempo.

Evita eventos duplicados

Reutiliza la misma clave de idempotencia para el mismo evento de tu sistema. Una clave distinta representa otra operación y puede originar otro evento. El recibo confirma registro; no confirma que un recorrido haya terminado ni que se haya enviado un mensaje.

La administración de automatizaciones y la lectura de sus recorridos requieren sesión humana; no están en la superficie de claves. Los webhooks de correo comunican resultados de mensajes y tienen un catálogo distinto.