Configurar una integración usando el Webhook genérico

Requisitos previos:  
  • Comprensión de la aplicación del remitente
  • Comprensión de JSON
  • Notificación de chat (webhook) la configuración en Genesys Cloud está completa (ver Agregar una integración de webhook)

Utilice el Webhook genérico para enviar chats automatizados a las salas de chat de Genesys Cloud desde una aplicación de su elección. El Webhook genérico escucha mensajes y luego publica actualizaciones según lo especificado por una carga útil JSON.

  1. Utilice la URL de Genesys Cloud como la URL de notificación de webhook.

    La ubicación del campo para ingresar esta URL depende de la aplicación. Consulte las instrucciones de la aplicación o comuníquese con su soporte para obtener ayuda con este paso.

  2. Configure la carga útil JSON con el siguiente formato:
    {
     "mensaje": "[mensaje aquí]",
     "metadatos": "[metadatos aquí]"
     }

    Un mapeo de webhook puede filtrar en un mensaje o en metadatos.

    • mensaje es obligatorio en JSON y especifica el tipo de mensaje que se debe escuchar.
    • metadatos es opcional y especifica etiquetas para escuchar que pueden no estar en el mensaje.
    Nota:  Genesys Cloud interpreta el mensaje propiedad de la carga útil JSON como rebaja, lo que permite una amplia flexibilidad para formatear los mensajes de chat.
  3. Configure una llamada para enviar la carga útil a la URL del webhook de Genesys Cloud.

    Esto debe ser un CORREO llamar usando REST.

Ejemplo

En este ejemplo, configuramos una aplicación para enviar notificaciones a una sala de chat para el personal de TI. Quieren saber cada vez que alguien inicia sesión en su red segura. La carga útil JSON se vería así:

{
 "mensaje": "** John Doe ** acaba de iniciar sesión en nuestra red segura",
 "metadatos": "registro de seguridad"
 }