Activador de Listener

El activador Listener escucha eventos en la aplicación externa y activa la automatización en tiempo real. Este activador requiere una URL de escucha que sirva como el punto final al que la aplicación externa envía los detalles del evento del webhook.

Resumen

El activador Listener permite crear activadores para aplicaciones que admiten webhooks. Puede configurar el activador Listener para recibir las notificaciones de eventos entrantes y comenzar la automatización subsiguiente basada en la notificación. Debe crear una URL de escucha para el activador Listener, que actúa como el punto final para recibir la notificación. La plataforma codifica esta URL de forma fija y no puede editarla después de crearla. Cree la URL de escucha en la página Activadores de eventos.

El activador Listener ofrece opciones para agregar encabezados de autenticación y esquemas de firma según la aplicación para la que esté configurando el activador. Debe configurar el encabezado de autenticación en la configuración del webhook de la aplicación y agregar los mismos encabezados en Encabezados de autenticación. También puede establecer un esquema de seguridad para validar la carga entrante. Establezca el encabezado X-Firma con la clave en el lado de la aplicación y agregue el mismo parámetro y clave en el campo Esquema de firma. Actualmente, el activador Listener solo admite la firma HMA-SHA256.

Configuración

Las siguientes configuraciones están disponibles en el activador Listener:

Captura de pantalla del panel de configuración del activador web de Listener

Oyente
Elija una URL de escucha adecuada para el activador en la lista desplegable. Activador Listener. Puede usar el botón Actualizar para actualizar la lista desplegable. Para obtener más información sobre cómo crear URL de recepción, consulte Creación de la URL de detector para el activador web de Listener.
Encabezados de autenticación
Ingrese los encabezados de autenticación que configuró en el lado de la aplicación. Los encabezados de autenticación aseguran que los webhooks sean seguros. Los encabezados usan el formato nombre-valor. Asegúrese de ingresar el nombre y los valores exactos que establece en la configuración de la aplicación. Este campo es opcional.
Esquema de firma
Seleccione un esquema de firma apropiado para validar los datos entrantes. El esquema de firma verifica el origen y la integridad de los datos, lo que proporciona una capa adicional de seguridad. El esquema de firma consiste en un identificador de clave y un nombre de encabezado.
Clave secreta
Ingrese la clave secreta utilizada para identificar la firma. Use la opción Credencial para elegir una clave que esté disponible en la Credential Vault. Como alternativa, ingrese la clave directamente en la opción String insegura.
Nombre del encabezado de la firma
Escriba el nombre del encabezado para la clave secreta.
Respuesta
Seleccione una variable de registro para guardar los datos de respuesta del activador. La automatización guarda los datos de respuesta del activador en un formato de pares clave-valor. Después de ejecutar el bot, vaya a la página Registro de auditoría y seleccione el evento Bot ejecutado por activador para ver los datos de respuesta. Consulte la documentación de la API de la aplicación externa para el contenido de datos de la respuesta.