Uso del conector de Webhook

Utilizar el conector HTTP Webhook de Studio

1. Selecciona el desencadenador HTTP Webhook

   En Studio, selecciona el desencadenador HTTP Webhook .

2. Crear o seleccionar una conexión

   Utilice una conexión existente o cree una nueva.

3. Copiar la URL de webhook

   Recupera la URL de webhook generada de la actividad del desencadenador.

4. Configura tu filtro de datos

   Define las condiciones en las que debe desencadenarse el evento de webhook.

5. Publish your process

   Publica el flujo de trabajo para que esté disponible para su activación.

6. Registre la URL de webhook en su aplicación

   Pega la URL del webhook copiada del paso 3 en la configuración del webhook de tu aplicación de proveedor.

Utilizar el conector HTTP Webhook desde Orchestrator

1. En Orchestrator, selecciona Abrir desencadenadores de eventos > Añadir un nuevo desencadenador.

2. Selecciona tu proceso, proporciona un nombre y haz clic en Siguiente.

3. Selecciona Conector: HTTP Webhook.

4. Crea o selecciona una conexión.

   Utilice una conexión existente o cree una nueva. Aprende a crear conexiones.

5. Configura tu filtro de datos.

   Define las condiciones en las que debe desencadenarse el evento de webhook. Aprende a configurar los filtros de datos.

6. Copia la URL de webhook para su uso posterior.

7. Añade el desencadenador para completar la configuración.

8. En tu flujo de trabajo, utiliza la actividad Obtener salida de evento de desencadenador para utilizar el encabezado o el cuerpo del webhook.

   Pase UiPathEventObjectId (data type=Text) como argumento de entrada para el ID de objeto de evento de UiPath de propiedad requerido.

Crear una conexión HTTP Webhook

1. Asigne un nombre a la conexión
   En el campo Para qué aplicación es este webhook , introduce un nombre descriptivo para la aplicación de webhook, algo que facilite la identificación de qué proveedor o integración representa esta conexión. Este valor se convierte en el Identificador de conexión.
2. Configurar la ubicación del desafío
   Elija cómo enviará el proveedor el token de desafío para que UiPath pueda responder correctamente o seleccione Sin desafío. Opciones comunes:
   • Parámetro de consulta (por ejemplo, ?challenge=...)
   • Cuerpo JSON (POST con { "challenge": "..." })
   • Encabezado (por ejemplo, X-Hub-Challenge)
3. Configure la verificación de desafío y conéctese
   Si el proveedor requiere un protocolo de enlace, introduce la configuración de desafío que coincida con el patrón del proveedor (qué campo/encabezado/consulta leer y cómo repetirlo/validarlo). Cuando se complete la configuración, haz clic en Conectar. Más información sobre la verificación de desafíos.

Consejo:

• Utiliza un nombre que incluya el proveedor y el entorno (por ejemplo, Stripe-prod o Slack-staging) para evitar confusiones.
• Si no estás seguro de qué patrón de desafío utiliza el proveedor, consulta sus documentos de webhook o ejecuta un registro de prueba para inspeccionar la solicitud de handshake.

Verificación de desafío de Webhook

Algunos proveedores requieren que se validen las URL de webhook antes de comenzar a enviar eventos reales. Esto se hace utilizando un mecanismo de desafío-respuesta. Cuando registras un webhook, el proveedor envía una solicitud de desafío especial y el punto final debe responder exactamente como se espera.

El conector HTTP Webhook admite estos flujos de verificación a través del marco de desafíos de Webhook, lo que te permite configurar cómo UiPath debe leer y responder a los desafíos del proveedor.

Compatibilidad con la verificación de desafíos

UiPath admite ambos tipos de comportamientos de webhook de proveedor:

• Proveedores que no utilizan la verificación de desafío
• Proveedores que requieren un protocolo de enlace de desafío antes de activar el webhook

Esto garantiza la compatibilidad con proveedores de webhooks simples, así como con aquellos con requisitos de seguridad más avanzados.

Cuando los proveedores no utilizan la verificación por desafío

Muchas aplicaciones simplemente aceptan una URL de webhook y comienzan a entregar eventos de inmediato.
Para estos proveedores:

• Los usuarios solo necesitan crear o seleccionar una conexión.
• Copia la URL del webhook.
• Pégalo en la configuración de webhook del proveedor.

No se requieren pasos adicionales. El webhook se activa tan pronto como el proveedor comienza a enviar eventos.

Este es el escenario más común y sencillo, y UiPath lo gestiona sin problemas.

Cuando los proveedores requieren verificación de desafío

Algunos proveedores envían una solicitud de desafío para verificar la URL del webhook antes de habilitarla.
En estos casos:

• Los usuarios deben configurar la respuesta de desafío en la conexión HTTP Webhook.
• UiPath escucha la solicitud de desafío del proveedor.
• UiPath devuelve automáticamente el valor de desafío correcto en función de la configuración.
• Una vez que el proveedor valida la respuesta, los eventos normales comienzan a fluir.

Debido a que los proveedores difieren en la forma en que envían el desafío (parámetro de consulta, cuerpo JSON, encabezado, etc.), la configuración de UiPath permite a los usuarios manejar cualquiera de estos patrones.

Esto garantiza la compatibilidad con los proveedores de webhooks que imponen protocolos de enlace de seguridad como Slack, Meta (Facebook/Instagram), Stripe y otros.

Configurar la verificación de desafío

El comportamiento de desafío se configura utilizando cuatro parámetros:

• Clave de desafío
  Campo/clave que contiene el valor de desafío. Se utiliza para detectar solicitudes de desafío (no debe ser nulo).

• Ubicación del desafío
  Donde aparece la clave:

  • Cuerpo
  • Parámetro de consulta
  • Encabezado

• Tipo de contenido de la respuesta al desafío
  Formato de la respuesta devuelta al proveedor:

  • texto/sin formato
  • application/json

• Formato de respuesta al desafío
  Define qué valor se devuelve (normalmente la propia clave de desafío).
  UiPath extrae el valor del desafío entrante y responde en consecuencia.

Ejemplo genérico

Solicitud entrante

 {
  "challenge": "ABC123"
 }

Configuración

• Clave de desafío: challenge != null
• Ubicación del desafío: cuerpo
• Tipo de respuesta: text/plain
• Formato de respuesta: challenge

Respuesta

ABC123

Ejemplo de verificación de desafío de WhatsApp

WhatsApp utiliza el método de desafío basado en parámetros de consulta con hub.challenge.

Configuración

Parámetro	Valor
Clave de desafío	hub.challenge != null
Ubicación del desafío	Parámetro de consulta
Tipo de contenido de la respuesta al desafío	text/plain
Formato de respuesta al desafío	hub.challenge

Solicitud de proveedor

GET https://your-webhook-url?hub.challenge=1234567890

Respuesta esperada de UiPath

HTTP/1.1 200 OK
Content-Type: text/plain

1234567890

Esto confirma la propiedad y WhatsApp comienza a enviar eventos de webhook reales después.

Resumen: genérico frente a WhatsApp

Paso	Ejemplo genérico	Ejemplo de WhatsApp
Ubicación del desafío	Cuerpo/Consulta/Encabezado	Consulta
Formato de clave	Clave simple (por ejemplo, challenge)	Clave con punto ("hub.challenge")
TipoDeRespuesta	texto/sin formato o aplicación/json	texto/sin formato
Valor de respuesta	Valor de la clave	Valor de "hub.challenge"
Método	PUBLICAR u OBTENER	Solo OBTENER

Configurar filtros de datos

Los filtros de datos pueden aplicarse tanto al cuerpo como al encabezado de la respuesta del proveedor.

Supongamos que el proveedor devuelve una respuesta de cuerpo de la siguiente manera:

{
  "id": "exampleCartId",
  "token": "exampleCartId",
  "email":"[e-mail]"
  }

Desencadenadores de eventos de Orchestrator

Si quieres que tu proceso se desencadene cuando el token contenga exampleCartId, puedes configurarlo de la siguiente manera:

Nota:

Cuando una propiedad JSON incluye un guion (-), debe estar entre comillas dobles.
Por ejemplo: header."x-shopify-shop-domain" contiene ecommerce.

Desencadenadores de eventos de Studio

Para lograr el mismo comportamiento utilizando la actividad del desencadenador HTTP Webhook en Studio, configura el filtro de la siguiente manera:

Publicar

Publica tu flujo de trabajo a partir de un evento HTTP Webhook para activar la URL pública. A continuación, puedes probar esto desencadenando eventos en la aplicación del proveedor o enviando un comando curl directo a la URL:

Automation Cloud:

curl -X POST https://cloud.uipath.com/{webhook_url} -d "example 
            curl call"

Sector público de Automation Cloud:

curl -X POST https://govcloud.uipath.us/{webhook_url} -d "example
            curl call"

Cuando Integration Service acepta el evento, responde con la siguiente carga útil JSON:

{ "webhookEventId": "wr-4ad55717e1.a7bbf1e8-72a1-4371-82d2-d{example}", "correlationId": "384d496c-2f6d-{example}" }

Nota:

Esta carga útil es útil para las pruebas, pero no es necesaria en ningún lugar dentro de tu flujo de trabajo.