Triggers
Trigger — Webhook
El trigger Webhook inicia el flujo cuando llega una petición HTTP a su URL única. Es la forma de disparar un flujo desde cualquier sistema externo (un formulario, tu backend, otra herramienta).
Este nodo tiene dos sub-tipos, seleccionables en su configuración:
- Webhook / HTTP — se dispara con una petición externa (esta página).
- Programado — se dispara por horario. Ver Trigger programado (se abre en una pestaña nueva).
Para qué sirve
Sección titulada «Para qué sirve»Arrancar un flujo desde cualquier sistema externo: un formulario de tu web, tu propio backend, otra herramienta o un automatizador. El otro sistema llama a una URL tuya con los datos y tu flujo hace el resto.
Cómo configurarlo paso a paso
Sección titulada «Cómo configurarlo paso a paso»- Entra a Flow studio y pulsa Crear flujo (o abre uno que ya tengas).
- En la barra de la izquierda del lienzo pulsa Agregar nodo, abre Triggers y elige Trigger. Si el flujo ya tenía un disparador, el editor pregunta si lo reemplaza: solo puede haber uno por flujo.
- Haz clic en el nodo y, en Tipo de Trigger, elige Webhook / HTTP.
- Agrega los parámetros esperados: por cada dato elige el Origen (
Body,QueryoHeader), el Nombre, el Tipo y si es Requerido. Si falta un parámetro requerido, la petición se rechaza. - Pulsa Guardar. Waiify genera el token y muestra un cURL listo para copiar con la URL de invocación.
- Pulsa Publicar. Con el flujo sin publicar, la URL responde 422 «El flow no está activo».
- Llama a la URL desde el sistema externo (o pega el cURL en una terminal) y revisa el resultado en Ejecuciones. En los nodos siguientes usa los datos como
{{trigger.email}}.
Si el token se filtra, regéneralo desde el mismo panel: el anterior deja de funcionar.
Parámetros
Sección titulada «Parámetros»| Campo | Tipo | Descripción |
|---|---|---|
| Parámetros esperados | Lista | Los datos que la petición debe enviar (ver abajo) |
Cada parámetro esperado define:
| Campo | Valores | Descripción |
|---|---|---|
| Origen | Body · Query · Header | Dónde viene el dato en la petición |
| Nombre | Texto | Clave del parámetro |
| Tipo | Text · Number · Boolean · JSON | Tipo esperado |
| Requerido | Sí / No | Si falta y es requerido, la petición se rechaza |
La URL y el token
Sección titulada «La URL y el token»Al guardar el flujo como webhook, Waiify genera un token único. La URL de invocación es:
POST {API_URL}/flows/run?token=<webhookToken>El editor te muestra un cURL listo para copiar. Puedes regenerar el token si se filtró (invalida el anterior).
Salidas
Sección titulada «Salidas»Los parámetros recibidos quedan disponibles como {{trigger.<nombre>}} (o el atajo {{<nombre>}}) en los nodos siguientes.
Ejemplo
Sección titulada «Ejemplo»Configuras dos parámetros de Body: email (Text, requerido) y plan (Text). Luego invocas:
curl -X POST "https://api.waiify.com/api/flows/run?token=abc123" \ -H "Content-Type: application/json" \ -d '{"email":"ana@empresa.com","plan":"pro"}'En el flujo referencias {{email}} y {{plan}}.
Problemas comunes
Sección titulada «Problemas comunes»- 401 / token inválido — el token cambió (alguien lo regeneró) o falta en la URL.
- Falta un parámetro requerido — revisa el origen (Body vs Query vs Header) y el nombre exacto.
- El dato llega como texto y esperabas número — ajusta el Tipo del parámetro.
