Autenticación HTTP Webhook

Requisitos previos

Tu proveedor de webhook puede requerir un protocolo de enlace. Consulta la sección Verificación de desafío de Webhook para obtener más información sobre cómo configurar la verificación de desafío.

Dependiendo de dónde crees el desencadenador, la URL del webhook generado aparecerá en la actividad del desencadenador HTTP Webhook o en la página de creación del desencadenador, pero solo después de que la conexión se haya creado correctamente. Para evitar fallos, pegue la URL del webhook en su aplicación después de publicar su flujo de trabajo o el desencadenador se haya creado correctamente en UiPath Orchestrator.

Crear una conexión HTTP Webhook

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Select Add connection.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. 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.
6. Configurar la ubicación del desafío
   Elige cómo enviará el proveedor el token de desafío para que UiPath pueda responder correctamente:
   • Sin desafío : el proveedor no requiere un apretón de manos y puedes proceder a conectarte.
   • Parámetro de consulta (por ejemplo, ?challenge=...)
   • Cuerpo JSON (POST con { "challenge": "..." })
   • Encabezado (por ejemplo, X-Hub-Challenge)
7. Configure la verificación de desafío y conéctese
   Si el proveedor requiere un protocolo de enlace, introduce la verificació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.

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