DocumentaciónWorkflowsActivadores
Webhook nodo
Inicia el workflow cuando llega una petición HTTP a tu URL de webhook. El body, los headers, los parámetros de query y los parámetros de ruta se pasan como output, perfecto para integraciones con Zapier, Make, botones de Slack o tus propias apps. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
11 min de lecturaActualizado el
Qué hace este nodo
Inicia el workflow cuando llega una petición HTTP a tu URL de webhook. El body, los headers, los parámetros de query y los parámetros de ruta se pasan como output, perfecto para integraciones con Zapier, Make, botones de Slack o tus propias apps.
Usa Webhook como un paso claramente definido en un workflow de anymize.
- Inicia una nueva ejecución del workflow.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade Webhook desde el catálogo de nodos.
- 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 04Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
Webhook tiene una función concreta. Sus ajustes aparecen al seleccionar el nodo.
Ajustes
| Campo | Significado | Área |
|---|---|---|
| Formato de importación | Configura este valor en el panel del nodo. | Estándar |
| Versión de importación | Configura este valor en el panel del nodo. | Estándar |
| Respuesta a la app emisora | Esta respuesta confirma la recepción. Los pasos siguientes continúan después. | Estándar |
| Texto de respuesta | Configura este valor en el panel del nodo. | Estándar |
| ¿Qué campos envía tu webhook? | Ejemplos: email, name, amount. Cada campo se convierte en su propio output, así puedes arrastrarlo directamente a otros nodos, sin pelearte con JSON. | Estándar |
| URL del webhook | Configura este valor en el panel del nodo. | Protegido |
| API-Key | Se genera automáticamente. Las peticiones deben enviar la key en el header `X-Anymize-Api-Key` o como `Authorization: Bearer <key>`. | Protegido |
| Método HTTP | Opciones: GET, POST, PUT, PATCH, DELETE, HEAD, Todos (ANY) | Estándar |
| Sufijo de URL propio (opcional) | Se añade al final de tu URL de webhook, p. ej. /cliente/detalles. Si escribes /:name, el valor llegará después como un campo en ese punto de tu workflow. | Estándar |
| Autenticación | Recomendado: API-Key. Cámbiala solo si quien llama usa otro método. | Estándar |
| Credenciales desde un secreto del workflow | Elige un secreto del workflow que contenga la contraseña, el valor del encabezado o la clave de firma JWT. En el workflow solo se guarda el nombre del secreto. | Protegido |
| Usuario | Configura este valor en el panel del nodo. | Estándar |
| Nombre del encabezado | Configura este valor en el panel del nodo. | Estándar |
| Algoritmos JWT permitidos | Lista de algoritmos HMAC permitidos, separados por comas. La clave de firma procede del secreto del workflow. | Estándar |
| Modo de respuesta | Opciones: De inmediato (200 OK), Cuando el último paso termine, Bloque de respuesta de webhook propio al final | Estándar |
| Código de estado de la respuesta | Configura este valor en el panel del nodo. | Estándar |
| Datos de la respuesta | Opciones: Todas las entradas, Primera entrada (JSON), Primera entrada (archivo), Sin body | Estándar |
| ¿Qué campo devolver? | Solo si Datos de la respuesta está en "Primera entrada": indica aquí el nombre del campo cuyo valor se devuelve solo (en vez del objeto entero). | Estándar |
| Formato de la respuesta | Opciones: JSON, Texto, HTML, XML | Estándar |
| Headers de la respuesta | Configura este valor en el panel del nodo. | Estándar |
| Webs permitidas (opcional) | ¿Desde qué webs puede el navegador llamar a este webhook? Separa varias con coma, * permite todas. | Estándar |
| Solo estas direcciones de origen (opcional) | Permite peticiones solo desde ciertas direcciones IP. Separa varias con coma, también valen rangos enteros (p. ej. 10.0.0.0/8). Vacío = todos los orígenes permitidos. | Estándar |
| Ignorar bots y crawlers de vista previa de enlaces | Configura este valor en el panel del nodo. | Estándar |
| Pasar el contenido sin modificar | Actívalo si el body no es JSON (p. ej. texto plano o XML), entonces no se descompone, sino que se pasa en bruto. | Estándar |
| Nombre del campo de archivo (para subidas de archivos) | Solo para subidas de archivos/binarios: si pones aquí un nombre, el archivo subido aparecerá bajo este campo en tu workflow. | Estándar |
| Verificar la firma de la petición | Para servicios que firman sus peticiones criptográficamente (p. ej. Stripe, GitHub). Actívalo si tu emisor envía una firma. | Estándar |
| Secreto de firma | Elige el secreto del workflow que contiene la clave compartida con la que el emisor firma la petición. | Protegido |
| Nombre del header de firma | En qué header HTTP envía tu emisor la firma. El estándar es X-Signature, cámbialo solo si tu servicio usa otro nombre. | Estándar |
| Método de firma | Qué método usa tu emisor para firmar (consta en su documentación de webhook). En caso de duda, SHA-256. | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| Estándar | Este activador no necesita entrada. | JSON |
| Salida | Significado | Tipo |
|---|---|---|
| body | El body JSON parseado de la petición. | json |
| headers | Todos los headers HTTP. | json |
| query | Parámetros de query (?foo=bar). | json |
| params | Parámetros de ruta de /:userId/details. | json |
| method | Método HTTP de la petición. | text |
Ejemplo y prueba
Body de ejemplo: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"event": "signup",
"user": {
"id": "usr_abc123",
"email": "max.mustermann@example.com",
"name": "Max Mustermann"
},
"source": "landing-page"
}Acceso y seguridad
Antes de activarlo, revisa los datos que entran en este paso y el contenido de la salida.
Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
- El workflow no se inicia: actívalo y revisa el modo del activador.