Introduction
El disparador de webhook permite que cualquier sistema externo dispare una automatización de Level a través de 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 admitan webhooks salientes — plataformas PSA, sistemas de monitoreo, scripts externos o cualquier cosa que pueda hacer una llamada HTTP.
ℹ️ NOTE: Agregar disparadores no manuales requiere estado de administrador o un rol con el Manage automations permiso. Si puede ver la automatización pero no puede agregar disparadores, verifique los permisos de su rol con su administrador. VerWorkspace → Permisos for details.
Webhook Trigger
Generating the Webhook URL
La URL del webhook se crea cuando guarda el disparador — no existe antes. Haga clic en Save y Level genera un token único vinculado a este disparador.
⚠️ WARNING:Eliminar este disparador también elimina el token único. Cualquier sistema externo que apunte a esa URL dejará de funcionar inmediatamente. Si necesita regenerar el token, elimine y recreate el disparador, luego actualice la URL en su sistema externo.
Requiring an Authorization Header
Check Require an authorization header para agregar autenticación basada en token al punto final. Cuando está habilitado, las solicitudes deben incluir la clave de autorización en el encabezado de la solicitud — las solicitudes no autenticadas se rechazan.
El comando cURL debajo de la URL se actualiza automáticamente para incluir el -H "Authorization: ..."encabezado cuando esta opción está habilitada. Copie el comando cURL completo para usarlo como referencia al configurar su sistema externo.
💡 TIP:Habilite el encabezado de autorización para cualquier punto final de webhook que sea accesible desde Internet público. Garantiza que solo los sistemas con la clave puedan disparar la automatización.
Parameter Mapping
Asigne claves de la carga útil JSON entrante a variables de automatización para que sus acciones y scripts puedan usar esos datos.
Each mapping row has two fields:
Parameter key — Un nombre de clave de la carga útil JSON entrante (p. ej.
device_id,ticket_number)Automation variables — El nombre de variable al que asignar en la canalización de automatización
Click + Add new parameter para agregar tantas asignaciones como sea necesario. Cada una crea una variable nombrada que puede ser referenciada en acciones posteriores y scripts.
💡 TIP:Asigne cualquier valor que su sistema externo envíe en la carga útil de webhook — números de ticket, identificadores de cliente, metadatos del dispositivo, cualquier cosa — y consúltelo en acciones de script o mensajes de notificación más adelante en la canalización.
Condition
Debe seleccionar una condición para guardar el disparador. Elija All devices o reduzca el alcance para dirigirse a dispositivos específicos cuando se dispare el webhook.
For the full condition reference, see Trigger Conditions .
Additional Options
Expand Additional options to set an optional Trigger name y cambie el disparador a activado o desactivado con elEnabled switch.
Trigger name — Reemplaza la etiqueta predeterminada en la tarjeta de disparador de canalización.
Enabled— Cuando está desactivado, el disparador no se dispara incluso si la URL recibe una solicitud válida.
FAQ
¿Dónde encuentro la URL del webhook después de haber guardado el disparador? Abra la automatización en modo edición y haga clic en la tarjeta de disparador de webhook. La URL se muestra en la sección Configuración de pasos con unCopy button.
¿Qué método HTTP espera el webhook? GET and POST are both accepted.
¿Puedo usar la misma URL de webhook para disparar la automatización varias veces? Sí. La URL es persistente mientras el disparador exista. Cualquier solicitud válida a esa URL dispara 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 de nuevo mientras ese dispositivo ya se está ejecutando, la nueva solicitud se ignora para ese dispositivo. Si el dispositivo no está actualmente en una ejecución, se dispara normalmente.
¿En qué formato debe estar la carga útil 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 usuarios administradores siempre pueden agregar disparadores. Los usuarios que no son administradores necesitan el Manage automations permiso en su rol, más acceso al grupo de la automatización. Si una automatización no tiene disparadores aún, cualquier usuario con acceso al grupo puede agregar el primero.