Le créateur d’intégration est un outil puissant sans code qui vous permet de connecter votre agent IA à n’importe quelle API ou source de données, sans besoin de compétences techniques ou de programmation avancées. Cet article couvre les questions fréquentes au sujet du créateur d’intégration.
Cet article aborde les sujets suivants :
- Paramètres et données - Questions fréquentes
- Environnements - Questions fréquentes
- Fiches et carrousels - Questions fréquentes
- Authentification - Questions fréquentes
Articles connexes :
Paramètres et données - Questions fréquentes
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 utilisateur au début de la session et se poursuit par l’interaction avec l’agent IA, où les entrées, les réponses et les entités de contenu peuvent être capturées.
Lorsqu’une session de chat est initiée, surtout si l'utilisateur est connecté, certaines métadonnées sont automatiquement recueillies. Ces métadonnées incluent généralement des détails spécifiques à l’utilisateur, qui peuvent inclure les informations de compte ou d’utilisateur, l’ID de session, l’emplacement géographique, les horodatages, etc. Vous pouvez ensuite enregistrer ces données sous la forme d’une action de conversation.
Pendant la conversation, vous pouvez choisir de capturer certaines réponses (soit écrites en texte libre, soit envoyées avec des boutons) de l’utilisateur. Vous pouvez le faire soit avec :
- Un paramètre utilisant la fonctionnalité Recueillir le paramètre dans un bloc conditionnel
- Une entité de contenu
Ces paramètres peuvent ensuite être transférés à l’intégration et utilisés comme paramètres de la requête dans le point de terminaison de l’URL ou dans 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 transmises à l’intégration dans les paramètres de demande provenant de la conversation.
Voici un exemple d’ID utilisateur utilisé comme paramètre :
https://{{zendesk_subdomain}}.zendesk.com/api/v2/users/{{user_id}}
Entre les accolades doubles, 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, les données doivent être enregistrées dans la session sous la forme d’un paramètre comme expliqué ci-dessus, en recueillant le paramètre ou en enregistrant les métadonnées dans un paramètre des données de session. Les données doivent être enregistrées en tant que paramètre de requête dans le créateur d’intégration si elles proviennent de la conversation ou en tant que données/métadonnées de session pour être envoyées à l’API. Vous pouvez aussi envoyer dynamiquement ce paramètre 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 en tant que paramètres de session dans l’environnement (dans la plupart des cas, le scénario de réussite). Une fois que vous avez enregistré l’API et que cette dernière se trouve dans un scénario donné, vous pouvez accéder au paramètre de session et l’utiliser dans le message d’un agent IA ou comme paramètre pour un bloc conditionnel :
- Dans le message d’un agent IA, elle est indiquée sous le nom de {{parameterName}}.
- Dans un bloc conditionnel, l’accès se fait avec le nom du paramètre.
Comment envoyer les paramètres de la requête dans le corps ?
Pour envoyer un paramètre de requête dans le corps du message, vous devez l'inclure entre accolades doubles, comme ceci :
{{exampleParameter}}
Puis-je envoyer un tableau dans le corps de la demande ?
Oui, vous pouvez sélectionner le type de données sous la forme d’un tableau lorsque vous définissez vos paramètres de demande. Quand vous testez, 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 si elle était JSON.
Dans ce cas, nous prenons une chaîne incluse dans un tableau et utilisons $eval() pour l’analyser en tant que tableau. L’utilisation la plus courante concerne l'envoi d'un ensemble de commandes.
Lors des tests, pourquoi est-ce que je ne reçois aucun paramètre de requête ou des paramètres incorrects ?
À des fins de test, vous devez utiliser une valeur test qui correspond à de vraies données dans 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 n’arrivez pas à voir le paramètre et la valeur dans les données de session lors du test, vérifiez que vous les capturez et les enregistrez comme étant le bon paramètre dans la boîte de dialogue.
N’oubliez pas que les données de session supprimées ne s’affichent pas dans les journaux des conversations. Dans ce cas, vous devrez peut-être les connecter temporairement à un message de l'agent IA pour résoudre le problème.
Pourquoi est-ce que je vois [Objet, objet] ?
Si vous voyez [Objet, objet], cela signifie que vous essayez de sortir un objet, mais que le système n’a pas de façon structurée de l’afficher. Pour résoudre ce problème, vous devez convertir l’objet dans un format de chaîne.
Consignez-vous les appels réussis ?
Non, pour des raisons d'ICP et de RGPD , nous n’enregistrons pas les appels de données réussis. Nous consignerons les appels ayant échoué afin de fournir plus d’informations sur ce qui s’est mal passé pendant la résolution de problèmes, si nécessaire.
Environnements - Questions fréquentes
Pourquoi ai-je besoin de différents environnements ?
Lorsque vous testez votre intégration, il peut être judicieux de ne pas utiliser de données réelles ou en direct. Si vous avez accès à une sandbox, un environnement de simulation ou de développement (nous vous conseillons de vous renseigner auprès de votre équipe technique ou de la documentation de l’API), vous pouvez le configurer dans le créateur d’intégration.
Les environnements partagent les paramètres de la requête et les sorties. Cependant, ils diffèrent par les points de terminaison et les détails d’authentification. Dans le créateur de dialogue, vous pouvez facilement changer d’environnement sur le nœud d’API. Cela signifie que vous n’avez besoin de créer qu’une seule boîte de dialogue pour les tests et que vous pouvez ensuite passer à un environnement de production quand vous êtes prêt à utiliser l’intégration.
Fiches et carrousels - Questions fréquentes
Dois-je définir un nombre de fiches maximum ?
Pour l’intégration Sunshine Conversations, il y a un maximum de 10 fiches.
Nous vous suggérons de limiter le nombre de fiches dans un carrousel à 9, ou 8 fiches avec une fiche de remplacement. Une carte de remplacement permet à l’utilisateur de quitter le carrousel (par exemple, s’il ne voit pas son élément).
Dois-je afficher les images sur les cartes dans un carrousel ?
Oui, l’image est un champ de données obligatoire. Vous pouvez remplir le champ d’image avec un lien d’image générique si vous n’avez pas besoin d’images dynamiques (p. ex. une image par produit).
Authentification - Questions fréquentes
Quelles méthodes d’authentification puis-je utiliser ?
Vous pouvez utiliser les méthodes d’authentification suivantes :
- Clé API
- Token du porteur
- Token d’expiration
- Authentification de base
- OAuth 2.0
- IP de listes autorisées
Pour commencer à utiliser l’authentification pour le créateur d’intégration, consultez Spécifications techniques pour l’intégration.
Puis-je créer une intégration avec un point de terminaison de la liste autorisée ?
Oui. Pour ce faire, vous devez ajouter nos adresses IP à votre liste autorisée. Pour obtenir une liste des adresses IP, consultez Autoriser les adresses IP à connecter les agents IA avancés à votre CRM.
Qu’est-ce qu’une intégration avec authentification uniquement et quand en ai-je besoin ?
Pour en savoir plus sur les intégrations avec authentification uniquement, consultez Utilisation de l’autorisation personnalisée avec le créateur d’intégration.
Puis-je mettre en place des limites de débit et des blocages ?
Nous n’imposons pas directement de limites de débit ou de blocages. Les limites de débit sont généralement appliquées par les systèmes ou API que nous intégrons, comme votre système backend. Ces limites dépendent de la configuration de votre backend.
Que se passe-t-il si mon API met plus de 9 secondes à répondre ?
Le module supplémentaire Agents IA - avancé applique un délai de 9 secondes pour les réponses API. Si votre API ne fournit pas de réponse dans les délais, la demande expire et renvoie l’erreur ECONNABORTED. En outre, les délais de réponse plus longs peuvent avoir un impact négatif sur l’expérience utilisateur, car ces derniers peuvent trouver frustrant d’attendre pour obtenir des informations.
Pour résoudre ce problème, si vous pensez que certaines réponses d’API prendront plus de 9 secondes, nous vous conseillons d’effectuer les appels d’API nécessaires au début de la conversation, si possible (par exemple, lors de l’événement Début de la conversation) et de stocker les informations pertinentes dans la séance. Cela garantit que les données sont prêtes quand vous en avez besoin et évite ainsi les retards dans le flux de conversation.