Déclencheur instantáneos (webhooks)
Muchos servicios proporcionan enlaces web para enviar notificaciones instantáneas cada vez que se produce un determinado cambio (evento) en el servicio. Para procesar estos eventos, le recomendamos que utilice déclencheur instantáneas. Los déclencheur instantáneos muestran la etiqueta Instant en la lista de módulos de un conector determinado.
Si un conector no incluye un gancho web, puede realizar una de las siguientes acciones:
- Cree un webhook personalizado con el módulo Webhook.
Para obtener más información, consulte Webhooks. - Utilice los déclencheur de sondeo para sondear periódicamente el servicio.
Para obtener más información, consulte Programar un escenario
Para ver un vídeo introductorio a los webhooks en Workfront Fusion, consulte lo siguiente:
Requisitos de acceso
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| paquete de Adobe Workfront |
Cualquier paquete de flujo de trabajo de Adobe Workfront y cualquier paquete de integración y automatización de Adobe Workfront Workfront Ultimate Paquetes Workfront Prime y Select, con una compra adicional de Workfront Fusion. |
| Licencias de Adobe Workfront |
Estándar Trabajo o superior |
| Producto | Si su organización tiene un paquete Select o Prime Workfront que no incluye la automatización y la integración de Workfront, su organización debe adquirir Adobe Workfront Fusion. |
Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.
Ver detalles del webhook
Puede ver una lista de los webhooks en el área de Webhooks.
-
Para abrir el área de Webhooks, haga clic en el icono de Webhooks
Aquí puede ver una lista de webhooks.
-
Para buscar un webhook específico, ingrese el término de búsqueda en el cuadro Buscar.
-
Para copiar un gancho web, haga clic en el icono Copiar
-
Para deshabilitar o habilitar un webhook, deshabilite o habilite la opción en la columna Estado de la fila correspondiente a dicho webhook.
-
Para ver si una cola de webhooks está llena, marque la columna Full Queue. El número de esta columna es el número de elementos que hay actualmente en la cola.
-
Para ver las operaciones administradas por un webhook, haga clic en Operaciones en la columna Cola completa de ese webhook.
-
Para ver si un webhook ha caducado, marque la columna Caducado. Los webhooks caducados no están adjuntos a ningún escenario o no han recibido ningún evento durante 120 horas.
-
Para ver el escenario donde se usa un webhook, haga clic en el botón Escenario de la columna Escenario para ese webhook.
-
Para ver la conexión usada para este webhook, haga clic en el botón Conexión en la columna Conexión para ese webhook.
-
Para ocultar columnas o mostrar columnas previamente ocultas, haga clic en el icono Columnas
Programar activadores instantáneos
Cuando se configura un déclencheur instantáneo, se le pide que seleccione cuándo se ejecuta.
Seleccione Immediately para ejecutar el escenario inmediatamente cuando Workfront Fusion reciba nuevos eventos del servicio. Estos eventos se envían inmediatamente a una cola y, a continuación, se procesan en el escenario de uno en uno, en el mismo orden en que se reciben los datos.
Cuando se ejecuta el escenario, se cuenta la cantidad total de eventos pendientes que esperan en la cola y el escenario realiza tantos ciclos como eventos pendientes, procesando un evento por ciclo.
Para obtener más información sobre los ciclos, vea Ejecución de escenarios, ciclos y fases.
-
Un ciclo no es lo mismo que una ejecución de escenario. Puede haber varios ciclos dentro de una ejecución de escenario.
-
Cuando ejecuta un escenario con un déclencheur instantáneo programado para ejecutarse
Immediately, se aplican las siguientes excepciones:-
El intervalo entre dos ejecuciones no está sujeto al intervalo mínimo según el plan de precios.
Por ejemplo, una vez que el escenario termina de ejecutarse, la cola del webhook se vuelve a comprobar. Si hay algún webhook pendiente, el escenario se ejecuta inmediatamente de nuevo, procesando todos los webhooks pendientes una vez más.
-
La configuración del escenario Número máximo de ciclos se ignora y se establece en 100, lo que significa que no se procesarán más de 100 webhooks pendientes durante una sola ejecución de escenario (a razón de 1 evento por ciclo).
-
Si usa cualquier otra configuración de programación distinta de Inmediatamente, el escenario se ejecutará a los intervalos especificados. Dado que se pueden agrupar varios enlaces web en la cola durante el intervalo, se recomienda establecer la opción Número máximo de ciclos en un valor mayor que el predeterminado 1 para procesar más enlaces web en una ejecución de escenario:
- Haga clic en el icono Configuración de escenario
- En el panel Configuración de escenario que aparece, escriba un número en el campo Número máximo de ciclos para indicar el número de eventos de la cola que desea ejecutar cada vez que ejecute el escenario.
Los eventos que permanecen en cola se procesarán la próxima vez que se ejecute el escenario, hasta el número establecido en el campo Número máximo de ciclos.
Protecciones de webhook
Para garantizar un buen rendimiento, Workfront Fusion dispone de las siguientes protecciones para los webhooks.
Límites de velocidad
El límite de velocidad actual es de 5 webhooks por segundo. Si se supera el límite, se devuelve un código de estado 429.
Caducidad de webhooks inactivos
Se eliminará un webhook que no se haya asignado a ningún escenario durante más de 120 horas.
Cargas útiles de webhook
Workfront Fusion almacena las cargas útiles de los ganchos web durante 30 días. Acceder a una carga útil de gancho web más de 30 días después de crearla provoca el error Failed to read file from storage.
Gestión de errores
Cuando hay un error en su escenario con un activador instantáneo, el escenario:
- Se detiene inmediatamente cuando el escenario está configurado para ejecutarse Inmediatamente.
- Se detiene después de tres intentos fallidos (tres errores) cuando el escenario está configurado para ejecutarse según lo programado.
Si se produce un error durante la ejecución del escenario, el evento se vuelve a colocar en la cola durante la fase de reversión del déclencheur instantáneo. En tal situación, puede corregir el escenario y ejecutarlo de nuevo.
Para obtener más información, consulte Inversión en el artículo Ejecución de escenarios, ciclos y fases.
Si hay un módulo de respuesta de webhook en su escenario, el error se envía ahí. El módulo de respuesta Webhook siempre se ejecuta en último lugar (cuando la opción Confirmación automática en la configuración de Escenario no está habilitada).
Para obtener más información, consulte Respuesta a los webhooks en el artículo Webhooks.
Desactivación de un webhook
Los webhooks se desactivan automáticamente si se aplica cualquiera de las siguientes opciones:
- El webhook no ha estado conectado a ningún escenario durante más de 5 días.
- El webhook solo se utiliza en escenarios inactivos, que han estado inactivos durante más de 30 días.
Los webhooks desactivados se eliminan y no se registran automáticamente si no están conectados a ningún escenario, y han estado en estado desactivado durante más de 30 días.
Webhooks personalizados
Puede crear sus propios webhooks. Para obtener más información, consulte Webhooks.
Recursos
Para obtener más información sobre los ciclos, vea Ejecución de escenarios, ciclos y fases.