Datos · Integraciones y fuentes de datos
Buenas prácticas para enviar eventos
Cómo enviar los eventos que generan tus propios sistemas para que los flows empiecen a tiempo, las condiciones coincidan y los segmentos sean fiables: cuándo enviarlos, fechas, un evento por cambio, valores, tipos de evento, un patrón de recordatorio y los errores habituales con lo que cuesta cada uno.
En esta página
- Envía cada evento en cuanto ocurre
- Cada evento con su fecha completa, o sin fecha
- Un evento por cada cambio
- Cada evento pertenece a un contacto
- Valores que un flow puede usar
- Seleccionar el tipo de evento adecuado
- Patrón: un recordatorio antes de una reunión
- Errores habituales y lo que cuestan
- Temas relacionados
Los eventos son lo que hace avanzar un flow: un pago inicia un mensaje de agradecimiento, una reserva inicia un recordatorio y una cancelación lo detiene. Cuando son tus propios sistemas los que envían esos eventos, por API, por webhook o desde una plataforma de automatización como Zapier o Make, cómo los envían decide si el flow reacciona. Un evento que llega tarde, con una fecha sin hora o con un valor escrito de forma distinta a la que espera el flow se guarda igualmente en el contacto, pero el flow lo ignora y nada lo avisa. En esta página se reúnen los hábitos que lo evitan y lo que cuesta cada error.
Envía cada evento en cuanto ocurre
La regla más importante: envía cada evento en cuanto ocurre, y nunca más de 30 minutos después.
Los flows reaccionan a eventos que están ocurriendo ahora. Instasent compara la fecha del evento con el momento en que llega, y un evento demasiado antiguo, o con fecha en el futuro, nunca inicia un flow. No se pierde nada: el evento se guarda en el perfil del contacto y se puede usar en segmentos e informes. Simplemente no dispara nada. Lo mismo se aplica cuando el evento debería terminar un flow, hacer avanzar una Espera de actividad o contar como objetivo: una cancelación que llega tarde no detiene un flow que ya está en marcha.
Enviar en grupos pequeños no es un problema, siempre que cada grupo se envíe a los pocos segundos o minutos de los eventos que lleva. Lo que no funciona es acumular los eventos del día y enviarlos una vez por hora o una vez por noche: para entonces, todos llegan tarde.
Cargar historial es otra tarea, y nunca inicia flows: la primera sincronización de una fuente recién conectada, las importaciones CSV y las importaciones manuales. Qué eventos pueden iniciar un flow y las salvaguardas que hay detrás de esta regla se explican en El disparador: quién entra y cuándo y en Límites y salvaguardas.
Cada evento con su fecha completa, o sin fecha
La fecha de un evento indica cuándo ocurrió. Necesita hora y zona horaria, por ejemplo
2026-11-12T17:42:00+01:00.
- Una fecha sin hora (
2026-11-12) se guarda como medianoche. Casi nunca queda lo bastante cerca del momento en que llega, así que el flow no se inicia y no hay ningún aviso. - Sin fecha significa «ahora». Para eventos enviados en tiempo real es la opción más sencilla y segura.
- El momento en que ocurrió, no el momento para el que está previsto. Cuando alguien reserva una reunión para el martes que viene, la reserva ocurre hoy; el martes es un dato del evento, no su fecha.
Un evento por cada cambio
Un evento es un hecho que ocurrió una vez, y no se puede editar después. Cuando algo cambia, se cancela una reunión o se reembolsa un pago, lo correcto es enviar un evento nuevo que describa el nuevo estado, nunca reenviar el anterior: un evento enviado de nuevo con el mismo identificador se rechaza y el cambio se pierde.
Para que la historia se pueda seguir, cada evento lleva el identificador de aquello de lo que trata, la reunión, el pago o el pedido, y ese identificador es el mismo en todos sus eventos. Así, la reserva, la cancelación y la nueva reserva de la misma reunión se pueden seguir en la actividad del contacto.
Cada evento pertenece a un contacto
Cada evento tiene que indicar a qué contacto pertenece, con el mismo identificador que tus sistemas usan para esa persona cuando envían contactos. Un evento que no se puede asociar a un contacto no se puede usar en flows ni en segmentos.
Valores que un flow puede usar
Los flows y los segmentos filtran por los datos que lleva un evento, como el estado de una reunión o el método de un pago. Esos filtros solo funcionan si los valores son coherentes:
- Sin valores de relleno. «#none», un valor vacío, «-», «N/A» o «null» cuentan como sin valor. Es mejor no enviar ese dato.
- Un único vocabulario, siempre. Un estado se escribe siempre igual: «attended» todos los días, nunca «attended» un día y «Asistió» al siguiente. Una condición del flow coincide con una sola forma de escribirlo.
- Las listas cortas son las que filtran los flows. Estados, categorías, tipos y valores sí/no son lo que usan las condiciones y las ramas. El texto libre y los identificadores son útiles en la actividad del contacto, pero no para filtrar.
Seleccionar el tipo de evento adecuado
Instasent tiene un catálogo de tipos de evento: pagos, pedidos, checkouts, reuniones, deals, leads, citas y más. Un tipo del catálogo trae datos que el panel y los flows ya entienden, así que siempre es la primera opción.
- Acción realizada lleva un nombre de acción libre, como
meeting_reminder, y puede iniciar un flow. Encaja con momentos que decide tu propio sistema, como un recordatorio. - Evento personalizado es para algo que ningún tipo del catálogo describe. También puede iniciar un flow.
- Evento genérico y Métrica / analítica nunca inician un flow. Sirven para informes, no para algo a lo que un flow deba reaccionar.
Patrón: un recordatorio antes de una reunión
Un flow puede esperar un tiempo fijo después de que ocurra algo, de 1 minuto a 90 días, pero no puede esperar hasta una fecha escrita dentro de un evento, como «24 horas antes de la reunión». Una Espera de actividad también cuenta solo los eventos que ocurren después de empezar la espera. Los disparadores programados en los flows llegarán próximamente; mientras tanto, el momento del recordatorio lo marca tu sistema:
La reserva
Cuando se reserva la reunión, tu sistema envía Reunión registrada con el identificador y la fecha de la reunión. Si en tu negocio una reserva encaja mejor como cita, Cita / Reserva es el tipo para la reserva en sí.
El recordatorio
En el momento exacto en que debe salir el recordatorio, por ejemplo 24 horas antes de la reunión, tu sistema envía Acción realizada con la acción
meeting_reminder. El flow se inicia con Acción realizada y la condición acción igual ameeting_reminder, y envía el mensaje al momento.La cancelación
Reunión cancelada se añade al flow como evento de salida, para que una cancelación detenga una ejecución que siga en curso. Cómo funcionan los eventos de salida se explica en Objetivos y salidas.
Reprogramar son tres eventos: Reunión cancelada para la reunión anterior, una nueva Reunión registrada con la nueva fecha y el recordatorio enviado a la nueva hora. Tu sistema también tiene que dejar de enviar el recordatorio previsto para la fecha anterior, porque Instasent no puede saber que ya no corresponde.
Errores habituales y lo que cuestan
| Error | Lo que cuesta |
|---|---|
| Enviar los eventos en lotes cada hora o cada noche | Se guardan, pero ninguno inicia un flow: los mensajes no se envían |
| Una fecha sin hora | Se lee como medianoche, y el flow no se inicia |
| Una fecha sin zona horaria | Se lee con la hora equivocada, y puede que el flow no se inicie |
| Poner como fecha del evento el día para el que algo está previsto | Una fecha futura: no se inicia nada |
| Reenviar un evento para actualizarlo | Se rechaza y el cambio se pierde; el flow nunca se entera |
| Una cancelación que llega tarde | El flow en curso no se detiene, y el contacto puede recibir un recordatorio de una reunión que ya no existe |
| Valores de relleno como «N/A» o «-» | Cuentan como vacíos, así que las condiciones sobre ese dato no coinciden |
| El mismo estado escrito de varias formas | El flow reacciona con unos contactos y no con otros |
| Usar Evento genérico o Métrica / analítica para algo que necesita un flow | El evento nunca inicia un flow |
| Esperar que una importación CSV o una primera sincronización inicie flows | No se inicia nada, por diseño; para llegar una vez a esos contactos, envía una campaña |
La parte técnica de estas reglas, con los formatos exactos, está en Ingest API best practices (en inglés).
Temas relacionados
- API y webhooks: la fuente, sus credenciales y la forma de lo que recibe.
- El disparador: quién entra y cuándo: qué eventos pueden iniciar un flow.
- Límites y salvaguardas: los eventos que nunca inician un flow y por qué.
- Objetivos y salidas: cómo terminan una ejecución los eventos de salida y los objetivos.
Última actualización: