Configuración de la carga útil del webhook

Un webhook payload son los datos que se reciben de un sistema externo a un webhook URL en webMethods Integration cuando se produce un evento. Esta carga útil suele estar en formato JSON y contiene pares clave-valor que representan los detalles del evento o los datos que desea procesar.

Acerca de esta tarea

Configurar la carga útil ayuda a webMethods Integration comprender la estructura de los datos entrantes para poder asignarlos correctamente a las variables de su flujo de trabajo. Puede añadir una carga útil para un webhook utilizando la opción de carga útil del webhook. La estructura de la carga útil que añadas aquí debe ser similar a la que se espera que reciba el webhook en el futuro. webMethods Integration utiliza estos datos para mostrar la salida del webhook en las acciones posteriores de su flujo de trabajo.

Nota:
  • Haga clic en Carga útil del webhook y datos de registro para obtener información sobre la carga útil máxima del webhook y los datos de registro que se admiten en Amazon Web Services y Microsoft Azure.
  • Los datos de carga útil del webhook que se añaden en el flujo de trabajo de origen no se conservan cuando el flujo de trabajo se clona, importa o despliega. Es necesario reconfigurar la configuración del webhook en cada flujo de trabajo clonado, importado y desplegado.

Procedimiento

  1. Para configurar la carga útil del webhook, seleccione el activador del webhook y haga clic en Siguiente.

    A continuación se indican las opciones a través de las cuales puede añadir la carga útil del webhook:

    Obtención automática de la carga útil del Webhook
    Puede utilizar este método para enviar cargas útiles de webhooks en tiempo real a través de cualquier herramienta que admita el envío de solicitudes HTTP o un navegador. Ofrece la flexibilidad de enviar datos personalizados en tiempo real cuando se envían solicitudes al webhook. Puede utilizar cualquier aplicación que admita llamadas a la API REST, como Postman o un navegador.
    Añadir carga útil Webhook manualmente
    Puede utilizar este método para añadir manualmente los datos de carga útil del webhook. Sin embargo, debes asegurarte de que la estructura de la carga útil que añades es similar a la que se espera que reciba el webhook en el futuro. webMethods Integration utiliza estos datos para mostrar la salida del webhook en las acciones posteriores de su flujo de trabajo.
  2. Realice los siguientes pasos para recuperar la carga útil del webhook automáticamente.
    Nota: Si desea añadir la carga útil del webhook manualmente, omita este paso y vaya al paso 3.
    1. Copie el webhook generado aleatoriamente URL.
    2. Pega este webhook URL en cualquier proveedor de webhook que pueda enviar peticiones POST.
    3. Introduzca los datos necesarios en Encabezados y Cuerpo y pulse el botón Enviar.
      Nota: Sólo se admite JSON. Cuando configure la solicitud, proporcione el cuerpo de la solicitud en formato JSON y establezca el tipo de contenido en JSON (Application/JSON).
    4. Vuelva a la página de configuración de Webhook en webMethods Integration y haga clic en Fetch para recuperar los datos de carga útil del webhook.
      Los campos Encabezado, Cuerpo y Consulta se rellenan automáticamente con los datos enviados.
    5. Pulse Siguiente.
  3. Realice los siguientes pasos para añadir datos de carga útil de webhook manualmente
    1. En la página Webhook, introduzca los datos de la carga útil en los campos de texto, Cabeceras, Cuerpo y Consulta, en formato JSON.
    2. Pulse Siguiente.

Qué hacer a continuación

Una vez configurados los datos de la carga útil, puede establecer un método de autenticación para mejorar la seguridad del webhook.