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.

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

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

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

Ejemplo

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

curl -X POST "https://api.waiify.com/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

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