Ir al contenido

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:

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.

  1. Entra a Flow studio y pulsa Crear flujo (o abre uno que ya tengas).
  2. 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.
  3. Haz clic en el nodo y, en Tipo de Trigger, elige Webhook / HTTP.
  4. Agrega los parámetros esperados: por cada dato elige el Origen (Body, Query o Header), el Nombre, el Tipo y si es Requerido. Si falta un parámetro requerido, la petición se rechaza.
  5. Pulsa Guardar. Waiify genera el token y muestra un cURL listo para copiar con la URL de invocación.
  6. Pulsa Publicar. Con el flujo sin publicar, la URL responde 422 «El flow no está activo».
  7. 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.

CampoTipoDescripción
Parámetros esperadosListaLos datos que la petición debe enviar (ver abajo)

Cada parámetro esperado define:

CampoValoresDescripción
OrigenBody · Query · HeaderDónde viene el dato en la petición
NombreTextoClave del parámetro
TipoText · Number · Boolean · JSONTipo esperado
RequeridoSí / NoSi falta y es requerido, la petición se rechaza

Al guardar el flujo como webhook, Waiify genera un token único. La URL de invocación es:

Ventana de terminal
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).

Los parámetros recibidos quedan disponibles como {{trigger.<nombre>}} (o el atajo {{<nombre>}}) en los nodos siguientes.

Configuras dos parámetros de Body: email (Text, requerido) y plan (Text). Luego invocas:

Ventana de terminal
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}}.

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