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

  1. 01Abre un workflow y añade Webhook desde el catálogo de nodos.
  2. 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
  3. 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
  4. 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

CampoSignificadoÁrea
Formato de importaciónConfigura este valor en el panel del nodo.Estándar
Versión de importaciónConfigura este valor en el panel del nodo.Estándar
Respuesta a la app emisoraEsta respuesta confirma la recepción. Los pasos siguientes continúan después.Estándar
Texto de respuestaConfigura 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 webhookConfigura este valor en el panel del nodo.Protegido
API-KeySe genera automáticamente. Las peticiones deben enviar la key en el header `X-Anymize-Api-Key` o como `Authorization: Bearer <key>`.Protegido
Método HTTPOpciones: 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ónRecomendado: API-Key. Cámbiala solo si quien llama usa otro método.Estándar
Credenciales desde un secreto del workflowElige 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
UsuarioConfigura este valor en el panel del nodo.Estándar
Nombre del encabezadoConfigura este valor en el panel del nodo.Estándar
Algoritmos JWT permitidosLista de algoritmos HMAC permitidos, separados por comas. La clave de firma procede del secreto del workflow.Estándar
Modo de respuestaOpciones: De inmediato (200 OK), Cuando el último paso termine, Bloque de respuesta de webhook propio al finalEstándar
Código de estado de la respuestaConfigura este valor en el panel del nodo.Estándar
Datos de la respuestaOpciones: Todas las entradas, Primera entrada (JSON), Primera entrada (archivo), Sin bodyEstá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 respuestaOpciones: JSON, Texto, HTML, XMLEstándar
Headers de la respuestaConfigura 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 enlacesConfigura este valor en el panel del nodo.Estándar
Pasar el contenido sin modificarActí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ónPara servicios que firman sus peticiones criptográficamente (p. ej. Stripe, GitHub). Actívalo si tu emisor envía una firma.Estándar
Secreto de firmaElige el secreto del workflow que contiene la clave compartida con la que el emisor firma la petición.Protegido
Nombre del header de firmaEn 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 firmaQué 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

EntradaSignificadoTipo
EstándarEste activador no necesita entrada.JSON
SalidaSignificadoTipo
bodyEl body JSON parseado de la petición.json
headersTodos los headers HTTP.json
queryParámetros de query (?foo=bar).json
paramsParámetros de ruta de /:userId/details.json
methodMé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.