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 is required in the JSON and specifies the type of message to listen for.
    • metadata is optional and specifies tags to listen for that might not be in the message.
    Note:  Genesys Cloud interprets the message property of the JSON payload as markdown, allowing broad flexibility for formatting chat messages.
  3. Configure una llamada para enviar la carga útil a la URL del webhook de Genesys Cloud.

    This must be a POST call using 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"
}