Poller

El activador Poller verifica periódicamente la fuente de datos en busca de actualizaciones. Después de configurarlo, Poller verifica periódicamente si hay nuevos datos mediante la URL de sondeo de una fuente de datos. El Poller es ideal para casos de uso donde las actualizaciones en tiempo real no están disponibles o cuando la frecuencia de las actualizaciones es baja.

Resumen

El Poller funciona bajo el concepto de sondeo, donde el activador envía periódicamente solicitudes a la URL de sondeo para obtener nuevos datos. Puede configurar el Poller para recibir las notificaciones de eventos entrantes y comenzar la automatización subsiguiente basada en la notificación. La URL del sondeador de la aplicación sirve como el endpoint que el activador consulta para nuevos eventos.

Puede configurar el Poller para una llamada GET o una llamada POST. Debe agregar el parámetro de encabezado, el parámetro de consulta, los detalles de gestión de contexto y el filtro JSON al configurar el Poller. La opción POST incluye la posibilidad de agregar texto en la solicitud. Puede usar esta opción para enviar datos a la URL del sondeador que requiere datos adicionales para los eventos.

Configuración

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

Panel de configuración del Sondeador

Nombre
Especifique un nombre para el Poller
URL de sondeo
Especifique la URL de sondeo de la aplicación.
Tipo de solicitud
Seleccione el tipo de solicitud de API. El Poller admite los métodos GET y POST.
  • GET: puede usar el método GET para obtener los detalles del evento.
  • POST: puede usar el método POST para limitar los datos de respuesta. El método POST tiene una disposición para agregar un cuerpo de solicitud. Esta opción actúa como un filtro para limitar los datos de respuesta.
Cuerpo de la solicitud
Ingrese el cuerpo de la solicitud para el método POST. Puede agregar el cuerpo de la solicitud en formatos como TXT, JSON, XML y HTML.
Intervalo de sondeo
Establezca la frecuencia para consultar la URL en busca de nueva información. Puede configurar el intervalo en Minutos, Hora o Día. El límite mínimo para el intervalo es de 5 minutos.
Modo de autenticación
Especifique el modo de autenticación para el activador. Puede elegir Sin autenticación o OAuth2: gestionado por la Control Room.
Conexión
Utilice el botón Seleccionar para elegir una conexión OAuth existente como el modo de autenticación. Asegúrese de que la conexión esté configurada y activa.
Agregar encabezado
Especifique los parámetros de encabezado que corresponden a la solicitud de sondeo. Puede agregar encabezados de autenticación y otros parámetros únicos que deben incluirse en el encabezado de la solicitud.
Active la casilla de verificación Agregar encabezado y haga clic en Agregar encabezado para abrir el modal Elemento. Especifique el nombre del parámetro de encabezado y los valores en el modal Elemento.
Agregar parámetro de consulta
Especifique los parámetros de consulta que corresponden a la solicitud de sondeo. Habilite la casilla de verificación y haga clic en Agregar encabezado para abrir el modal de Elemento.
Habilite la casilla de verificación Agregar parámetro de consulta y haga clic en Agregar consulta para abrir el modal Elemento. Especifique el nombre del parámetro de consulta y los valores en el modal Elemento.
Gestión de contexto
Defina la gestión de contexto para cualquier parámetro dinámico. El activador utiliza el contexto como punto de control de sondeo para garantizar que obtenga la información actualizada después del último punto de control. Puede definir la gestión de contexto para las URL de sondeo, los encabezados y los parámetros de consulta. Defina el parámetro como string y utilice esa string para definir el contexto.
Por ejemplo, la API de Gmail para sondeo utiliza el ID de historial de un correo electrónico para determinar los cambios en el buzón de correo. Cuando configura un activador de sondeo para la bandeja de entrada de Gmail, puede definir el ID de historial, ya sea en la URL de sondeo como https://gmail.googleapis.com/gmail/v1/users/me/history?startHistoryId={{historyID}} o agregar un parámetro de consulta con la clave startHistoryId y el valor historyID. Luego, puede configurar el contexto para el ID de historial con el ID de historial del último correo electrónico que se recibió en la bandeja de entrada como punto de control del sondeo. También debe agregar el nodo JSON donde se captura el ID del historial en la carga de respuesta en el campo Actualizar contexto. Esto garantiza que el activador tome el ID del último correo electrónico recibido como el ID de historial inicial cada vez que se ejecuta el activador.
Active la casilla de verificación Gestión de contexto y haga clic en Agregar contexto para abrir el modal Elemento. Especifique la clave de contexto y los valores en el modal Elemento. Puede seleccionar una de las siguientes opciones como condición para actualizar el contexto:
  • Expresión Json: Seleccione esta opción para establecer un nodo JSON del contenido de la respuesta como el contexto.
  • Marca de tiempo actual (Unix): Seleccione esta opción para establecer la marca de tiempo de época Unix del parámetro de consulta como el contexto.
  • Marca de tiempo actual (ISO 8601): Seleccione esta opción para establecer la marca de tiempo ISO 8601 del parámetro de consulta como el contexto.
Filtro JSON
Especifique un filtro para los datos de respuesta. Esta configuración permite filtrar los datos según sus requisitos. Por ejemplo, si los datos JSON contienen registros con múltiples longitudes como 1, 5, 10, 25 y 30, puede definir el filtro JSON como registro.longitud>10 . Este filtro descarta los registros con una longitud menor a 10.
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.