Crear disparadores para filtrar eventos por webhook

Puede crear un disparador para filtrar eventos personalizados que se generan para mensajes de webhook en Genesys Cloud. Estos eventos se generan cuando la integración webhook para eventos de Genesys Cloud recibe invocaciones webhook en la URL de invocación especificada en la configuración de la integración. 

Cuando usted crear un disparador para un mensaje webhook, seleccione las siguientes opciones:

  • El nombre del tema v2.integrations.inbound.webhook.{id}.invocation de la lista.
  • El flujo de trabajo a iniciar para el evento.
  • La condición que identifica el mensaje webhook. Por ejemplo, utilice el Webhookid que obtuvo cuando añadió el Webhook para la integración de Eventos.

Esta imagen muestra un ejemplo de los detalles de activación para eventos Webhook:

Esta imagen es una captura de pantalla del disparador creado para Webhook para la integración de eventos. La captura de pantalla muestra el evento webhook con la condición para filtrar el Webhook Id.

A continuación se muestra un ejemplo de formato de la carga útil del Webhook:

Esta imagen es una captura de pantalla de la carga útil del webhook.

En el disparador, utilice una expresión JSON Path como $.body.{{foo}} con un operador que contenga o iguale el valor y permita al disparador filtrar en función del contenido del mensaje webhook. Como en el ejemplo de carga útil, cuando $.body.someKey contiene someValue, se cumplen los criterios de coincidencia y el disparador invoca el flujo de trabajo configurado.

Nota: La estructura real del cuerpo de su invocación webhook es definida por el sistema que envía el mensaje webhook. Si debe filtrar basándose en el contenido del mensaje webhook, la ruta JSON exacta que utilice dependerá de esta estructura.

Para acceder al atributo someKey dentro del cuerpo de invocación del webhook, debe utilizar la expresión similar a ToString(Flow.jsonData.webhooksInvocation.body.someKey) en el Architect. Esta función primero analiza el JSON del mensaje webhook. A continuación, navega hasta el elemento body para obtener el atributo someKey y utilizarlo dentro del flujo actual.

Nota: La estructura real del cuerpo de su invocación webhook es definida por el sistema que envía el mensaje webhook. Si debe filtrar basándose en el contenido del mensaje webhook, la ruta JSON específica que utilice dependerá directamente de cómo estructure sus datos el sistema.