Introducción
El activador de webhook permite que cualquier sistema externo ejecute una automatización de Level mediante una solicitud HTTP. Al guardar este activador, Level genera una URL única. Envía una solicitud POST a esa URL y la automatización se ejecutará.
Úsalo para integrar Level con herramientas que admitan webhooks salientes: plataformas PSA, sistemas de monitoreo, scripts externos o cualquier sistema que pueda realizar una llamada HTTP.
ℹ️ NOTA: Para agregar activadores no manuales se requiere ser administrador o tener un rol con el Gestionar automatizaciones permiso. Si puedes ver la automatización pero no puedes agregar activadores, revisa los permisos de tu rol con tu administrador. Consulta Espacio de trabajo → Permisos para más detalles.
Activador de Webhook
Generación de la URL del Webhook
La URL del webhook se crea al guardar el activador; no existe antes de eso. Haz clic en Guardar y Level genera un token único vinculado a este activador.
⚠️ ADVERTENCIA: Al eliminar este activador también se elimina el token único. Cualquier sistema externo que apunte a esa URL dejará de funcionar de inmediato. Si necesitas regenerar el token, elimina y vuelve a crear el activador y, a continuación, actualiza la URL en tu sistema externo.
Requerir un encabezado de autorización
Activa 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 serán rechazadas.
El comando cURL que aparece debajo de la URL se actualiza automáticamente para incluir el encabezado -H "Authorization: ..." cuando esta opción está habilitada. Copia el comando cURL completo para usarlo como referencia al configurar tu sistema externo.
💡 CONSEJO: Habilita el encabezado de autorización para cualquier endpoint de webhook que sea accesible desde internet público. Esto garantiza que solo los sistemas con la clave puedan ejecutar la automatización.
Mapeo de parámetros
Asigna claves del payload JSON entrante a variables de automatización para que tus acciones y scripts puedan usar esos datos.
Cada fila de mapeo tiene dos campos:
Clave de 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
Haz clic en + Agregar nuevo parámetro para agregar tantos mapeos como sea necesario. Cada uno crea una variable con nombre que puede referenciarse en acciones y scripts posteriores.
💡 CONSEJO: Asigna cualquier valor que tu sistema externo envíe en el payload del webhook — números de ticket, identificadores de cliente, metadatos de dispositivo, lo que sea — y referencíalo en acciones de script o mensajes de notificación más adelante en el pipeline.
Condición
Debes seleccionar una condición para guardar el activador. Elige Todos los dispositivos o limita el alcance para apuntar a dispositivos específicos cuando se ejecuta el webhook.
Para la referencia completa de condiciones, consulta Condiciones de activador.
Opciones adicionales
Expande Opciones adicionales para establecer un Nombre del activador y activa o desactiva el activador con el Habilitado interruptor.
Nombre del activador — Reemplaza la etiqueta predeterminada en la tarjeta del activador del pipeline.
Habilitado — Cuando está desactivado, el activador no se ejecutará aunque la URL reciba una solicitud válida.
Preguntas frecuentes
¿Dónde encuentro la URL del webhook después de haber guardado el activador? Abre la automatización en modo de edición y haz clic en la tarjeta del activador de webhook. La URL se muestra en la sección de configuración del paso con un botón Copiar botón.
¿Qué método HTTP espera el webhook? Se aceptan tanto GET como POST.
¿Puedo usar la misma URL de webhook para ejecutar la automatización varias veces? Sí. La URL es persistente mientras el activador exista. Cualquier solicitud válida a esa URL ejecuta la automatización, siempre que el dispositivo no esté ya en una ejecución activa para este activador.
¿Qué ocurre si el webhook se ejecuta mientras un dispositivo ya está en una ejecución activa? Un dispositivo solo puede estar en una ejecución activa por activador a la vez. Si el webhook se ejecuta de nuevo mientras ese dispositivo ya está en ejecución, la nueva solicitud se ignora para ese dispositivo. Si el dispositivo no está en ejecución en ese momento, se ejecuta con normalidad.
¿En qué formato debe estar el payload del webhook? JSON. Envía un cuerpo JSON con las claves que deseas asignar a las variables de automatización.
¿Quién puede agregar o editar activadores en una automatización? Los usuarios administradores siempre pueden agregar activadores. Los usuarios que no son administradores necesitan el Gestionar automatizaciones permiso en su rol, además de acceso al grupo de la automatización. Si una automatización aún no tiene activadores, cualquier usuario con acceso al grupo puede agregar el primero.