Elegir un Trigger
Un trigger (disparador) es el pistoletazo de salida de tu automatización: el momento que le indica que debe empezar. Igual que pones una alarma para despertarte, esperas el timbre para abrir la puerta o presionas play cuando estás listo, tu automatización puede iniciarse con un temporizador, cuando otra aplicación le envía novedades o cuando presionas un botón. Antes de elegir un tipo de trigger, la única pregunta que importa es: ¿cuándo quieres que se ejecute tu automatización?
¿Qué trigger necesito?
| Quiero que mi automatización... | Usa | Ejemplo |
|---|---|---|
| Se ejecute cada día, semana o mes a una hora específica | Schedule (Horario) | "Resumir mi bandeja de entrada cada mañana a las 9 AM" |
| Se ejecute cada pocas horas para revisar novedades | Schedule (Horario) | "Monitorear los precios de la competencia cada 2 horas" |
| Se ejecute automáticamente cuando pasa algo en otra aplicación | Webhook | "Procesar un nuevo pago de Stripe" |
| Se ejecute cuando un cliente llena un formulario o se registra | Webhook | "Calificar un prospecto enviado por Typeform" |
| Se ejecute solo cuando yo decida, bajo demanda | Manual | "Generar un informe a partir de este lote de datos" |
| Se ejecute una vez para una tarea específica que necesito ahora | Manual | "Analizar estas notas de reunión" |
Schedule — "ejecutar con un temporizador"
Un trigger de horario ejecuta tu automatización a las horas que tú definas, como un despertador que activa a tu equipo de IA de forma recurrente.
Image: Panel de configuración del horario mostrando el selector de días, el selector de hora y las opciones de frecuencia
Configurar un horario
- Selecciona Schedule como tipo de trigger.
- Elige la frecuencia: diaria, días específicos de la semana o mensual.
- Define la hora a la que quieres que se ejecute.
- Revisa las próximas 5 ejecuciones para confirmar que se ve correcto.
Image: Vista previa de próximas ejecuciones mostrando las siguientes 5 horas programadas
Horarios comunes
| Horario | Ideal para |
|---|---|
| Cada día a las 9:00 AM | Informes matutinos, resúmenes de bandeja de entrada, monitoreo diario |
| Cada lunes a las 8:00 AM | Resúmenes semanales, recapitulaciones de desempeño |
| Cada hora | Monitoreo de alta frecuencia, seguimiento de redes sociales |
| El primero de cada mes | Analíticas mensuales, resúmenes de facturación |
Todos los horarios usan tu zona horaria, así que "9 AM" significa las 9 AM donde tú estás, no donde están las computadoras de Nirvai.
Webhook — "ejecutar cuando otra aplicación envía datos"
Un webhook es el aviso automático que otra aplicación le envía a Nirvai en el momento en que pasa algo, como un timbre que suena cuando alguien llega a tu puerta.
En términos simples: Nirvai te da una dirección web única (una URL), tú la pegas en otra aplicación (como Stripe, Shopify o un creador de formularios) y, cada vez que esa aplicación tiene información nueva, la envía a tu dirección y tu automatización se ejecuta sola.
Image: Copiar la URL del webhook generada y la clave de acceso
Configurar un webhook
- Selecciona Webhook como tipo de trigger.
- Nirvai genera una URL única y una clave de acceso (una contraseña privada que permite que la otra aplicación llegue a tu automatización).
- Copia la URL y pégala en los ajustes de webhook de la otra aplicación.
- Agrega la clave de acceso donde la otra aplicación pide un encabezado llamado
X-FLOW-API-KEY. (Un encabezado es solo una pequeña etiqueta que la aplicación envía junto con los datos para que Nirvai sepa que la solicitud está permitida.) - Envía una solicitud de prueba desde la otra aplicación para confirmar que la conexión funciona.
Cómo fluyen los datos del webhook
La información enviada por la otra aplicación se convierte en la entrada inicial de tu primer paso de agente. Tu agente puede leer y trabajar con esa información como parte de sus instrucciones.
Fuentes comunes de webhook
| Servicio | Qué lo activa |
|---|---|
| Stripe | Se completa un pago, se crea una suscripción |
| Shopify | Se realiza un nuevo pedido, cambia el inventario |
| Typeform / Google Forms | Se envía una respuesta de formulario |
| GitHub | Se abre un nuevo issue, se fusiona un cambio de código |
| Zapier / Make | Cualquier disparador de miles de aplicaciones conectadas |
Tu URL de webhook viene con una clave de acceso por seguridad. Solo se aceptan las solicitudes que incluyen el encabezado X-FLOW-API-KEY correcto; todo lo demás se rechaza.
Probar tu webhook
Puedes enviar información de muestra a tu webhook para asegurarte de que todo funciona antes de conectar la aplicación real:
- Abre los ajustes de trigger de tu automatización.
- Usa el panel de datos de prueba para enviar una muestra de la información que enviaría la aplicación.
- Observa cómo la automatización se ejecuta con tus datos de prueba.
- Ajusta las instrucciones de tu agente según cómo viene estructurada esa información.
Image: Enviar datos de prueba a un trigger de webhook
Manual — "ejecutar cuando presiono un botón"
Un trigger manual ejecuta tu automatización solo cuando tú la inicias: sin temporizador, sin eventos externos, solo un botón que presionas cuando estás listo.
Image: El botón Ejecutar en una tarjeta de automatización manual
Cuándo usar manual
- Tareas puntuales — "Analizar este documento que acabo de subir."
- Procesamiento por lotes — "Procesar todos los prospectos que recopilé esta semana."
- Informes bajo demanda — "Generar un resumen de los datos de este trimestre."
- Probar ideas — Quieres ejecutar un proceso unas cuantas veces antes de comprometerte con un horario.
Ejecutar una automatización manual
- Ve a la página de Automatizaciones.
- Encuentra la tarjeta de tu automatización.
- Haz clic en el botón Ejecutar.
- La automatización se ejecuta de inmediato y puedes seguir el progreso en la Vista en Vivo.
Cambiar tu trigger más adelante
Puedes cambiar el tipo de trigger después de crear una automatización. Abre la automatización en el editor, ve a los ajustes de trigger y cambia a un tipo diferente. Tus pasos y agentes se mantienen igual; solo cambia la forma en que inicia la automatización.
Si cambias de un trigger Webhook a otro, cualquier aplicación que apunte a la URL anterior del webhook dejará de funcionar. Tendrás que configurar una nueva URL si vuelves a ese tipo.
Solución de problemas
| Problema | Solución |
|---|---|
| Mi automatización programada se ejecutó a la hora equivocada | Los horarios usan tu zona horaria. Verifica que la zona horaria de tu cuenta esté bien configurada y revisa las "próximas 5 ejecuciones" para confirmar. |
| Mi webhook nunca se activa | Asegúrate de que la URL esté pegada correctamente en la otra aplicación y de que la aplicación esté enviando el encabezado X-FLOW-API-KEY con la clave de acceso exacta que te dio Nirvai. |
| La otra aplicación reporta un error al enviar | Lo más probable es que falte la clave de acceso o sea incorrecta. Copia la clave de nuevo desde los ajustes de trigger y vuelve a pegarla. |
| Mi agente no entiende los datos del webhook | Usa el panel de datos de prueba para enviar una muestra, observa cómo viene estructurada la información y ajusta las instrucciones de tu agente para que coincidan. |
| No veo un botón Ejecutar para mi automatización manual | Puede que la automatización aún no esté activada. Actívala primero y el botón Ejecutar aparecerá en su tarjeta. |
Qué sigue
Después de elegir un trigger, continúa con AI Setup y deja que la IA diseñe el resto de tu automatización por ti.