- Primeros pasos
- Notificaciones
- Licencia
- Solución de problemas
- Creador de conectores
- Act! 365
- Active Directory: vista previa
- ActiveCampaign
- Adobe Acrobat Sign
- Servicios de Adobe PDF
- Amazon Bedrock
- Amazon Connect
- Amazon Polly
- Amazon SES
- Amazon Transcribe
- Amazon Web Services
- Anthropic Claude
- Asana
- AWeber
- Azure AI Document Intelligence
- Azure Maps
- BambooHR
- Box
- Brevo
- Calendly
- Campaign Monitor
- Cisco Webex Teams
- Citrix Hypervisor
- Citrix ShareFile
- Clearbit
- Confluence Cloud
- Constant Contact
- Coupa
- Customer.io
- Datadog
- Deputy
- DocuSign
- Goteo
- Dropbox
- Egnyte
- Eventbrite
- Exchange Server: vista previa
- Tipos de cambio
- Expensify
- Facebook
- Freshbooks
- Freshdesk
- Freshservice
- GetResponse
- GitHub
- Gmail
- Plataforma Google Cloud
- Google Docs
- Google Drive
- Google Maps
- Google Sheets
- Google Speech-to-Text
- Google Tasks: vista previa
- Texto a voz de Google
- Google Vertex
- Google Vision: vista previa
- Google Workspace
- GoToWebinar
- Greenhouse
- Hootsuite
- HTTP Webhook: vista previa
- Hubspot CRM
- Hubspot Marketing
- HyperV: vista previa
- iContact
- Insightly CRM
- Intercom
- Jira
- Keap
- Klaviyo
- LinkedIn
- Mailchimp
- MailerLite
- Mailgun
- Mailjet
- Marketo
- Microsoft 365
- Microsoft Azure
- Microsoft Azure Active Directory
- Microsoft Azure OpenAI
- Microsoft Dynamics 365 CRM
- Microsoft OneDrive y SharePoint
- Microsoft Outlook 365
- Opinión de Microsoft
- Microsoft Teams
- Microsoft Translator
- Microsoft Vision
- Miro
- NetIQ eDirectory
- OKTA
- OpenAI
- Oracle Eloqua
- Oracle NetSuite
- PagerDuty
- PayPal
- PDFMonkey
- Pinecone
- Pipedrive
- QuickBooksOnline
- Quip
- Salesforce
- Salesforce Marketing Cloud
- SAP BAPI
- SAP Cloud for Customer
- SAP Concur
- SAP OData
- SendGrid
- ServiceNow
- Shopify
- Slack
- SmartRecruiters
- Smartsheet
- Snowflake
- Stripe
- Sugar Enterprise
- Sugar Professional
- Sugar Sell
- Sugar Serve
- System Center: vista previa
- TangoCard
- Todoist
- Trello
- Twilio
- VMware ESXi vSphere
- watsonx.ai
- WhatsApp Business
- WooCommerce
- Viable
- Workday
- X (anteriormente Twitter)
- Xero
- YouTube
- Zendesk
- Zoho Campaigns
- Zoho Desk
- Zoho Mail
- ZoomInfo
Guía de usuario de Integration Service para Automation Suite
Crear un desencadenador
Puedes crear un desencadenador como parte de un conector personalizado. Puedes utilizar desencadenadores de conectores personalizados para iniciar automáticamente automatizaciones o procesos basados en eventos del proveedor.
Los desencadenadores del Creador de conectores utilizan el sondeo de recursos para detectar cambios de proveedor. El sondeo de recursos implica llamar a un recurso de la API en un intervalo regular para detectar cuándo se devuelven nuevos eventos.
Una vez que se publica un conector personalizado y se utiliza el desencadenador en una automatización publicada, la URL definida se utiliza como recurso de sondeo para recuperar eventos e iniciar un flujo de automatización.
La URL de sondeo del desencadenador debe incluir parámetros de consulta para filtrar los resultados del proveedor.
El sondeo se produce en un intervalo programado (cada 5, 10, 15 minutos, etc.). Por lo tanto, uno de los parámetros de consulta del proveedor debe ser una fecha para filtrar los resultados. De esta manera, el motor de sondeo puede rellenar el valor del parámetro de consulta para incluir solo los eventos que ocurrieron desde la última hora de sondeo.
-
Puedes crear un desencadenador por recurso. Si se necesita más de un caso de uso, utiliza una URL de sondeo más general y configura campos de filtro de respuesta que puedan cumplir con múltiples casos de uso.
-
Las API de proveedor deben permitir el filtrado de parámetros de consulta basados en fechas. Si el proveedor no dispone de parámetros de consulta basados en fechas, no debe utilizarse como desencadenador.
GET
que devuelva una lista de objetos. Además, el punto final debe permitirte consultar el recurso en función de un parámetro de fecha.
Ejemplo de un recurso válido
since
que filtra los resultados por todas las actividades con una fecha update_time
posterior a la fecha since
proporcionada como valor para el parámetro de consulta. Puedes utilizar el parámetro since
como parte de la URL de sondeo para detectar cualquier actualización de las actividades de Pipedrive. El motor de sondeo de UiPath rellena automáticamente este campo de fecha para capturar eventos.
Los desencadenadores del Creador de conectores utilizan recursos que ya están disponibles en el conector como URL de sondeo. Al crear un nuevo desencadenador, debe haber un recurso existente en el lado del conector al que asociar el desencadenador.
Los desencadenadores utilizan la configuración del recurso, por lo que es importante que el recurso existente ya tenga:
-
Parámetros de consulta: los desencadenadores pueden importar parámetros de consulta existentes, por lo que el recurso ya debería tener algunos parámetros configurados antes de crear el desencadenador.
-
Campos de respuesta: desencadena el objeto de respuesta del recurso asociado, además de permitir la configuración de la actividad basada en estos campos. Es necesario generar los campos de respuesta para el recurso llamando correctamente al punto final.
Para crear un desencadenador en el Creador de conectores, sigue estos pasos:
- En primer lugar, asegúrate de cumplir los requisitos previos.
- En Integration Service, abre el Generador de conectores y selecciona tu conector personalizado.
- Selecciona Más opciones junto a Desencadenadores.
- Selecciona Añadir desencadenador.
Se mostrará la ventana emergente Crear evento . Aquí puedes seleccionar qué tipo de evento crear. Actualmente, Sondeo es la única opción disponible.
- Selecciona el tipo de evento.
- Añade un nombre para tu desencadenador.
- Selecciona el recurso utilizado para detectar estos eventos.
- Selecciona Crear para iniciar el proceso de configuración de tu desencadenador.
El proceso de creación de un desencadenador consta de tres pasos:
- Configurar solicitud.
- Configurar respuesta.
- Configurar filtros de desencadenador.
Estos pasos corresponden al proceso de sondear una URL de recurso y trabajar con la respuesta.
Configurar solicitud
En primer lugar, configura cómo se configura la URL de sondeo y cómo se muestra el desencadenador en Studio cuando se utiliza en una automatización.
El diseño de vista previa representa cómo se muestra el desencadenador en Studio. Puedes configurar los parámetros y los campos de respuesta para cambiar los campos que ves y utilizas en Studio al configurar el desencadenador de una automatización.
URL de sondeo
La URL de sondeo se muestra en la parte superior de la página de configuración. Esta es la URL utilizada para realizar solicitudes al proveedor para detectar nuevos eventos.
Esta URL debe configurarse de forma que filtre los eventos de interés. La URL de sondeo utiliza un parámetro de fecha para filtrar los nuevos eventos desde la última solicitud de sondeo. Es obligatorio incluir un parámetro de fecha que el motor de sondeo pueda rellenar.
Importar parámetros
Los desencadenadores pueden importar parámetros de recursos para utilizarlos en la URL de sondeo.
Si un parámetro no está disponible en el recurso, navega hasta el recurso y añádelo, luego vuelve a la ventana de configuración del desencadenador para importarlo.
- Selecciona Importar parámetros para ver la lista de parámetros disponibles para un recurso específico.
- Selecciona el parámetro que deseas utilizar en la URL de sondeo.
- Una vez añadido un parámetro, se incluye en la vista previa de la URL en la parte superior de la página.
Puedes marcar los parámetros importados como Requeridos para que se muestren en el lienzo del desencadenador. Esto significa que debes introducir un valor para el parámetro de consulta al utilizar el desencadenador en una automatización.
DateTime
. Los formatos DateTime
se pueden encontrar para un parámetro con un tipo de datos de proveedor String
o Integer
.
Probar desencadenador
Utiliza la opción Desencadenador de prueba para asegurarte de que se devuelven los resultados esperados.
Al seleccionar Desencadenador de prueba, se muestra la ventana Probar la solicitud , que muestra:
- Periodo retrospectivo: este campo define qué fecha debe insertarse en los parámetros de consulta basados en fechas y replica el comportamiento de nuestro motor de sondeo, que rellena automáticamente este valor en función de la fecha de la última solicitud de sondeo.
- Los parámetros de consulta especificados como necesarios.
Selecciona Intentar solicitud para abrir el panel Depuración de eventos y ver el seguimiento de la solicitud con un desglose paso a paso del proceso de solicitud. También se muestra el número de resultados devueltos.
Configurar respuesta
En este paso, se especifica qué campo de respuesta corresponde a la Clave principal o a la salida del desencadenador.
- Utiliza la lista desplegable bajo Clave principal para seleccionar un campo.
- El campo seleccionado se añade a la vista previa del desencadenador, en Salida. Puedes utilizar esta salida en pasos posteriores de tu flujo de trabajo.
Configurar filtros de desencadenador
Una vez que configures la solicitud y la respuesta, puedes configurar aún más el desencadenador utilizando filtros.
El filtrado de eventos se configura estableciendo valores específicos para los campos de respuesta. Estos valores se especifican durante la configuración de la automatización (en Studio), pero el diseñador de desencadenadores también te permite configurar qué campos se muestran para el filtrado.
Hidratación
GETBYID
. Este proceso se conoce como hidratación.
GETBYID
antes de utilizarlo como recurso de hidratación para un desencadenador.
Filtros
El proceso de configuración del desencadenador ofrece tres opciones para mostrar los campos utilizados para el filtrado. Estos campos se extraen de los campos de respuesta de recursos del recurso de sondeo o del recurso de hidratación. Estas opciones están disponibles en la columna Mostrar como de la tabla Parámetros de filtro :
-
Oculto: el campo está oculto en el lienzo y no está disponible en el Creador de filtros. Si todos los campos están marcados como Ocultos, el creador de filtros también estará oculto.
-
Opcional: en tiempo de diseño, el campo se muestra como una opción en el Creador de filtros.
-
Obligatorio: en tiempo de diseño, el campo se muestra directamente en el lienzo del desencadenador y requiere la entrada del usuario. Solo los eventos con un valor de campo de respuesta que coincida con el valor proporcionado dan como resultado un evento de automatización.