Mon édition
Suite, toutes les versions Team, Growth, Professional, Enterprise ou Enterprise Plus
Support Team, Professional ou Enterprise

Une fausse intégration permet d’ajouter des fonctionnalités personnalisées à des dialogues en utilisant des données déjà présentes dans la conversation, sans effectuer de réels appels d’API ni récupérer de données externes. Cela vous permet de mettre en place une logique utilisant JSONata pour la manipulation des données, ou d’autres tâches au sein du workflow de dialogue.

Ce type d’intégration est utile pour traiter des tâches qui n’ont pas besoin de données externes en temps réel, agissant comme une « assistance » pour étendre les capacités des agents IA au-delà des fonctionnalités courantes.

Cet article aborde les sujets suivants :

  • À propos des fausses intégrations
  • Création d’une fausse intégration
  • Ajout d’une fausse intégration au sein d’un dialogue

À propos des fausses intégrations

Une fausse intégration s’avère utile si vous souhaitez traiter ou manipuler des données déjà disponibles au sein d’une conversation. Par exemple, vous pouvez effectuer ce qui suit à l’aide d’une fausse intégration :

  • Convertir vos données en un format plus approprié.
  • Formater et filtrer des données CRM ou API complexes.
  • Comparer des dates pour trouver la plus récente.
  • Récupérer le jour et l’heure actuels.
  • Vérifier si la date est comprise dans une période donnée.
  • Vérifier si une URL contient des mots spécifiques.
  • Rechercher et remplacer des valeurs nulles.
  • Remplacer des lettres et des symboles dans vos données.
  • Utiliser un filtre non sensible à la casse (maj/min) pour explorer les données et renvoyer la première valeur correspondante, ou fournir une réponse de remplacement s’il n’y a aucune correspondance.

Si vous êtes capable de définir une logique à l’aide de JSONata, vous pouvez alors améliorer vos conversations grâce à ces intégrations utiles.

Création d’une fausse intégration

Conseil : avant de créer toute fausse intégration, nous vous suggérons de vous familiariser avec l’emploi de JSONata avec le créateur d’intégration. Consultez Utilisation de JSONata avec les agents IA.

Pour créer une fausse intégration, créez une intégration d’API comme vous le faites d’habitude. Notez qu’aucune demande de données n’est nécessaire.

Pour créer une fausse intégration

  1. Dans le menu principal, cliquez sur Intégrations API.
  2. En haut à droite, cliquez sur Ajouter une intégration.
  3. Dans la fenêtre Ajouter une intégration :
    1. Dans le champ Nom de l’intégration, donnez un nom parlant à votre intégration.
    2. (Facultatif) Dans le champ Description, saisissez une description pour l’intégration, qui vous rappellera à quoi elle sert.
    3. Cliquez sur Enregistrer.
  4. Dans la barre latérale de gauche, sous Environnements, sélectionnez un environnement (Production, par exemple).
  5. Définissez Type de méthode sur GET.
  6. Dans le champ URL, saisissez une URL factice (par exemple, https://dummyjson.com/http/200).

    • Remarque – Étant donné que les fausses intégrations sont hébergées dans le cadre de l’intégration, elles doivent pointer sur une URL valide. L’exemple ci-dessus utilise https://dummyjson.com/http/200, mais sa disponibilité n’est pas garantie. Vous pouvez utiliser l’URL factice qui vous convient le mieux. Même si un appel d’API sera émis vers l’URL spécifiée, aucune donnée provenant de la réponse ne sera traitée dans la fausse intégration.

  7. Veillez à bien définir le Type d’autorisation sur Pas d’autorisation.
  8. (Facultatif) Dans la barre latérale de gauche, sous Scénarios, passez la souris sur Échec, sélectionnez le menu d’options () et sélectionnez Supprimer. Vous n’avez pas besoin d’un scénario d’échec pour une fausse intégration.
  9. Dans la barre latérale de gauche, sous Scénarios, sélectionnez Réussite.
  10. Choisissez une méthode (selon votre type de scénario) :
    • Si vous avez une requête simple, saisissez-la dans le champ Requête de scénario. Par exemple, si vous avez juste besoin d’une réponse booléenne, cette requête suffit.
    • Si vous avez par contre besoin de définir une logique basée sur les paramètres de la requête (provenant de la conversation) :
      1. Saisissez requestParameters dans le champ Requête Scénario.
      2. Sous Paramètres de session, saisissez les paramètres de votre fausse intégration. La capture d’écran ci-après inclut des exemples de paramètres et des expressions JSONata qui renverront le jour de la semaine et l’heure actuelle.
  11. Cliquez sur Enregistrer.

Ajout d’une fausse intégration au sein d’un dialogue

Dans le Créateur de dialogue, vous pouvez ajouter un bloc d’intégration API et sélectionner votre fausse intégration.

Pour ajoute une fausse intégration au sein d’un dialogue

  1. En haut à droite, utilisez le champ déroulant des agents IA pour sélectionner l’agent IA dont vous voulez modifier le dialogue.
  2. Dans le menu principal sur la gauche, sélectionnez Contenu > Intentions.
  3. Sélectionnez l’intention pour laquelle vous voulez modifier le dialogue.
  4. Sélectionnez l’onglet Réponses.
  5. Sélectionnez la réponse à modifier pour le dialogue, puis cliquez sur Modifier le dialogue.
  6. Cliquez sur l’icône Plus (+) au bon endroit dans le dialogue et ajoutez un bloc Intégration d’API.
  7. Sélectionnez la fausse intégration que vous avez créée ci-dessus.

Désormais, lorsque la fausse intégration est sollicitée dans la conversation, votre fausse intégration d’API sera appelée et les paramètres de session que vous avez définis seront disponibles pour le dialogue. L’exemple ci-après montre une fausse intégration intégrée à un bloc conditionnel en utilisant les paramètres day-of-week-based renvoyés par la fausse intégration.

 

Réalisé par Zendesk