Envoyer des données à une API à l'aide d'Oracle Infinity Streams (hérité)

Introduction

Ce tutoriel décrit la collecte de données dans Infinity et l'envoi à une API d'exemple (à l'aide de Streams (Legacy) et d'Action Center (Legacy) Webhooks) pour un cas d'utilisation fictif de réduction des volumes de centre d'appels.

Qu'est-ce qu'un webhook ? : un webhook est un moyen d'envoyer des données à une adresse en temps réel (par exemple, en envoyant des données de conversion à une API externe).

Objectifs

Dans ce didacticiel, vous allez remplir un cas d'utilisation fictif d'envoyer par courriel un contenu d'aide pertinent aux clients lorsqu'ils cliquent sur le lien "Nous contacter" de votre site Web afin de réduire le nombre de requêtes auxquelles votre centre de contact doit faire face.

Vous allez :

Reportez-vous au diagramme suivant pour une illustration du cas d'utilisation fictif :

Illustration du cas d'emploi

Image montrant où sélectionner une région.

Prérequis

Créer une adresse de simulation

Nous allons créer un point de terminaison fictif pour recevoir nos données Infinity (représentant l'API d'une plate-forme de messagerie pour le déclenchement des e-mails). Nous utiliserons Beeceptor pour notre point de terminaison de simulation.

  1. Accédez à Sélecteur, entrez le nom de votre adresse, puis cliquez sur Créer une adresse.

    Choisir un nom d'adresse unique pour ce tutoriel

    Image montrant où sélectionner une région.

  2. Copiez l'URL endpoint à l'aide de l'option Cliquez pour copier.

    Lorsque vous ouvrez l'URL du point de terminaison dans une autre fenêtre/un autre onglet, les demandes doivent apparaître dans la fenêtre/l'onglet du sélecteur existant :

    Demandes dans la fenêtre du récepteur d'origine

    Image montrant où sélectionner une région.

  3. Testez votre adresse.

    Accédez à l'URL endpoint que vous avez copiée dans la nouvelle fenêtre/onglet du navigateur pour vérifier qu'elle reçoit correctement des données.

    Copier dans le presse-papiers

    Image montrant où sélectionner une région.

Création d'une connexion de webhook dans le centre d'actions (héritée)

Une connexion de webhook est requise pour envoyer des données à l'adresse de simulation que vous venez de créer.

  1. Ouvrez l'interface utilisateur Oracle Infinity.

  2. Cliquez sur le menu en haut à gauche et accédez à Action Center.

  3. Cliquez sur Gérer les connexions (en haut à droite).

  4. Cliquez sur +New Connection > Webhook (en haut à gauche).

  5. Entrez les détails de l'adresse.

    • Nom : My Email platform.

    • Protocole de connexion : sélectionnez HTTP.

    • Sécurisé (HTTPS/WSS) : cochez cette case.

    • FQDN du serveur : entrez l'adresse du récepteur dans le presse-papiers (moins https://). Par exemple, YOURENDPOINT.free.beeceptor.com.

    • Port : 443

    • Type d'authentification : None

      Détails de connexion

    Image montrant où sélectionner une région.

  6. Cliquez sur Connexion.

Créer une destination dans votre connexion

Une destination dans une connexion vous permet de formater les données avant de les envoyer à un emplacement spécifique de votre connexion.

  1. Sélectionnez votre connexion, puis cliquez sur Nouveau sous Destinations.

  2. Entrez les informations suivantes :

    • Nom : Website Actions
    • Adresse URI : / (utilisé pour envoyer des messages à un chemin facultatif sur votre adresse (par exemple, myinfinitytest.free.beeceptor.com/ avec / à la fin, ce que vous indiquez ici).
    • Groupement d'événements : Single
    • Méthode HTTP : POST
    • Contenu/Type de données traitées : application/json
    • Formateur de demande : Twig

  3. Collez le modèle de code suivant dans le modèle de demande de migration :

    \{\% autoescape 'json' \%\}
{
 "customer_id":"\{\{events[0]['customer_id']\}\}",
 "event_name":"\{\{events[0]['event_name']\}\}"
}
\{\% endautoescape \%\}

    Qu'est-ce que Twig ? : Twig est un langage de modélisation qui permet de manipuler les données traitées avant de les envoyer à votre adresse. Le formatage de vos données traitées est très puissant pour que le format de votre adresse soit correct.

    Détails de la destination

    Image montrant où sélectionner une région.

  4. Cliquez sur Enregistrer.

Créer un flux

Vous devez créer, tester et enregistrer un flux (hérité) pour capturer lorsque nous simulons un utilisateur en cliquant sur le bouton Nous contacter dans notre cas d'utilisation fictif afin de pouvoir l'envoyer à notre point d'extrémité de simulation.

  1. Construire le flux

    Nous allons créer un flux en écrivant une requête à la recherche d'utilisateurs qui cliquent sur le bouton Nous contacter (événement que nous simulerons ultérieurement) :

    • Dans l'interface utilisateur d'Oracle Infinity, cliquez sur le menu en haut à gauche et accédez à Streams.
    • Collez la requête suivante en tant que requête : data.wt.event_name AS 'event_name',data.wt.dcsvid AS 'customer_id' WHERE data.wt.event_name='contact us' AND Exists(data.wt.dcsvid) AND session.closed='false'.
    • Appuyez sur Start.

    Définition de la requête

    Image montrant où sélectionner une région.

    Requête - Explication :

    La première partie de l'instruction est un SELECT dont les champs doivent être affichés dans le flux. Il s'agit des valeurs wt.event_name (Nom de l'événement) et wt.dcsvid (ID client) actuelles.

    Les deux paramètres sélectionnés avec SELECT utilisent l'option Alias en déclarant AS afin de pouvoir les déclarer comme event_name et customer_id (cela simplifie la création de notre action dans une étape ultérieure).

    WHERE qui détermine quand le flux doit déclencher une action. Cela se produit lorsque l'événement contient wt.event_name='contact us' AND et wt.dcsvid (ID client). En outre, nous devons utiliser session.closed=false pour autoriser le déclenchement immédiat de l'action (pas d'attente avant la fin de la session).

    Syntaxe de requête de flux : reportez-vous au centre d'aide Oracle Infinity - Streams pour obtenir la prise en charge complète de la syntaxe de requête.

  2. Tester le flux de données

    Nous validerons les données entrantes dans notre flux en simulant un clic sur le bouton Nous contacter et en vérifiant si les données entrantes sont visibles :

    • Accédez à votre site Web avec le suivi Infinity implémenté (par exemple, à l'aide de la balise Oracle CX)
    • Ouvrez la console du navigateur (par exemple, la console Outils de développeur dans Google Chrome).
    • Copiez le code suivant et collez-le dans la console du navigateur :
    	var cxDataObject = {	
	"wt.event_name":"contact us", // Sample Custom Variable
	"wt.dcsvid":"MYCUSTOMERID"
	}

	// DO NOT EDIT BELOW THIS LINE - ORA.click()
	window.ORA = window.ORA || {productReady: []};
	ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);

    MYCUSTOMERID : cette valeur représente l'ID du client dans un déploiement réel. Dans notre cas d'utilisation fictif, voici ce qu'une plate-forme de messagerie utiliserait pour savoir à qui envoyer un message par courriel.

    Exemple de page avec code et demande dcs.gif Infinity résultante dans l'onglet Réseau

    Image montrant où sélectionner une région.

  3. Enregistrer votre flux

    Enregistrez votre flux de données maintenant que nous l'avons validé fonctionne correctement :

    • Faites glisser tous les paramètres du côté gauche sur le canevas principal :

      Déplacement des paramètres

      Glisser les paramètres.

    • Cliquez sur Enregistrer le flux et attribuez-lui un nom, tel que Nous contacter.

Créez votre action

Nous pouvons désormais créer l'action qui connectera Stream à votre connexion afin que les données apparaissent dans votre point d'extrémité de simulation.

  1. Dans l'interface utilisateur Oracle Infinity, cliquez sur le menu en haut à gauche et accédez à Action Center.

  2. Cliquez sur +Create Action.

  3. Complétez les champs suivants :

    • Nom : Contact Us - Email
    • Description : Sends Customer ID and Event Name upon Contact Us click
    • Tentative de renvoi : conservez le paramètre par défaut.

  4. Sous Destination, sélectionnez :

    • Webhook
    • Mon adresse de récepteur (ou tout ce que vous avez appelé votre connexion).
    • Cliquez sur Nous contacter (ou tout ce que vous avez appelé Destination).

  5. Sous Données, sélectionnez Nous contacter (ou tout ce que vous avez nommé votre flux de données), puis cliquez sur Enregistrer.

    Mes variables sont déjà mappées ? : Comme vous avez utilisé des alias dans votre requête, vous remarquerez que les paramètres que vous avez sélectionnés sont déjà mappés.

    Votre flux avec des mappages

    Glisser les paramètres.

    Que font les mappages de champs ? : Les noms event_name et customer_id que vous avez mis en correspondance sont ceux qui seront traités par le modèle Twig que vous avez configuré précédemment dans votre destination dans ce guide.

  6. Revenez au centre d'actions dans lequel vous devez voir votre nouvelle action.

  7. Cliquez sur Démarrer pour activer votre action.

Tester votre flux de données

Une fois la configuration terminée, vous pouvez envoyer des données à votre flux et recevoir la sortie dans votre point d'extrémité de simulation, en simulant le cas d'emploi fictif du centre d'appels.

  1. Ouvrez la fenêtre de réception d'origine, dans laquelle vous pouvez visualiser les demandes entrantes (par exemple, https://beeceptor.com/console/YOURNAMEOFMOCKENDPOINT).

  2. Ouvrir la page de test sur laquelle la balise Infinity/CX est active

  3. Déclenchez une autre demande conformément à l'étape 2 de la section Créer un flux :

    	var cxDataObject = {	
	"wt.event_name":"contact us", // Sample Custom Variable
	"wt.dcsvid":"MYCUSTOMERID"
	}

	// DO NOT EDIT BELOW THIS LINE - ORA.click()
	window.ORA = window.ORA || {productReady: []};
	ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);

Vous devriez maintenant voir les données affichées au sein de votre point d'extrémité de simulation, où le point d'extrémité de simulation simule la plate-forme de messagerie* recevant un signal entrant d'Infinity :

Vos données affichées dans votre point de terminaison de simulation

Image montrant où sélectionner une région.

*Environnement de production : dans un environnement de production, des données traitées plus complexes envoient des données à l'API d'une véritable plate-forme de messagerie. Toutefois, dans le cadre de ce tutoriel, nous n'utilisons qu'un point de terminaison de simulation pour afficher la fonctionnalité Infinity.

Ressources de formation supplémentaires

Explorez d'autres exercices sur docs.oracle.com/learn ou accédez à davantage de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez le site education.oracle.com/learning-explorer pour devenir Oracle Learning Explorer.

Pour consulter la documentation du produit, consultez le centre d'aide Oracle.