Categoría: Automatizaciones | ID del artículo: 13909069 | Actualizado: 2026-03-17 | Ver en docs.level.io
Disparador de Webhook
Introducción
El disparador de webhook permite que cualquier sistema externo inicie una automatización de Level mediante una solicitud HTTP. Cuando guarda este disparador, Level genera una URL única. Envíe una solicitud POST a esa URL y la automatización se ejecuta.
Úselo para integrar Level con herramientas que admiten webhooks salientes: plataformas PSA, sistemas de monitoreo, scripts externos o cualquier cosa que pueda realizar una llamada HTTP.
ℹ️ NOTA: Agregar disparadores no manuales requiere estado de administrador o un rol con el permiso Gestionar automatizaciones. Si puede ver la automatización pero no puede agregar disparadores, verifique los permisos de su rol con su administrador. Consulte Espacio de trabajo → Permisos para más detalles.
Disparador de Webhook
Generar la URL del Webhook
La URL del webhook se crea cuando guarda el disparador; no existe antes de eso. Haga clic en Guardar y Level genera un token único vinculado a este disparador.
⚠️ ADVERTENCIA: Eliminar este disparador también elimina el token único. Cualquier sistema externo que apunte a esa URL dejará de funcionar de inmediato. Si necesita regenerar el token, elimine y vuelva a crear el disparador, luego actualice la URL en su sistema externo.
Requerir un Encabezado de Autorización
Marque Requerir un encabezado de autorización para agregar autenticación basada en token al endpoint. Cuando está habilitado, las solicitudes deben incluir la clave de autorización en el encabezado de la solicitud; las solicitudes no autenticadas son rechazadas.
El comando cURL debajo de la URL se actualiza automáticamente para incluir el encabezado -H "Authorization: ..." cuando esta opción está habilitada. Copie el comando cURL completo para usarlo como referencia al configurar su sistema externo.
💡 CONSEJO: Habilite el encabezado de autorización para cualquier endpoint de webhook accesible desde Internet público. Garantiza que solo los sistemas con la clave puedan disparar la automatización.
Mapeo de Parámetros
Asigne claves del payload JSON entrante a variables de automatización para que sus acciones y scripts puedan usar esos datos.
Cada fila de mapeo tiene dos campos:
Clave del parámetro — Un nombre de clave del payload JSON entrante (p. ej.,
device_id,ticket_number)Variables de automatización — El nombre de variable al que se asignará en el pipeline de automatización
Haga clic en + Agregar nuevo parámetro para agregar tantos mapeos como sea necesario. Cada uno crea una variable con nombre que se puede referenciar en acciones y scripts posteriores.
💡 CONSEJO: Asigne cualquier valor que su sistema externo envíe en el payload del webhook: números de tickets, identificadores de clientes, metadatos de dispositivos, lo que sea, y referencíelo en acciones de script o mensajes de notificación más adelante en el pipeline.
Condición
Debe seleccionar una condición para guardar el disparador. Elija Todos los dispositivos o reduzca el alcance para apuntar a dispositivos específicos cuando se dispare el webhook.
Para la referencia completa de condiciones, consulte Condiciones del Disparador.
Opciones Adicionales
Expanda Opciones adicionales para establecer un Nombre del disparador opcional y activar o desactivar el disparador con el interruptor Habilitado.
Nombre del disparador — Reemplaza la etiqueta predeterminada en la tarjeta del disparador del pipeline.
Habilitado — Cuando está desactivado, el disparador no se activará aunque la URL reciba una solicitud válida.
Preguntas Frecuentes
¿Dónde encuentro la URL del webhook después de haber guardado el disparador? Abra la automatización en modo de edición y haga clic en la tarjeta del disparador de webhook. La URL se muestra en la sección de configuración del paso con un botón Copiar.
¿Qué método HTTP espera el webhook? Se aceptan tanto GET como POST.
¿Puedo usar la misma URL de webhook para disparar la automatización múltiples veces? Sí. La URL es persistente mientras exista el disparador. Cualquier solicitud válida a esa URL activa la automatización, siempre que el dispositivo no esté ya en una ejecución activa para este disparador.
¿Qué sucede si el webhook se dispara mientras un dispositivo ya está en una ejecución activa? Un dispositivo solo puede estar en una ejecución activa por disparador a la vez. Si el webhook se dispara nuevamente mientras ese dispositivo ya está en ejecución, la nueva solicitud se ignora para ese dispositivo. Si el dispositivo no está en ejecución actualmente, se activa normalmente.
¿En qué formato debe estar el payload del webhook? JSON. Envíe un cuerpo JSON con las claves que desea asignar a variables de automatización.
¿Quién puede agregar o editar disparadores en una automatización? Los administradores siempre pueden agregar disparadores. Los usuarios no administradores necesitan el permiso Gestionar automatizaciones en su rol, más acceso al grupo de la automatización. Si una automatización no tiene disparadores todavía, cualquier usuario con acceso al grupo puede agregar el primero.