Acerca del conector HTTP Webhook

Los webhooks permiten que las aplicaciones notifiquen a los sistemas externos en tiempo real, lo que reduce la necesidad de sondeos frecuentes y minimiza las llamadas a la API. En lugar de comprobar periódicamente si hay actualizaciones, el sistema recibe devoluciones de llamada basadas en eventos solo cuando se producen cambios relevantes.

El conector UiPath HTTP Webhook te permite desencadenar flujos de trabajo directamente desde las aplicaciones del proveedor. Puedes crear desencadenadores instantáneos para eventos para cualquier aplicación de terceros que admita notificaciones de webhook salientes, incluso si no forma parte del catálogo de conectores.

También puedes aplicar filtros de datos de eventos para especificar las condiciones exactas en las que un evento de webhook debe desencadenar un flujo de trabajo.

Cómo funciona

El desencadenador HTTP Webhook genera una URL de devolución de llamada pública dinámica. Copia y configura esta URL en la configuración de webhook de la aplicación del proveedor solo después de que tu desencadenador se haya creado en Orchestrator.

Cuando se produce un evento en el sistema del proveedor:

1. El proveedor envía la carga útil del evento a la URL configurada.
2. Integration Service recibe la carga útil y la evalúa comparándola con tus filtros de datos de eventos configurados.
3. Si se encuentra una coincidencia, Integration Service desencadena la ejecución del flujo de trabajo a través de Orchestrator.

Las cargas útiles de Webhook se procesan de la misma manera que cualquier otro evento desencadenador.

Para obtener más información, consulta Uso del conector de Webhook.

Si el proveedor requiere un protocolo de enlace, configura la verificación de desafío. Para obtener más información, consulta Verificación de desafío de Webhook.

Límites de tarifa

Los eventos desencadenados por Webhook están sujetos a los siguientes límites:

• 500 eventos por minuto por tenant
• 100 eventos por minuto por conexión

Limitaciones

• La depuración del desencadenador en tiempo de diseño no está disponible actualmente.
• Solo se admiten solicitudes en formato JSON.

Preguntas frecuentes

Pegué la URL de Webhook en la IU del proveedor, ¿por qué la verificación sigue sin pasar?

La verificación solo tendrá éxito después de crear el desencadenador en Orchestrator y siempre que hayas configurado el desafío correctamente. Ten en cuenta que UiPath no realiza ninguna verificación de desafío por nuestra parte: la validación se produce por completo en el extremo del proveedor para establecer la confianza con el destino.

Configuré el desafío incorrectamente, ¿por qué mi conexión aún se crea correctamente?

UiPath no valida actualmente el paso de desafío/verificación del proveedor. Esta validación la gestiona en su totalidad el proveedor. Como resultado, la conexión en UiPath puede aparecer activa incluso si la verificación de desafío del proveedor ha fallado por su parte.

¿Cómo uso la respuesta procedente de un webhook creado en Orchestrator?

Utiliza la actividad Obtener salida de evento de desencadenador en tu flujo de trabajo y pasa UiPathEventObjectId (data type=Text) como argumento de entrada. Esta actividad devolverá tanto el cuerpo como los encabezados recibidos del webhook.

La respuesta del webhook es una cadena JSON. ¿Cómo utilizo partes de él en mi flujo de trabajo?

Utiliza la actividad Deserializar JSON para convertir la cadena en un JObject, después de lo cual podrás acceder fácilmente a los campos individuales.