# Crear y administrar webhooks para flujos de trabajo Los webhooks son una forma sencilla de automatizar la comunicación entre aplicaciones mediante el envío automático de datos de eventos cuando se producen determinadas acciones. En Qlik Cloud, los webhooks pueden desencadenar acciones en otras aplicaciones sin intervención manual, lo que facilita la integración de Qlik Cloud en sus flujos de trabajo y la automatización de tareas basadas en eventos del sistema. Cada vez que se produce un evento definido, se envía una solicitud JSON al punto final de webhooks especificado, entregando los datos del evento a la aplicación elegida. ## Permisos requeridos de webhooks Al crear o gestionar webhooks utilizando la [API de Webhooks](https://qlik.dev/apis/rest/webhooks/) de Qlik Cloud y la IU de automatizaciones, debe solicitar uno o ambos de estos permisos: * Utilizar webhooks: Necesario para crear, ver, actualizar y eliminar webhooks propiedad del usuario. * Administrar Webhooks: Necesario para gestionar todos los webhooks del espacio empresarial inquilino, incluidos los creados por otros usuarios. ## Webhooks ### Cómo funcionan los webhooks Cuando se produce un evento en Qlik Cloud (por ejemplo, se crea una nueva aplicación o se elimina un usuario), un webhook envía información en formato JSON a una aplicación externa especificada mediante una devolución de llamada HTTP. Esta aplicación externa puede utilizar entonces los datos de los eventos para desencadenar otras acciones. Por ejemplo: * Notifique a su equipo a través de Slack cuando se cree una nueva aplicación. * Enviar automáticamente un correo electrónico de bienvenida cuando se añade un nuevo miembro a un espacio empresarial inquilino. * Actualizar una hoja de cálculo cuando se elimina un usuario del espacio empresarial inquilino. ### Ventajas de usar webhooks Los webhooks permiten la integración en tiempo real con otros sistemas, eliminando la necesidad de comprobaciones manuales constantes o solicitudes de API repetitivas. Al estar a la escucha de los eventos y enviar inmediatamente los datos pertinentes, los webhooks reducen el trabajo innecesario y permiten una automatización sin problemas. ### Plataformas habituales de integración de webhooks Para gestionar y responder a los datos de webhooks, puede crear servicios personalizados o utilizar plataformas de terceros como: * [Qlik Automate](https://help.qlik.com/en-US/cloud-services/Subsystems/ApplicationAutomation/Content/introduction/home-automation.htm) (solo en inglés) * [Pipedream](https://pipedream.com/) * [Zapier](https://zapier.com/) * [Microsoft Power Automate](https://flow.microsoft.com/en-us/) ### Límites de los webhooks Para mantener el rendimiento del sistema y administrar los recursos, se aplican los siguientes límites: * El historial de entrega de webhooks se conserva durante 7 días. * Cada usuario puede poseer hasta 150 webhooks. * El tamaño total del encabezado HTTP por webhook está limitado a 2048 bytes para encabezados cifrados y 2048 bytes para encabezados no cifrados. Para cada tipo de encabezado, el límite es el tamaño total en bytes de todos los nombres y valores de encabezado configurados sumados. No hay límite en cuanto al número de encabezados. Nota informativaA partir del 3 de noviembre de 2025, el formato de evento heredado fue reemplazado por un nuevo formato de evento de Qlik Cloud. Todos los eventos heredados utilizan un evento híbrido temporal que contiene cargas útiles de eventos heredados y de la nube. Los eventos de integración de datos se emiten como eventos de la nube y no necesitarán ser migrados en el futuro. Para obtener una lista completa de los eventos y tipos de eventos admitidos en Qlik Cloud, consulte [Tipos de eventos compatibles para webhooks](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-webhooks-supported-events.htm). Para obtener más detalles sobre los nuevos eventos de Qlik Cloud, consulte [Qlik Community: Migration to new event format](https://community.qlik.com/t5/Official-Support-Articles/Qlik-Cloud-Webhooks-Migration-to-new-event-formats-is-coming/ta-p/2528660). ### Estructura de las solicitudes de webhooks Cuando un webhook es activado por un evento, envía una solicitud HTTP JSON al punto de conexión especificado durante la creación de webhooks. La estructura de esta solicitud contiene metadatos del evento y detalles de la carga útil como, por ejemplo, el tipo de evento, la fecha-hora y los atributos del objeto. #### Ejemplo de solicitud de webhook: evento de aplicación eliminada Aquí tiene un ejemplo de la solicitud JSON enviada cuando se elimina una aplicación: URL de la solicitud ``` https:///api/v1/webhooks/{id} ``` Encabezados ``` { "Content-Type": "application/json", "X-Execution-Token: ", "Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e", "User-Agent": "Qlik Webhook" } ``` Mensaje ``` { "cloudEventsVersion": "0.1", "source": "com.qlik/engine", "contentType": "application/json", "eventId": "e65c1481-e8a-4be-a5ca-27dfcde077d7", "eventTime": "2021-03-08T14:51:29Z", "eventTypeVersion": "1.0.0", "eventType": "com.qlik.v1.app.deleted", "extensions": { "ownerId": "vNRGrDZIypJzauw59BbpvkRhqbmI", "tenantId": "oZcMPa_1PwH4FUdrh6839YHHdEJN", "userId": "vNRGrDZIypJtcGTzauw59BbpqbmI" }, "data": { "attributes": { "id": "0984fec4-aa8c-4253-b1d1-4fd4f9c78", "name": "New App", "createdDate": "2021-03-08T14:51:28.888Z", "modifiedDate": "2021-03-08T14:51:29.316Z", "owner": "auth0|b62a17c577a4abe6e807b07d18c4d82286352542d633d120100b03fb11", "ownerId": "vNRGrDZIypJtcGTzauw59BbpvbmI", "published": false, "hasSectionAccess": false } } } ``` Esta carga útil proporciona información detallada sobre la aplicación eliminada, como su ID, nombre, propietario y fecha y hora de eliminación, lo que ayuda al sistema receptor a procesar el evento. Para más detalles sobre cargas útiles de eventos, consulte el [Portal para desarrolladores de Qlik: API de eventos](https://qlik.dev/apis/event/). #### Encabezados cifrados Qlik Cloud admite encabezados HTTP cifrados. Los encabezados cifrados le permiten proteger aún más los metadatos confidenciales. Cómo funciona: * Valores de encabezado cifrados: los valores de encabezado configurados para webhooks se pueden cifrar al configurar los webhooks. Esto garantiza que las credenciales, como los tokens de portador o las claves de API, se almacenen y manejen de forma segura. Los secretos de webhook son de escritura única. Una vez guardados, los secretos no se pueden ver ni recuperar, para reducir el riesgo de exposición accidental. Nota informativaLos encabezados se cifran durante el almacenamiento, no durante la transmisión. ## Crear webhooks Los webhooks los pueden crear: * Administradores de espacios empresariales inquilinos desde el centro de actividades Administración. * Todos los usuarios desde la interfaz Qlik Automate. Para más información sobre el uso de webhooks con Qlik Automate, consulte [Trabajar con webhooks](https://help.qlik.com/en-US/cloud-services/Subsystems/Sense_QlikAutomation/Content/Sense_QlikAutomation/working-with-automations/working-with-webhooks.htm) (solo en inglés). Haga lo siguiente: 1. En el centro de actividades Administración, vaya a Webhooks. 2. Haga clic en Crear nuevo. 3. Indique un nombre para el webhook y, si lo desea, añada una descripción. 4. Para URL (el punto de conexión), indique el nombre de dominio completo (FQDN) donde el webhook enviará los datos JSON. * Esta URL debe utilizar el protocolo HTTPS (ejemplo: https: //domain.com). Las direcciones IP no pueden usarse como puntos de conexión de webhooks. 5. Opcionalmente, introduzca un secreto para la autenticación de webhooks. * El secreto debe tener entre 32 y 64 caracteres. * Si lo crea, el secreto se incluirá como parte de un hash, anexado a la solicitud HTTP como qlik-signature. 6. Evento en la nube: la carga útil del evento emitida por el servicio de webhooks de Qlik Cloud. Una vez activado y guardado, el cambio no se puede deshacer. 7. Comprobar revocación de certificado cuando está activado, verifica que los certificados del webhook sean válidos y no estén revocados. 8. Opcionalmente, añada cabeceras HTTP para anexar a la solicitud. Marque la casilla de verificación para cifrar el valor del encabezado. Nota informativaPor motivos de seguridad, no puede editar encabezados cifrados; para eliminar el encabezado, haga clic en el icono Eliminar. Para eliminar el valor, haga clic en el icono Eliminar y escriba uno de nuevo. 9. En Eventos, seleccione los eventos del sistema que activarán el webhook. Entre los eventos disponibles se incluyen: * Eventos de automatización * Eventos de API * Eventos de aplicación * Eventos de integración de datos * Eventos de usuario 10. Haga clic en Crear. Nota informativaSi hace clic en Cancelar mientras hay cambios sin guardar, aparecerá un cuadro de diálogo de confirmación. Haga clic en Descartar para cerrar sin guardar los cambios. ## Administrar webhooks Nota informativa Los webhooks creados con Qlik Automate solo se pueden ver en el centro de actividades Administración. No se pueden editar, eliminar, habilitar ni deshabilitar. Para administrar estos webhooks, utilice la interfaz de Qlik Automate. ### Ordenar y buscar webhooks Para ordenar y buscar webhooks en la tabla: * Haga clic en the Flecha ascendente-descendente icon en la parte superior de una columna para cambiar el orden. * Haga clic en the Filtro icon en la parte superior de una columna para buscar un webhook. El filtro de búsqueda funciona para correspondencias completas y parciales. Tabla de webhooks. Tabla de webhooks. Tabla de webhooks. ![Tabla de webhooks de la consola de administración](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Resources/Images/mc-webhooks.png) ### Activar o desactivar webhooks Haga lo siguiente: 1. En el centro de actividades Administración, vaya a Webhooks. 2. Haga clic en the Más icon junto al webhook. 3. Para activar el webhook, seleccione Habilitar. 4. Para desactivar el webhook, seleccione Deshabilitar. Los webhooks recién creados están habilitados de manera predeterminada. ### Editar webhooks Haga lo siguiente: 1. En el centro de actividades Administración, vaya a Webhooks. 2. Para el webhook que desea editar, haga clic en the Más icon. 3. Seleccione Editar. 4. Edite lo que desee y haga clic en Guardar. Nota informativaSi hace clic en Cancelar mientras hay cambios sin guardar, aparece un cuadro de diálogo de confirmación. Haga clic en Descartar para cerrar sin guardar los cambios. ### Eliminar webhooks Haga lo siguiente: 1. En el centro de actividades Administración, vaya a Webhooks. 2. Seleccione el webhook que desee eliminar. 3. Haga clic en Eliminar. 4. Confirme la eliminación. Nota informativaEl botón Eliminar no está disponible hasta que seleccione uno o más webhooks. La barra de acciones muestra el número de webhooks seleccionados. ### Ver el historial de webhooks El historial de eventos de webhooks se conserva durante 7 días. Haga lo siguiente: 1. En el centro de actividades Administración, vaya a Webhooks. 2. Haga clic en the Icono de flecha hacia abajo de la interfaz de usuario para expandir el menú de webhooks icon junto a un webhook para ampliar su historial de eventos. Historial de webhooks. Historial de webhooks. Historial de webhooks. ![Historial de webhooks de la consola de gestión](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Resources/Images/mc-webhook-history.png) 3. Para reenviar manualmente la entrega de un evento, haga clic en the El icono de Reenviar en la fila de eventos. 4. Para ver la carga útil de la respuesta al evento, haga clic en the Flecha hacia abajo icon en la fila del evento. La carga útil muestra detalles como el ID de la aplicación, el nombre y la fecha y hora, lo que resulta útil para depurar o auditar eventos pasados. Carga útil de respuesta a eventos. Carga útil de respuesta a eventos. Carga útil de respuesta a eventos. ![Información de carga útil del tipo de evento de webhook de la consola de gestión](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Resources/Images/mc-webhook-payload.png)