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:
    {
     "message": "[message here]",
     "metadata": "[metadata here]"
    }

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

    • message se requiere en el JSON y especifica el tipo de mensaje a escuchar.
    • metadata es opcional y especifica etiquetas a las que prestar atención que podrían no estar en el mensaje.
    Nota:  Genesys Cloud interpreta la propiedad message de la carga útil JSON como markdown, lo que permite una amplia flexibilidad para dar formato a los mensajes de chat.
  3. Configure una llamada para enviar la carga útil a la URL del webhook de Genesys Cloud.

    Debe ser una llamada a POST utilizando 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í:

{
 "message": "**John Doe** just logged into our secure network.",
 "metadata": "security log"
}