HTTP Webhook authentication

Requisitos previos

Your webhook provider may require a handshake. Refer to the Webhook challenge verification section for details on how to configure the challenge verification.

Depending on where you create the trigger, the generated webhook URL will appear either in the HTTP Webhook trigger activity or on the trigger creation page, but only after the connection is created successfully. To avoid failures, paste the webhook URL into your application after you publish your workflow or the trigger is successfully created in UiPath Orchestrator.

Crear una conexión HTTP Webhook

1. Selecciona Integration Service en la barra izquierda.
2. From the Connectors list, select HTTP Webhook. You can also use the search bar to find the connector.
3. Selecciona Conectar a HTTP Webhook.
4. 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.
5. Configurar la ubicación del desafío
   Choose how the vendor will send the challenge token so that UiPath can respond correctly:
   • No challenge - the vendor does not require a handshake, and you can proceed to connect.
   • Parámetro de consulta (por ejemplo, ?challenge=...)
   • Cuerpo JSON (POST con { "challenge": "..." })
   • Encabezado (por ejemplo, X-Hub-Challenge)
6. Configure la verificación de desafío y conéctese
   If the vendor requires a handshake, enter the challenge verification that matches the vendor's pattern (which field/header/query to read and how to echo/validate it). When configuration is complete, click Connect.

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