Configurer une intégration à l’aide du Webhook générique

Conditions préalables:  
  • Compréhension de l’expéditeur application
  • Compréhension de JSON
  • Notification de chat ( webhook ) la configuration dans Genesys Cloud est terminée (voir Ajouter une intégration de webhook)

Utilisez le Webhook générique pour envoyer des discussions automatisées aux salles de discussion Genesys Cloud à partir d'une application de votre choix. Le Webhook générique écoute les messages, puis publie les mises à jour comme spécifié par une charge utile JSON.

  1. Utilisez l’URL de Genesys Cloud comme URL de notification du webhook.

    L’emplacement du champ pour entrer cette URL dépend de application. Consultez les instructions de application ou contactez son assistance pour obtenir de l’aide sur cette étape.

  2. Configurez la charge JSON au format suivant :
    {
     "message": "[message here]",
     "metadata": "[metadata here]"
    }

    Un mappage webhook peut filtrer sur un message ou sur des métadonnées.

    • message est obligatoire dans le JSON et spécifie le type de message à écouter.
    • metadata est facultatif et spécifie les balises à écouter qui pourraient ne pas se trouver dans le message.
    Remarque :  Genesys Cloud interprète la propriété message de la charge utile JSON en tant que markdown, ce qui permet une grande flexibilité dans le formatage des messages de chat.
  3. Configurez un appel pour fournir la charge utile à l’URL du webhook Genesys Cloud.

    Il doit s'agir d'un appel POST utilisant REST.

Exemple

Dans cet exemple, nous avons configuré un application pour envoyer des notifications à un salle de chat pour le personnel informatique. Ils veulent savoir chaque fois que quelqu’un se connecte à leur réseau sécurisé. La charge JSON ressemblerait à ceci :

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