Le créateur d’intégration est un outil puissant, qui ne nécessite aucun code et vous permet de connecter votre agent IA à n’importe quelle API ou source de données, sans compétences techniques ou de programmation particulières. Cet article couvre les questions fréquentes portant sur le créateur d’intégration.
Cet article aborde les sujets suivants :
- Questions fréquentes sur les paramètres et les données
- Questions fréquentes sur les environnements
- Questions fréquentes sur les fiches et les carrousels
- Questions fréquentes sur l’authentification
Articles connexes :
Questions fréquentes sur les paramètres et les données
Comment les données de session de la conversation sont-elles recueillies ?
Le recueil des données de session dans les conversations de l’agent IA commence par la capture automatique des métadonnées de l’utilisateur au début de la session et continue pendant toute l’interaction avec l’agent IA, pendant laquelle les saisies, les réponses et les entités peuvent être capturées.
Quand une session de chat est initiée, surtout si l’utilisateur est connecté, certaines métadonnées sont automatiquement recueillies. Les métadonnées incluent généralement les détails spécifiques de l’utilisateur (qui peuvent comprendre l’identifiant de l’utilisateur ou les informations de compte), l’identifiant de la session, l’emplacement, les horodatages, etc. Ces données peuvent être enregistrées sous la forme d’une action de conversation.
Pendant la conversation, vous pouvez choisir de capturer certaines réponses (qu’elles soient écrites en texte libre ou envoyées via des boutons) de l’utilisateur. Vous pouvez le faire de deux façons :
- Un paramètre utilisant le paramètre « Recueillir le paramètre » dans un bloc conditionnel
- Une entité
Ces paramètres peuvent alors être transférés à l’intégration et utilisés comme paramètres de demande dans le point de terminaison de l’URL ou le corps de la demande.
Qu’est-ce qu’un paramètre d’URL et comment l’utiliser ?
Un paramètre d’URL est un paramètre dynamique dans l’URL qui change en fonction des informations transférées à l’intégration via les paramètres de demande provenant de la conversation.
Voici un exemple d’identifiant de l’utilisateur utilisé comme paramètre :
https://{{zendesk_subdomain}}.zendesk.com/api/v2/users/{{user_id}}Dans les doubles accolades, le paramètre user_id est ajouté à l’URL.
Comment accéder aux données de la conversation pour les utiliser dans l’API ?
Pour utiliser les données de la conversation, ces données doivent être enregistrées dans la session sous la forme d’un paramètre comme décrit ci-dessus, soit en collectant le paramètre soit en enregistrant les métadonnées dans un paramètre dans les sessions de données. Les données doivent être enregistrées sous la forme d’un paramètre de demande dans le créateur d’intégration si elles proviennent de la conversation ou sous la forme de données/métadonnées de session à envoyer à l’API. Vous pouvez alors également envoyer ce paramètre dynamiquement dans le corps de la demande.
Comment accéder aux paramètres ou aux données de la réponse API pour les utiliser dans la conversation ?
Pour utiliser les paramètres ou les données de la réponse API, vous devez les enregistrer comme paramètre de session dans l’environnement (dans la plupart des cas, le scénario de réussite). Une fois ces paramètres ou données enregistrés, quand l’API se retrouve dans un scénario donné, vous pouvez accéder au paramètre de session et l’utiliser dans un message de l’agent IA ou comme paramètre pour un bloc conditionnel :
- Dans un message de l’agent IA, l’accès se fait via {{parameterName}}.
- Dans un bloc conditionnel, l’accès se fait via le nom du paramètre.
Comment envoyer des paramètres de demande dans le corps de la demande ?
Pour envoyer un paramètre de demande dans le corps de la demande, vous devez inclure les doubles accolades, comme suit :
{{exampleParameter}}Puis-je envoyer un tableau dans le corps de la demande ?
Oui, vous pouvez sélectionner le type de données Tableau quand vous définissez vos paramètres de demande. Quand vous effectuez des tests, n’oubliez pas de reformater la valeur avec la fonction JSONata $eval($). La fonction eval analyse et évalue une chaîne contenant soit une expression JSON soit une expression JSONata comme s’il s’agissait d’une expression JSON.
Dans ce cas, nous prenons une chaîne incluse à un tableau et nous utilisons $eval() pour l’analyser comme un tableau. Le cas d’utilisation le plus courant est l’envoi d’un tableau de commandes.
Quand j’effectue des tests, pourquoi est-ce que je ne reçois pas de paramètres de demande ou des paramètres incorrects ?
Dans le cadre des tests, vous devez utiliser une valeur test qui correspond aux données réelles de votre point de terminaison pour votre paramètre de demande dans le créateur d’intégration. Cependant, dans une conversation en direct, la valeur de ce paramètre provient de la conversation. Si vous ne pouvez pas voir le paramètre et la valeur dans les données de session que vous testez, vérifiez que vous les capturez et les enregistrez comme le paramètre correct dans le dialogue.
N’oubliez pas que les données de session nettoyées n’apparaissent pas dans les journaux de conversation. Dans ce cas, vous devrez peut-être les consigner temporairement dans un message de l’agent IA que vous déboguerez.
Pourquoi est-ce que je vois [Object, object] ?
Si vous voyez [Object, object], cela signifie que vous essayez d’afficher un objet, mais que le système n’a pas de manière structurée de l’afficher. Pour résoudre ce problème, vous devez convertir l’objet en format chaîne.
Les appels qui se sont soldés par une réussite sont-ils consignés ?
Non, pour des raisons portant sur les ICP et le RGPD, nous ne consignons pas les données des appels qui se sont soldés par une réussite. Nous consignons les appels qui se sont soldés par un échec pour pouvoir fournir plus d’informations sur le problème lors du dépannage, si besoin est.
Questions fréquentes sur les environnements
Pourquoi ai-je besoin de différents environnements ?
Quand vous testez votre intégration, il est possible que vous ne vouliez pas utiliser de données réelles ou en direct. Si vous avez accès à un environnement de sandbox, de simulation ou de développement (nous vous conseillons de consulter votre équipe technique ou la documentation de l’API pour le savoir), vous pouvez le configurer dans le créateur d’intégration.
Les environnements partagent les paramètres de demande et les sorties. Cependant, leurs points de terminaison et leurs détails d’authentification sont différents. Dans le créateur de dialogue, vous pouvez facilement passer d’un environnement à un autre dans le nœud API. Cela signifie qu’il vous suffit de créer un seul dialogue quand vous effectuez des tests, puis vous pouvez passer à un environnement de production quand vous êtes prêt à publier l’intégration.
Questions fréquentes sur les fiches et les carrousels
Dois-je définir un nombre de fiches maximum ?
Pour l’intégration Sunshine Conversations, il y a un maximum de 10 fiches.
Dans les carrousels, nous vous conseillons d’utiliser au maximum 9 fiches, ou 8 fiches avec une fiche de repli. Une fiche de repli permet à l’utilisateur de quitter le carrousel (s’il ne voit pas ce qu’il cherche, par exemple).
Est-ce que je dois afficher des images sur les fiches dans un carrousel ?
Oui, l’image est un champ de données obligatoire. Vous pouvez remplir ce champ avec un lien d’image générique si vous n’avez pas besoin d’images dynamiques (une image par produit, par exemple).
Questions fréquentes sur l’authentification
Quelles méthodes d’authentification est-ce que je peux utiliser ?
Vous pouvez utiliser les méthodes d’authentification suivantes :
- Clé API
- Token du porteur
- Token d’expiration
- Authentification de base
- OAuth 2.0
- Listes d’adresses IP autorisées
Pour en savoir plus sur l’authentification pour le créateur d’intégration, consultez Configuration technique requise pour les intégrations.
Puis-je créer une intégration avec le point de terminaison d’une liste autorisée ?
Oui. Pour ce faire, vous devez ajouter vos adresses IP à la liste autorisée. Pour une liste des adresses IP, consultez Autoriser les adresses IP à connecter les agents IA à votre CRM.
Qu’est-ce qu’une intégration Authentification uniquement et quand en ai-je besoin ?
Pour en savoir plus sur les intégrations Authentification uniquement, consultez Utilisation de l’autorisation personnalisée avec le créateur d’intégration.
Est-ce que je peux implémenter des limites et la régulation du débit ?
Nous n’imposons pas directement de limites ni de régulation du débit. Les limites de débit sont généralement appliquées par les systèmes ou les API auxquels vous vous intégrez, comme votre système backend. Ces limites dépendent de la configuration de votre système backend.
Que se passe-t-il si mon API prend plus de 9 secondes pour répondre ?
L’espace de travail des agents IA applique un délai d’expiration de 9 secondes pour les réponses API. Si votre API ne répond pas dans ce délai, la demande expire et renvoie l’erreur ECONNABORTED. En outre, les temps de réponse plus longs peuvent avoir un impact négatif sur l’expérience client, car les utilisateurs risquent de trouver frustrant de devoir attendre des informations.
Pour résoudre ce problème potentiel, si vous pensez que certaines réponses API prendront plus de 9 secondes, nous vous conseillons de réaliser les appels API nécessaires au début de la conversation si possible (par exemple, au moment de l’événement Chat commencé) et de stocker les informations pertinentes dans la session. Cela garantit que les données sont prêtes quand vous en avez besoin, ce qui évite les délais dans le workflow de conversation.