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:
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.