Docs
PresentaciónPlataformaPlatform APIA2P Messaging API
IA y MCP
Abrir el panel
PresentaciónPlataformaPlatform APIA2P Messaging API
IA y MCP
Primeros pasos
  • Visión general
  • Guía de inicio
  • Estado del proyecto
  • Conceptos
IA
  • Iris
  • Redacción con IA
  • Conectar tu IA (MCP)
Canales
    • Países y cobertura
    • Alta y registro
    • Fundamentos
    • Países y disponibilidad
    • Qué es RCS
    • Alta y verificación
    • Perfil del agente
    • Buenas prácticas
    • Uso aceptable
    • SMS Fallback
  • WhatsAppSoon
  • Cumplimiento
  • Países
    • Alemania
    • Austria
    • Brasil
    • Canadá
    • Colombia
    • España
      • Autorizar en la CNMC
      • Registro directo
      • Sin certificado
      • Alias rechazado
    • Estados Unidos
    • Francia
    • India
    • Indonesia
    • México
    • Países Bajos
    • Perú
    • Reino Unido
    • Singapur
    • Ucrania
    • Otros países
Marketing
  • Campañas
    • Crear una campaña
    • Segmentación
    • Envíos de prueba
    • Envío
    • Cumplimiento
    • Gestión de campañas
    • Analítica de campañas
  • Flows
    • Crear un flow
    • Plantillas
    • Disparadores y entrada
    • Enviar mensajes
    • Esperas
    • Ramas
    • Actualizar el contacto
    • Objetivos y salidas
    • Versiones y publicación
    • Gestión de flows
    • Seguimiento
    • Analítica
    • Límites
  • Secuencias (heredado)
    • Gestión de secuencias
    • Analítica de secuencias
Datos
  • Audiencia
    • Contactos
    • Tabla de audiencia
    • Segmentos
    • Atributos y eventos
  • Integraciones y fuentes de datos
    • Gestión de fuentes
    • Importar CSV
    • API y webhooks
    • Buenas prácticas de eventos
    • Integraciones
      • Shopify
      • Klaviyo
      • WooCommerce
      • PrestaShop
      • Magento
      • HighLevel
      • Hotmart
      • ActiveCampaign
      • Zoom
      • Facebook Leads
      • Google Sheets
      • Google Contacts
      • MailChimp
      • MailerLite
      • Intercom
      • Make
      • Zapier
      • Activepieces
      • n8n
      • Pabbly Connect
      • OptiMonk
      • Paperform
      • StockAgile
      • Typeform
  • Consentimiento
    • Cómo funciona
    • Atributos de suscripción
    • Consentimiento compartido
    • Bajas
    • Gestión por API
Analítica
  • Audiencia
  • Mensajes
  • Ventas
  • Reportes
Ajustes
  • Ajustes del proyecto
    • Perfil de marca
    • Remitentes
    • Enlaces cortos
    • Enlaces de baja
    • Números de prueba
    • Atribución
    • Memoria del proyecto
  • Desarrolladores y apps
    • Tokens de API
    • Apps de terceros
    • Acceso a datos
    • Apps conectadas
  • Organización
    • General
    • Perfiles legales
    • Equipo
    • Localización
  • Facturación
    • Planes
    • Calculadora de costes
    • Saldo
    • Facturas
    • Precios
    • Cuenta
    • Tema
    • Seguridad
    • Notificaciones
    • Idioma y moneda
PanelSoporteinstasent.com

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:

  1. 1

    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í.

  2. 2

    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 a meeting_reminder, y envía el mensaje al momento.

  3. 3

    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.

Un evento de salida reconoce el tipo de evento y los valores fijados en sus condiciones, no la reunión concreta que inició la ejecución. Un contacto con dos reuniones reservadas que cancela una de ellas sale de todos los flows de recordatorio que escuchan Reunión cancelada, incluido el de la reunión que sigue en pie.

Errores habituales y lo que cuestan

ErrorLo que cuesta
Enviar los eventos en lotes cada hora o cada nocheSe guardan, pero ninguno inicia un flow: los mensajes no se envían
Una fecha sin horaSe lee como medianoche, y el flow no se inicia
Una fecha sin zona horariaSe 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á previstoUna fecha futura: no se inicia nada
Reenviar un evento para actualizarloSe rechaza y el cambio se pierde; el flow nunca se entera
Una cancelación que llega tardeEl 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 formasEl flow reacciona con unos contactos y no con otros
Usar Evento genérico o Métrica / analítica para algo que necesita un flowEl evento nunca inicia un flow
Esperar que una importación CSV o una primera sincronización inicie flowsNo 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: 13 de noviembre de 2026

AnteriorAPI y webhooksSiguienteVisión general
  • 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

© 2026 Instasent

Política de privacidadTérminos y condicionesPolítica de cookiesAviso legal
Todos los sistemas funcionan con normalidad