Utilisez cet article pour configurer les modèles de connecteurs de données Pendo, afin que Fin puisse voir ce que faisait un client dans votre produit avant qu'il ne demande de l'aide. Il couvre également ce que voient les clients, les limitations et comment résoudre les problèmes courants de configuration. Cet article s'adresse aux collègues qui configurent les connecteurs de données pour Fin. Vous aurez aussi besoin d'accès à l'Agent Toolkit de Pendo.
Qu'est-ce que les modèles de connecteurs de données Pendo ?
Les modèles de connecteurs de données Pendo sont 5 connecteurs de données prêts à l'emploi qui connectent Fin à l'Agent Toolkit de Pendo. Pendo enregistre comment les clients utilisent votre produit, y compris les pages visitées, les fonctionnalités utilisées, et où ils rencontrent des erreurs ou des frictions. Avec les modèles de connecteurs de données Pendo, Fin peut utiliser ce contexte pour personnaliser ses réponses et éviter les étapes déjà tentées par le client.
Pourquoi utiliser les modèles de connecteurs de données Pendo ?
Les modèles de connecteurs de données Pendo aident Fin à répondre aux questions produit sans demander au client d'expliquer ce qu'il a fait :
Commencez par le contexte : Fin voit l'activité récente de la session du client, donc le client n'a pas besoin de décrire ce qu'il faisait.
Indiquez le bon guide : Fin trouve le guide in-app Pendo qui correspond à une question pratique et partage un lien qui le lance.
Recueillez les retours produit : Fin peut soumettre des retours à Pendo au nom du client.
Évitez la construction manuelle : Les champs de requête, d'entrée et de réponse sont déjà configurés, vous n'avez donc pas à les créer manuellement.
Quels modèles de connecteurs de données Pendo sont disponibles ?
Ce tableau liste les 5 modèles de connecteurs de données Pendo dans le groupe de modèles « Pendo Agent Toolkit API », et ce que Fin obtient de chacun.
Modèle | Ce que Fin obtient |
Obtenir l'activité de session Pendo pour un visiteur | Un résumé et une chronologie de ce que le visiteur faisait récemment, incluant pages, éléments, paramètres, erreurs et frictions comme les clics morts. Fin transmet une courte description de la question du client, donc le résumé se concentre sur l'essentiel. |
Trouver un guide in-app Pendo | Le guide Pendo qui correspond le mieux à une question pratique, avec un lien qui lance le guide dans votre application. Fin partage ce lien avec le client. |
Obtenir l'activité des agents IA Pendo pour un visiteur | Les 3 conversations les plus récentes du visiteur avec vos agents IA intégrés au produit des 30 derniers jours, et les 3 problèmes les plus récents détectés, comme erreurs et hallucinations. Nécessite Pendo Agent Analytics. |
Lister les domaines produit Pendo | Chaque domaine produit dans votre abonnement Pendo, avec son ID et sa description. Fin utilise cela avant de soumettre des retours. |
Soumettre un retour Pendo pour un visiteur | Crée un élément de retour dans Pendo Feedback pour le visiteur, avec un titre, une description, un domaine produit optionnel, et un lien vers la conversation Intercom. Nécessite Pendo Feedback. |
Exemples de questions clients auxquelles les modèles de connecteurs de données Pendo aident Fin à répondre incluent :
Je reçois constamment une erreur lorsque j'essaie de sauvegarder mes paramètres.
Comment créer un nouveau tableau de bord ?
Votre assistant in-app m'a donné la mauvaise réponse.
Pouvez-vous transmettre une demande de fonctionnalité à votre équipe produit ?
Astuce : Associez les modèles de connecteurs de données Pendo aux Procédures Proactives pour démarrer une conversation Fin lorsque Pendo détecte des signes de frustration. Apprenez comment déclencher une procédure proactive depuis une API externe.
Que faut-il avant de configurer les modèles de connecteurs de données Pendo ?
Avant de configurer les modèles de connecteurs de données Pendo, assurez-vous d'avoir :
Accès à l'Agent Toolkit Pendo : Permission dans Pendo pour créer un agent et un compte de service.
Authentification client : Code à usage unique par email (OTP) ou sécurité Messenger avec JSON Web Tokens (JWT) configurés dans Intercom. Les connecteurs de données ne peuvent pas être activés sans cela. En savoir plus sur la configuration de l'authentification des connecteurs de données.
Correspondance des IDs visiteurs : L'ID visiteur Pendo de chaque client disponible dans Intercom, soit comme leur ID utilisateur Intercom, soit dans l'attribut pendoVisitorId.
Modules complémentaires Pendo pour 2 modèles : Pendo Agent Analytics pour l'activité des agents IA, et Pendo Feedback pour soumettre des retours.
Note : Les modèles de connecteurs de données Pendo supportent uniquement les applications web, et uniquement les clients connectés avec un ID visiteur Pendo. Les applications mobiles et extensions de navigateur ne sont pas encore supportées.
Comment configurer les modèles de connecteurs de données Pendo
Chaque modèle de connecteur de données Pendo crée son propre connecteur de données. Créez le compte de service Pendo une fois, puis répétez les étapes Intercom pour chaque modèle que vous souhaitez que Fin utilise.
Comment créer un compte de service Pendo pour Fin
Pour créer le compte de service Pendo utilisé par les modèles de connecteurs de données Pendo :
Dans Pendo, créez un agent Intercom Fin dans l'Agent Toolkit.
Créez un compte de service pour l'agent.
Copiez l'URL du token, l'ID client, le secret client et la portée. Vous les collerez dans Intercom lorsque vous ajouterez votre jeton d'authentification Pendo.
Comment créer un connecteur de données Pendo à partir d'un modèle
Pour créer un connecteur de données Pendo à partir d'un modèle dans Intercom :
Allez dans Paramètres > Intégrations > Connecteurs de données et cliquez sur Nouveau.
Sous Ou démarrez à partir d'un modèle, choisissez Pendo Agent Toolkit API.
Choisissez un modèle, lisez ce qu'il fait, puis cliquez sur Créer.
Un brouillon de connecteur de données Pendo s'ouvre avec les champs de requête, d'entrées et de réponse déjà remplis.
Comment ajouter votre jeton d'authentification Pendo
Pour ajouter votre jeton d'authentification Pendo à un connecteur de données Pendo :
Sous Authentication tokens, cliquez sur New token et choisissez le type OAuth (Open Authorization).
Collez l'URL du jeton, l'ID client, le secret client et la portée que vous avez copiés depuis Pendo.
Sélectionnez le jeton dans le connecteur de données.
Conseil : Lorsque vous configurez votre prochain modèle de connecteur de données Pendo, sélectionnez le même jeton d'authentification Pendo au lieu d'en créer un nouveau.
Comment définir les entrées de données Pendo
Pour définir les entrées de données pour un connecteur de données Pendo :
Sous Data inputs, cochez pendo_host. La valeur par défaut est
app.pendo.io. Si votre abonnement Pendo est hébergé dans la région EU, AU, Japon ou us1, changez sa Custom value pour l'hôte Pendo de votre région.Mappez l'entrée Visitor ID à l'attribut Intercom qui contient l'ID visiteur Pendo du client. Si votre ID utilisateur Intercom et l'ID visiteur Pendo correspondent, utilisez User ID. Sinon, synchronisez les IDs et utilisez l'attribut pendoVisitorId.
Si le modèle demande des paramètres d'équipe, comme votre ID d'application Pendo, ID d'agent ou nom d'hôte du lien guide, saisissez-les comme Custom values.
Note : Fin ne remplit jamais les paramètres d'équipe pour les modèles de connecteur de données Pendo, tels que votre ID d'application Pendo, ID d'agent ou nom d'hôte du lien guide. Seuls les coéquipiers définissent ces valeurs.
Comment tester un connecteur de données Pendo et le mettre en service
Pour tester un connecteur de données Pendo et permettre à Fin de l'utiliser :
Testez le connecteur de données avec l'ID visiteur d'un client test ayant une activité récente dans Pendo.
Dans l'onglet Fin, sous How should Fin use this connector?, choisissez Enabled (direct trigger).
Cliquez sur Set live.
Une fois le connecteur de données Pendo en service, Fin le déclenche automatiquement lorsqu'une question client correspond à ce que fait le modèle.
Note : Vous ne pouvez tester pleinement les modèles de connecteur de données Pendo que dans un espace de travail de production, pas dans un espace de travail de test.
Note : Chaque appel réussi à Submit Pendo feedback for a visitor crée un nouvel élément de retour dans Pendo, utilisez donc un client test lors du test de ce modèle.
Que voient les clients lorsque Fin utilise les modèles de connecteur de données Pendo ?
Les clients ne voient pas Pendo lorsque Fin utilise les modèles de connecteur de données Pendo, car Fin utilise le contexte Pendo en coulisses. La seule différence visible est le lien du guide : lorsque Fin trouve un guide Pendo correspondant, il répond avec un lien qui lance la visite guidée dans votre application.
Les conversations où Fin utilise les données Pendo apparaissent dans l'Inbox comme toute autre conversation Fin.
Comment faire un rapport sur les modèles de connecteur de données Pendo
Les modèles de connecteur de données Pendo n'ont pas de rapport dédié. Ce sont des connecteurs de données standard, donc leur utilisation apparaît dans vos rapports existants de connecteur de données et Fin.
Quelles sont les limites des modèles de connecteur de données Pendo ?
Les modèles de connecteur de données Pendo ont ces limites, avec des solutions de contournement quand elles existent :
Applications web uniquement : Les applications mobiles et les extensions de navigateur ne sont pas encore prises en charge, et il n'y a pas de solution de contournement.
Clients connectés uniquement : Fin ne peut rechercher que les clients connectés et disposant d'un ID visiteur Pendo.
Correspondance d'ID visiteur : Si l'ID visiteur dans Intercom ne correspond pas à Pendo, Fin ne peut pas trouver le client. Synchronisez les IDs et mappez l'entrée Visitor ID à l'attribut pendoVisitorId.
Activité taguée uniquement : Les résumés de session incluent uniquement les pages et fonctionnalités taguées dans Pendo. Taguez plus de pages et fonctionnalités dans Pendo pour les inclure.
Authentification client requise : Les modèles ne peuvent pas être mis en service tant que l'OTP par email ou la sécurité Messenger ne sont pas configurés.
Test en production uniquement : Vous ne pouvez tester pleinement les modèles que dans un espace de travail de production, pas dans un espace de travail de test.
Modules complémentaires Pendo : L'activité de l'agent IA nécessite Pendo Agent Analytics, et la soumission de retours nécessite Pendo Feedback. Sans eux, ces 2 modèles ne renvoient pas de données utiles.
Nouvel élément de retour par appel : Chaque appel réussi à Submit Pendo feedback for a visitor crée un nouvel élément de retour dans Pendo.
Pas de contact proactif : Les modèles ne démarrent pas de conversations. Pour que Fin contacte lorsqu'une frustration est détectée par Pendo, configurez les signaux de frustration dans Pendo et associez-les aux procédures proactives, qui nécessitent Proactive Support Plus ou Full Suite.
FAQ des modèles de connecteur de données Pendo
Pourquoi Fin ne trouve-t-il pas mon client dans Pendo ?
Fin ne trouve pas un client dans Pendo lorsque l'ID visiteur dans Intercom ne correspond pas à Pendo, ou lorsque le client n'a pas d'activité taguée. Vérifiez que l'entrée Visitor ID est mappée au bon attribut. Si vos IDs utilisateur Intercom et IDs visiteur Pendo diffèrent, synchronisez les IDs et utilisez l'attribut pendoVisitorId.
Pourquoi Fin trouve certains clients dans Pendo mais pas d'autres ?
Fin ne trouve que certains clients dans Pendo lorsque vos IDs utilisateur Intercom et IDs visiteur Pendo diffèrent pour les autres. Synchronisez les IDs et vérifiez que l'attribut pendoVisitorId est rempli pour ces clients.
Pourquoi mon connecteur de données Pendo affiche-t-il une erreur d'authentification ?
Un connecteur de données Pendo affiche une erreur d'authentification lorsque les valeurs OAuth sont incorrectes ou expirées, ou lorsque le compte de service a été créé pour une autre région Pendo. Recréez le compte de service dans Pendo, puis créez un nouveau jeton OAuth dans Intercom avec les nouvelles valeurs.
Pourquoi mon connecteur de données Pendo ne renvoie-t-il aucune donnée ?
Un connecteur de données Pendo ne renvoie aucune donnée lorsque pendo_host ne correspond pas à votre région Pendo. S'il est toujours réglé sur app.pendo.io et que votre abonnement Pendo est hébergé dans la région EU, AU ou Japon, changez-le pour l'hôte Pendo de votre région.
Pourquoi Fin n'utilise-t-il pas mon connecteur de données Pendo ?
Fin n'utilise pas un connecteur de données Pendo à moins qu'il ne soit en service et réglé sur Enabled (direct trigger) dans l'onglet Fin. Ouvrez le connecteur de données, vérifiez les deux paramètres et cliquez sur Set live si nécessaire.
Pourquoi le modèle d'activité de l'agent IA Pendo ne renvoie-t-il rien ?
Le modèle Get Pendo AI agent activity for a visitor ne renvoie rien d'utile lorsque votre abonnement Pendo n'inclut pas Pendo Agent Analytics. Ajoutez Agent Analytics dans Pendo pour utiliser ce modèle.
Pourquoi y a-t-il des éléments de retour en double dans Pendo ?
Les éléments de retour en double apparaissent dans Pendo car chaque appel réussi à Soumettre un retour Pendo pour un visiteur crée un nouvel élément. Vérifiez la conversation pour les tentatives répétées.
Operator et Copilot peuvent-ils utiliser les données Pendo ?
Operator et Copilot peuvent utiliser les données Pendo via le Model Context Protocol (MCP), sans les modèles de connecteur de données Pendo. Apprenez comment connecter Pendo à Operator avec Connections. Connections sont inclus avec Operator dans l’add-on Pro. L’accès à Pendo dans Copilot est en bêta fermée.