Introducción
El disparador por webhook permite que cualquier sistema externo active una automatización de Level mediante una solicitud HTTP. Cuando guardas este disparador, Level genera una URL única. Envía una solicitud POST a esa URL y la automatización se ejecuta.
Úsalo para integrar Level con herramientas que admitan webhooks salientes: plataformas PSA, sistemas de monitoreo, scripts externos o cualquier cosa que pueda realizar una llamada HTTP.
ℹ️ NOTA: Para agregar disparadores 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 disparadores, verifica los permisos de tu rol con tu administrador. Consulta Espacio de trabajo → Permisos para más detalles.
Disparador por Webhook
Generación de la URL del Webhook
La URL del webhook se crea al guardar el disparador — no existe antes de eso. Haz clic en Guardar y Level genera un token único vinculado a este disparador.
⚠️ ADVERTENCIA: Al eliminar este disparador 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 disparador, luego actualiza la URL en tu sistema externo.
Requerir un encabezado de autorización
Marca 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.
Usa una clave de API con permisos de escritura con Lectura y escritura acceso desde la misma organización de Level que el disparador por webhook. Una clave de solo lectura es rechazada con HTTP 403: This API key does not have write permissions.
Si no tienes una clave con permisos de escritura, crea una o edita una existente en Configuración → Claves de API. Consulta Configuración de claves de API.
El comando cURL debajo de la URL se actualiza automáticamente para incluir el -H "Authorization: ..." encabezado 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 accesible desde internet público. Esto garantiza que solo los sistemas con la clave puedan activar la automatización.
Mapeo de parámetros
Mapea 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 mapeará 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 ser referenciada en acciones y scripts posteriores.
💡 CONSEJO: Mapea cualquier valor que tu sistema externo envíe en el payload del webhook — números de ticket, identificadores de cliente, metadatos de dispositivos, lo que sea — y referéncialo 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 disparador. Elige Todos los dispositivos o limita el alcance para apuntar a dispositivos específicos cuando se active el webhook.
Para la referencia completa de condiciones, consulta Condiciones del disparador.
Opciones adicionales
Expande Opciones adicionales para establecer un Nombre del disparador y activa o desactiva el disparador con el Habilitado interruptor.
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? Abre la automatización en modo de edición y haz clic en la tarjeta del disparador por 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 del webhook para activar la automatización varias veces? Sí. La URL es persistente mientras el disparador exista. 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é ocurre si el webhook se activa 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 activa de nuevo mientras ese dispositivo ya está en ejecución, la nueva solicitud es ignorada para ese dispositivo. Si el dispositivo no está actualmente en una ejecución, se activa normalmente.
¿En qué formato debe estar el payload del webhook? JSON. Envía un cuerpo JSON con las claves que deseas mapear a las variables de automatización.
¿Quién puede agregar o editar disparadores en una automatización? Los usuarios administradores siempre pueden agregar disparadores. Los usuarios no 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 disparadores, cualquier usuario con acceso al grupo puede agregar el primero.