> For the complete documentation index, see [llms.txt](https://boundaryai.gitbook.io/boundaryai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://boundaryai.gitbook.io/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/connect-to-your-existing-systems.md). # Connecter vos outils Les connecteurs vous permettent d'importer directement les retours dans BAI Analytics depuis les outils que votre équipe utilise déjà et de les analyser en parallèle des enquêtes, des importations de fichiers et des avis récupérés par scraping. Une fois connecté, une plateforme continue d'alimenter automatiquement vos groupes de feedback avec de nouveaux tickets, des réponses à des enquêtes ou des lignes, sans export, sans copier-coller et sans scripts planifiés. Il existe deux types de connexion, et ils se gèrent tous deux au même endroit : * **Outils de support et de travail** (Zendesk, Intercom, Linear, GitHub Issues, etc.). Vous vous connectez à la plateforme depuis BAI Analytics, puis importez les tickets dans un groupe de feedback avec des filtres et une plage de dates. * **Plateformes d'enquêtes et d'expérience client, entrepôts de données et stockage de fichiers** (Qualtrics, SurveyMonkey, Medallia, InMoment, Snowflake, BigQuery, Amazon S3, SFTP, etc.). Vous vous connectez avec des identifiants ou une clé, puis ajoutez une **synchronisation** qui mappe les champs de la plateforme vers un groupe de feedback et s'exécute selon un planning. Cette page explique le fonctionnement des connecteurs de bout en bout : les plateformes prises en charge, la présentation de la page Intégrations, la manière de connecter et de configurer chaque type, et le comportement des données importées une fois qu'elles arrivent dans BAI Analytics. Pour le conteneur qui héberge les données des connecteurs, voir [Groupes de retours](/boundaryai-docs/boundaryai-docs-fr/groupes-de-retours/feedback-groups.md). Pour les autres chemins d'ingestion, voir [Téléverser un jeu de données existant](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/uploading-an-existing-dataset.md), [Social Listening](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/social-listening.md), et [Créer une enquête](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/surveys/editor.md). *** ### Quand utiliser un connecteur Utilisez un connecteur lorsque : * Votre équipe support utilise **Zendesk, Freshdesk, Intercom, Front, ServiceNow, Salesforce Service Cloud, Zoho Desk**, ou un outil de service d'assistance similaire, et vous voulez que chaque ticket client (passé et en cours) soit analysé pour en extraire les thèmes, le sentiment et les problèmes à surveiller. * Votre équipe produit ou d'ingénierie suit les bugs et les demandes dans **Linear, GitHub Issues, GitLab, Azure DevOps, Asana, ClickUp, Trello, Shortcut, Wrike**, ou un outil similaire, et vous voulez y détecter des motifs récurrents. * Votre programme d'enquêtes fonctionne dans **Qualtrics, SurveyMonkey, Medallia**, ou **InMoment** et vous souhaitez que les réponses ouvertes soient analysées en continu, enquête par enquête, sans exportation. * Vos retours se trouvent déjà dans un **entrepôt de données** (Amazon Redshift, Snowflake, Google BigQuery, Databricks) ou arrivent sous forme de **fichiers** dans un bucket Amazon S3 ou sur un serveur SFTP, et vous souhaitez que BAI Analytics lise les nouvelles lignes ou les nouveaux fichiers selon un planning. * Votre outil n'est pas dans le catalogue, mais il fait partie des milliers d'apps sur **Zapier**, et un Zap peut envoyer ses retours dans BAI Analytics (voir Importation via Zapier ci-dessous). * Vous voulez **en continu** ingestion : de nouveaux enregistrements arrivent dans BAI Analytics à cadence fixe, sans que personne n'exporte de CSV. Si vos données sont déjà exportées sous forme de feuille de calcul, [Téléverser un jeu de données existant](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/uploading-an-existing-dataset.md) est plus rapide. Si vous avez besoin de réponses provenant de l'extérieur de toute plateforme que vous contrôlez (avis publics, publications sur les réseaux sociaux), voir [Social Listening](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/social-listening.md). *** ### Plateformes prises en charge Le **Ajouter une connexion** le catalogue de la page Intégrations est consultable et regroupé par catégorie. Voici ce qu'il contient aujourd'hui : | Catégorie | Plateformes | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Support client** | Dixa, Freshdesk, Freshservice, Front, Help Scout, Intercom, Kustomer, Re:amaze, Salesforce Service Cloud, ServiceNow, Zendesk, Zoho Desk | | **Enquêtes et CX** | InMoment, Medallia, Qualtrics, SurveyMonkey | | **Gestion du travail** | Asana, Basecamp, ClickUp, Hive, Teamwork, Trello, Wrike | | **Développement** | Azure DevOps, Bitbucket, GitHub Issues, GitLab, Linear, Pivotal Tracker, Shortcut, Zoho BugTracker | | **Juridique et contrats** | Ironclad, SpotDraft | | **Entrepôts de données** | Amazon Redshift, Databricks, Google BigQuery, Snowflake | | **Stockage de fichiers** | Amazon S3, SFTP | Chaque outil de support ou de travail expose un ensemble de fonctionnalités légèrement différent côté source : par exemple, *priorité* et *date d'échéance* existent dans Linear mais pas dans Trello, *type de ticket* dans Zendesk mais pas dans GitHub Issues. BAI Analytics sait ce que chaque plateforme prend en charge et n'affiche que les options d'import réellement applicables, afin que vous ne voyiez jamais un filtre inutile. {% hint style="info" %} **Votre outil n'est pas dans la liste ?** Zapier couvre des milliers d'autres applications via le point de terminaison API décrit à la fin de cette page. Si vous avez besoin d'un connecteur natif qui n'est pas listé, contactez votre responsable de compte. {% endhint %} *** ### Disponibilité Les connecteurs sont activés par organisation par l'équipe BAI Analytics. Lorsque la fonctionnalité n'est pas activée pour votre organisation, la **Connecteurs** tuile dans un groupe de feedback affiche *Non activé pour votre organisation* et la page Intégrations est verrouillée dans la barre latérale. Contactez votre responsable de compte pour l'activer. Une fois activée, toutes les plateformes du catalogue sont disponibles ; il n'y a aucune restriction par plateforme. *** ### La page Intégrations Ouvrez **Intégrations** depuis la navigation principale. La page comporte trois sections : * **Connexions**: les outils et plateformes auxquels votre organisation est reliée. Tout ce qui se trouve sur cette page est ici. * **Assistants IA**: connectez Claude ou un autre client MCP à vos données (en lecture seule). * **Outils de développement**: **API** clés et **Webhooks**, pour envoyer des données et être averti des événements. Voir la [documentation de l'API](/boundaryai-docs/boundaryai-docs-fr/api-et-webhooks/getting-started.md) et [webhooks](/boundaryai-docs/boundaryai-docs-fr/api-et-webhooks/webhooks.md). #### La section Connexions Le principe est simple : connectez une plateforme une seule fois, puis reliez-la aux groupes de feedback qui ont besoin de ses données. * **Vos connexions** répertorie chaque compte lié, regroupé par catégorie (Support client, Enquêtes et CX, Entrepôts de données, Stockage de fichiers, etc.). Chaque ligne affiche le logo de la plateforme, le nom de la connexion, un indicateur d'état, le nombre de groupes de feedback qu'elle alimente (*Utilisé par 2 groupe(s)*), et la date de sa dernière activité. * **Ajouter une connexion** ouvre le catalogue : recherchez des applications, filtrez par catégorie et sélectionnez une tuile. Les tuiles déjà connectées affichent un compteur *1 connecté* . * Développer une ligne affiche les groupes de feedback qu'elle alimente, une ligne par synchronisation, chacune avec un badge d'état (*Synchronisation en cours*, *En pause*, *En échec*), l'heure de la dernière synchronisation, un **Synchroniser maintenant** bouton, **Suspendre** / **Reprendre**, et un contrôle de suppression. En dessous se trouvent les actions au niveau de la connexion : **Tester la connexion** (connexions d'enquêtes, CX, d'entrepôts et de stockage), **Alimenter un groupe…** (pour ajouter une synchronisation), **Reconnecter** (outils de support et de travail), et **Déconnecter**. Les indicateurs d'état sur une ligne de connexion signifient : | Libellé | Signification | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **Connecté** | La plateforme accepte nos identifiants et au moins une synchronisation est saine, ou aucune synchronisation n'a encore été configurée. | | **Synchronisation en pause** | Une ou plusieurs synchronisations de cette connexion sont en pause. | | **Action requise** | La plateforme a rejeté nos identifiants, ou une synchronisation est en échec. Développez la ligne pour voir le message d'erreur. | | **Configuration incomplète** | La connexion a été créée mais n'a pas encore été vérifiée (par exemple, une clé SFTP pas encore enregistrée). | | **Déconnecté** | La plateforme a interrompu la connexion. Reconnectez-vous pour reprendre. | Lorsqu'une connexion nécessite une attention, un petit badge apparaît à côté de **Intégrations** dans la barre latérale. *** ### Connexion d'un outil de support ou de travail Le processus prend environ une minute et s'exécute entièrement dans BAI Analytics ; rien n'est à installer sur la plateforme source. {% stepper %} {% step %} ### Choisir une plateforme Sur la page Intégrations, cliquez sur **Ajouter une connexion** et choisissez une tuile dans le catalogue (ou partez d'un groupe de feedback, voir la section suivante). {% endstep %} {% step %} ### Nommez la connexion Attribuez-lui un nom que votre équipe reconnaîtra, comme le nom du compte ou de l'espace de travail. Si vous avez déjà une connexion à la même plateforme, BAI Analytics propose un nom numéroté (*Zendesk 2*). Cliquez sur **Continuer vers Zendesk** (ou la plateforme que vous avez choisie). {% endstep %} {% step %} ### Se connecter Une fenêtre de connexion sécurisée s'ouvre. Connectez-vous à votre plateforme et accordez l'accès en lecture. BAI Analytics vous guide à travers les étapes spécifiques à chaque plateforme (comme votre sous-domaine Zendesk). Si la fenêtre n'est pas visible, utilisez **Ouvrir la connexion** pour la faire réapparaître. {% endstep %} {% step %} ### Confirmer Une fois connecté, la plateforme apparaît sous **Vos connexions** avec un point vert. Vos identifiants restent sur la plateforme source. BAI Analytics ne voit jamais votre mot de passe. {% endstep %} {% endstepper %} Vous pouvez connecter **plusieurs comptes de la même plateforme** (par exemple, un Zendesk par région). Chaque connexion est indépendante : en ajouter une ne déconnecte jamais une autre, et chacune conserve ses propres imports. Si une connexion a été configurée par une personne qui a depuis quitté l'équipe, utilisez **Reconnecter** sur sa ligne ; la connexion conserve son nom et ses importations planifiées. *** ### Importation de tickets dans un groupe de feedback Connecter le compte est la première étape. La deuxième consiste à indiquer à BAI Analytics ce qu'il faut importer, et cela se fait toujours dans un groupe de feedback. #### Par où commencer Dans un groupe de feedback, utilisez le **Ajouter une source** bouton et choisissez **Ajouter un connecteur** (il affiche **Importer des données** une fois qu'un compte est lié), ou ouvrez **Connecter une source de données** et choisissez la **Connecteurs** tuile. L'assistant d'importation vous guide à travers **Connexion → Configuration → Mise en place** (intitulé **Révision** dans les groupes à collecte continue). #### Connexion Si vous avez déjà un compte connecté, l'assistant l'affiche, avec une liste déroulante pour choisir entre les comptes lorsque vous en avez plusieurs. Cliquez sur **Importer les tickets** pour continuer. Si vous n'avez encore aucun compte, **Connecter votre plateforme** ouvre la même connexion sécurisée décrite ci-dessus. Juste après la première connexion à une plateforme, il peut afficher *Synchronisation initiale en cours* pendant quelques minutes, le temps que la plateforme prépare ses données ; l'assistant vous indique quand c'est prêt. Cette étape propose aussi une alternative : **Point de terminaison API**, pour recevoir des données depuis Zapier, Make, n8n ou votre propre code (voir Importation via Zapier ci-dessous). #### Configurer **Plage de dates.** Choisissez jusqu'où remonter pour l'importation : | Option | Importe les tickets créés dans… | | ------------------------------------------------------------------------------------------- | ------------------------------------------- | | 7 derniers jours / 30 derniers jours / 90 derniers jours / 6 derniers mois / dernière année | …la fenêtre choisie. | | Toute la période | …tout l'historique du compte source. | | Dates personnalisées | …une fenêtre spécifique de début et de fin. | Les plateformes qui ne prennent pas en charge le filtrage par date affichent **Nombre de tickets** à la place, afin que vous importiez les N tickets les plus récents. Dans un groupe à collecte continue, cette étape est intitulée **Rattrapage** (*Jusqu'où devons-nous synchroniser les tickets existants ?*), car la connexion continue à synchroniser les nouveaux éléments après le chargement initial. **Filtres avancés.** Les filtres restreignent ce qui est importé. Les filtres disponibles dépendent de la plateforme source : * **Statut**: ouvert, fermé, en cours, en attente (ou *all*). * **Priorité**: urgent, élevée, normale, faible (ou *all*). * **Type**: bug, fonctionnalité, question, tâche, incident, etc. * **Assigné à**: assigné, non assigné, ou *all*. * **Date d'échéance**: en retard, à échéance aujourd'hui, à échéance cette semaine, sans date d'échéance, ou *all*. * **Collections**: un sélecteur à sélection multiple pour les conteneurs natifs de la plateforme (Trello *Tableaux*, Zendesk *Groupes*, Freshdesk *Groupes*, GitHub *Dépôts*, etc.). Laissez-le vide pour importer depuis tout. Les filtres s'appliquent à la fois à l'import initial et à chaque synchronisation continue qui suit, donc un connecteur « tickets de support, fermés, 30 derniers jours » continuera à importer les tickets de support fraîchement fermés lors des cycles suivants, et non des nouveaux tickets aléatoires. **Champs à importer.** Choisissez quels **Champs standard** (statut, priorité, assignés, étiquettes, etc.) et quels **Champs personnalisés de la plateforme** importer, jusqu'à 15 champs de métadonnées. Les champs standard deviennent des métadonnées sur lesquelles vous pouvez segmenter dans la vue d'analyse ; les champs personnalisés sont utiles lorsque votre équipe s'appuie sur des tags Zendesk personnalisés ou similaires. Si vous ne voulez pas vous en préoccuper, laissez les valeurs par défaut. **Inclure l'historique de la conversation.** Activé par défaut : les commentaires du ticket sont ajoutés au corps du ticket afin que l'analyse voie l'échange complet. **Importation continue.** Un interrupteur détermine si la connexion est ponctuelle ou en continu : * **Importation unique**: importe une seule fois les tickets correspondants, puis s'arrête. Les nouveaux tickets créés plus tard sur la plateforme source n'apparaîtront pas à moins que vous n'effectuiez un autre import. * **Importation continue**: importe le lot initial *et* et continue à récupérer automatiquement les nouveaux tickets et les tickets mis à jour. L'importation continue est activée par défaut dans les groupes à collecte continue. L'assistant affiche aussi un **Nom de la connexion**, généré à partir de la plateforme et de la plage de dates ; vous pouvez le renommer. #### Configurer et démarrer La dernière étape résume vos choix. Cliquez sur **Démarrer la synchronisation** (ou **Connecter et lancer la synchronisation** dans un groupe à collecte continue) pour une connexion continue, ou **Lancer l'importation** pour une importation unique. Si vous avez seulement besoin d'un instantané, *Vous avez seulement besoin d'une importation unique ?* **Importer sans synchronisation** bascule de mode sans revenir en arrière. {% hint style="info" %} **La surveillance ne fait pas partie de la configuration de l'import.** Les moniteurs du groupe avec **Couvrir automatiquement les nouvelles sources** activés surveillent automatiquement une nouvelle source de connecteur. Gérez-les depuis le **Gérer la surveillance** panneau du groupe ; voir [Surveillance personnalisée](/boundaryai-docs/boundaryai-docs-fr/analyser-vos-retours/custom-monitoring.md). {% endhint %} #### L'import initial Lorsque vous lancez l'importation, BAI Analytics commence à récupérer vos tickets en arrière-plan, en les traitant page par page, et affiche une notification de progression dans le coin de l'écran. Vous pouvez naviguer ailleurs et continuer à travailler ; la notification vous suit. Une fois la tâche terminée, les données du connecteur apparaissent comme source dans son groupe de feedback avec un *Connecteur* badge, et le lien d'analyse devient actif. Dans un groupe à collecte continue, l'écran final de l'assistant confirme que la plateforme est *En ligne, synchronisée en continu* et que les tickets existants sont en cours d'importation. Les très grandes importations historiques sont traitées automatiquement par lots, donc même un long historique s'importe de manière fiable. #### Importation continue Pour les connexions avec importation continue activée, BAI Analytics exécute une synchronisation incrémentielle **toutes les 30 minutes** en arrière-plan. Chaque synchronisation : 1. Vérifie sur la plateforme source les tickets créés ou mis à jour depuis la dernière synchronisation réussie, avec les filtres configurés appliqués. 2. Déduplique les tickets déjà importés dans BAI Analytics. 3. Analyse les nouveaux tickets de la même manière que tous les autres. Vous avez besoin de données plus fraîches ? Utilisez **Récupérer les nouvelles données** sur la carte de source de données de la source (voir ci-dessous) ou **Synchroniser maintenant** sur la page Intégrations. Les deux demandent à la plateforme ses données les plus récentes *maintenant* au lieu d'attendre le prochain cycle. *** ### Connexion d'une plateforme d'enquêtes, d'un entrepôt de données ou d'un stockage de fichiers Ces connecteurs fonctionnent à l'inverse : vous créez d'abord la connexion sur la page Intégrations, vous la testez, puis vous ajoutez une ou plusieurs **synchronisations**, chacune alimentant un groupe de feedback. #### Ce qu'il vous faut par plateforme | Plateforme | Ce que le formulaire de connexion demande | | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Qualtrics** | Votre **ID du datacenter** et un **jeton API**, tous deux depuis les paramètres du compte, puis les identifiants Qualtrics. Régénérer le jeton dans Qualtrics révoque notre accès. | | **SurveyMonkey** | **Se connecter avec SurveyMonkey** ouvre SurveyMonkey pour que vous puissiez approuver l'accès en lecture, sans rien avoir à copier. Lorsque cette connexion n'est pas disponible, **Utilisez plutôt un jeton d'application privée**: choisissez le **centre de données** (États-Unis, Europe ou Canada), collez le **jeton d'accès**, et éventuellement son **ID client** et **secret client** pour activer la livraison en temps réel. | | **InMoment** | Le **hôte API régional**, votre **ID d'organisation**, et le **ID client** / **secret client** fourni par votre contact InMoment. | | **Medallia** | D'abord, *Comment vos données Medallia parviennent-elles à BAI ?* Choisissez **API de requête** (le **URL de la passerelle API**, **URL du jeton OAuth**, **ID client** et **secret client** depuis votre instance Medallia ; le rôle du client doit disposer de la capacité Query API) ou **Livraison de fichiers (SFTP)** (Medallia exporte des fichiers vers un dossier SFTP selon un planning et BAI Analytics les récupère ; aucune licence API n'est nécessaire). | | **Amazon Redshift** et **Amazon S3** | Déployez le rôle lecteur BAI dans votre compte AWS à l'aide du modèle CloudFormation que nous fournissons (lecture seule, lié à votre External ID, révocable en supprimant la pile), puis collez le **ARN du rôle** ainsi que les détails du cluster ou du groupe de travail, ou le **nom du bucket** et, pour S3, le préfixe et la clé KMS facultatifs. | | **Snowflake** | Le **identifiant du compte**, un **utilisateur de service**, et le **entrepôt virtuel**. BAI Analytics génère une paire de clés ; vous enregistrez la partie publique sur l'utilisateur de service avec l'instruction affichée, puis vous testez. Aucun mot de passe ne quitte jamais Snowflake. | | **Google BigQuery** | Le **ID du projet** et **ID du jeu de données**. Accordez le **BigQuery Data Viewer** rôle au compte de service BAI affiché, ajoutez l’étiquette de propriété avec la commande affichée, puis testez. Aucune clé ni secret n’est échangé. Chaque requête de synchronisation est d’abord exécutée en simulation et arrêtée si elle devait analyser plus que le budget configuré (1 Go par défaut). | | **Databricks** | Le **Hôte de l’espace de travail**, **ID de l’entrepôt SQL**, **Catalogue**, ainsi que le principal de service OAuth **ID client** et **secret**. Un espace de travail compatible Unity Catalog est requis. Notez la date d’expiration du secret et nous vous rappellerons avant qu’il n’expire. | | **SFTP** | **Hôte**, **Port**, **Nom d’utilisateur**, le **Dossier** dans lequel les fichiers sont livrés, et une option facultative **Modèle de nom de fichier** (par exemple `feedback_*.csv`). L’authentification se fait par **clé SSH** (recommandée) ou **Mot de passe**. Collez l’empreinte du serveur du fournisseur **Empreinte du serveur** si vous en avez une. | Pour les sources basées sur des fichiers (S3 et SFTP), BAI Analytics lit des fichiers CSV, TSV, JSON, NDJSON ou Parquet, éventuellement compressés en gzip, et détecte les colonnes à partir du fichier le plus récent. #### Connexion {% stepper %} {% step %} ### Ajouter la connexion Cliquez sur **Ajouter une connexion**, sélectionnez la tuile et remplissez le formulaire ci-dessus. La plupart des plateformes utilisent **Connecter et tester**: la connexion est créée et vérifiée en une seule fois. {% endstep %} {% step %} ### Remettre une clé, si la plateforme en nécessite une Snowflake et SFTP se terminent par une étape de transfert. BAI Analytics génère sa propre paire de clés et affiche la clé publique avec un bouton de copie et son empreinte. Enregistrez-la sur l’utilisateur de service (Snowflake) ou envoyez-la à la personne qui gère le compte SFTP, puis cliquez sur **La clé est enregistrée. Tester la connexion**. **Terminer plus tard** est toujours disponible : la connexion reste en *Configuration incomplète* et la clé publique reste sur sa ligne jusqu’à confirmation de l’autre côté. Pour SFTP, l’identité du serveur est vérifiée au premier contact et épinglée ensuite. {% endstep %} {% step %} ### Alimenter un groupe Développez la ligne de connexion et cliquez sur **Alimenter un groupe…** pour ajouter une synchronisation (voir ci-dessous). Vous pouvez ajouter plusieurs synchronisations à une connexion, chacune alimentant un groupe de commentaires différent. {% endstep %} {% endstepper %} #### Ajout d’une synchronisation Une synchronisation mappe les données de la plateforme vers un groupe de commentaires. Le formulaire demande : * **Groupe de commentaires**: où les enregistrements aboutissent. * **Quoi lire**: le **Enquête** (Qualtrics, SurveyMonkey, InMoment), le **Schéma** et **Table** (entrepôts), ou le **Emplacement des fichiers** (S3 et SFTP). * **Champ de texte du retour** (ou **Colonne de texte du retour**) : la réponse libre analysée par l’IA. SurveyMonkey et Medallia vous permettent d’en choisir plusieurs **Questions de texte du retour**; chaque question répondue devient alors un retour distinct, avec une *Question* colonne indiquant laquelle. * **Champ d’horodatage** (ou colonne) : quand chaque enregistrement a été créé. Les entrepôts et les fichiers nécessitent également une **colonne d’ID unique** afin que les nouvelles lectures ne dupliquent jamais. * **Champs de métadonnées (facultatifs)**: autres champs à importer pour la segmentation. * **Fréquence de synchronisation**: **Toutes les heures**, **Toutes les 4 heures**, ou **Quotidien**. Cliquez sur **Démarrer la synchronisation**. La première importation démarre dans quelques minutes, puis la synchronisation s’exécute selon la fréquence choisie. Chaque exécution ne lit que ce qui est nouveau depuis la dernière exécution, déduplique par rapport aux enregistrements déjà importés et analyse les nouveaux enregistrements comme n’importe quelle autre source. **Livraison en temps réel de SurveyMonkey.** Lorsque la connexion dispose d’un ID client et d’un secret (ou a été créée avec **Se connecter avec SurveyMonkey**), BAI Analytics enregistre un webhook sur chaque enquête synchronisée, de sorte qu’une réponse complétée déclenche une récupération en quelques minutes au lieu d’attendre la prochaine exécution planifiée. La ligne de la synchronisation sur la page Intégrations affiche un **Temps réel** badge ; *Temps réel indisponible* signifie que le webhook n’a pas pu être enregistré et que la synchronisation interroge selon son calendrier à la place. #### Medallia : répétez avant d’activer Medallia est la seule plateforme où un résultat vide et une autorisation manquante se ressemblent de l’extérieur, donc ses synchronisations bénéficient de protections supplémentaires : * Le formulaire de synchronisation est organisé en étapes : d’où provient le retour (le **Programme d’expérience**, et les options facultatives **Limiter cette source à** règles), ce qui compte comme retour (les **Champs de texte du retour**), le **Champ de date suivi par cette synchronisation** (choisissez un champ qui enregistre quand le retour est devenu disponible dans Medallia, pas quand le client a répondu ; BAI Analytics marque le champ recommandé), et où il arrive (le **Groupe de commentaires** et une **Nom de la source**). * **Une connexion peut alimenter plusieurs sources.** Ajouter une **Limiter cette source à** règle (par exemple, le type de retour *est l’un de* enquête) pour router les réponses aux enquêtes vers un groupe de commentaires et les avis Google vers un autre, à partir de la même connexion Medallia. * **Les nouvelles synchronisations Medallia sont enregistrées en pause.** Utilisez **Vérifier la configuration** sur la connexion pour exécuter les vérifications de préparation (identifiants, capacité Query API, Programmes d’expérience, découverte des champs, etc.), puis **aperçu** sur la synchronisation pour l’exécuter réellement contre Medallia et voir ce qu’elle *ferait* importerait : enregistrements lus, exclus par vos règles, déjà importés, qui seraient importés, avec des exemples d’enregistrements. Aucun élément n’est importé par un aperçu. Lorsque vous êtes satisfait, cliquez sur **Activer cette synchronisation**. Vous pouvez ignorer l’aperçu, mais seulement délibérément (**Activer sans aperçu**). * **Modifier** sur la connexion vous permet de faire tourner un secret ou de renommer sans recréer les synchronisations. *** ### À quoi ressemblent les données du connecteur dans un groupe de commentaires Une fois importés, les enregistrements apparaissent comme une source unique dans le groupe de commentaires de destination, avec un *Connecteur* badge afin de voir d’un coup d’œil quelles sources sont actives. Chaque synchronisation sur une connexion d’enquête, d’entrepôt ou de stockage crée sa propre source. Correspondance par enregistrement pour les outils de support et de travail : * Le ticket **objet et corps** deviennent une réponse Long Answer, le champ que l’IA analyse pour les thèmes et le sentiment. * **Les commentaires** sur le ticket sont ajoutés comme contexte supplémentaire (si vous avez laissé *Inclure l’historique de conversation* activé). * **Statut, priorité, assignés, type de ticket, étiquettes, date d’échéance** deviennent des champs de métadonnées, disponibles pour la segmentation dans la vue d’analyse. * Tout **champs personnalisés** que vous avez sélectionnés remontent comme métadonnées supplémentaires. Pour les synchronisations d’enquête, d’entrepôt et de stockage, le **Champ de texte du retour** devient la réponse Long Answer, le **Champ d’horodatage** le date, et les **Champs de métadonnées** que vous avez sélectionnés remontent pour la segmentation. Cela signifie qu’une source de connecteur participe pleinement à l’analyse inter-sources dans son groupe de commentaires : Grouped Themes regroupera les enregistrements du connecteur avec les réponses d’enquête pertinentes ou les avis récupérés, et les rapports de portée de groupe les incluront automatiquement. #### La carte de source de données Dans l’aperçu qualitatif d’une source de connecteur, un **Importation de connecteur** carte affiche : * La plateforme connectée (logo, nom, statut : *Connecté*, *Synchronisation en cours*, *Échec*, ou *Déconnecté*) et le nombre d’éléments importés. * **Dernière importation** avec une précision complète de la date et de l’heure. * **Prochaine importation automatique**, avec un compte à rebours relatif, ou *Importation automatique en pause*. * Le **Filtres d’importation actifs** sous forme de badges en lecture seule (Statut, Priorité, Type, Collections, Assignés, Date d’échéance) afin que vous voyiez exactement pourquoi certains tickets peuvent être exclus. * Un **Récupérer les nouvelles données** bouton pour lancer une synchronisation maintenant. Le résultat s’affiche en ligne, et le **Dernière erreur de synchronisation** apparaît ici si la dernière exécution a échoué. * Un **Gérer le connecteur** lien vers la page Intégrations pour mettre en pause, modifier ou déconnecter. Pour une synchronisation Medallia qui est toujours en pause et n’a jamais été exécutée, **Récupérer les nouvelles données** vous renvoie à **aperçu** au lieu de démarrer une synchronisation silencieusement. *** ### Mettre en pause, modifier et déconnecter Depuis la page Intégrations (ou via **Gérer le connecteur** sur la carte de source de données), vous pouvez : * **Suspendre** une synchronisation : elle cesse de s’exécuter mais conserve ses filtres et sa correspondance de champs, donc **Reprendre** se fait en un clic. * **Synchroniser maintenant**: exécuter la synchronisation immédiatement au lieu d’attendre le cycle suivant. * **Tester la connexion**: vérifier que la plateforme accepte toujours nos identifiants (connexions d’enquête, CX, d’entrepôt et de stockage). * **Supprimer une synchronisation**: le groupe de commentaires cesse de recevoir les mises à jour de cette connexion. Les données importées restent dans le groupe. * **Déconnecter** le compte : arrête toutes les synchronisations sur celui-ci et supprime le lien vers la plateforme source. Les enregistrements déjà importés restent dans vos groupes de commentaires ; seul le lien actif est coupé. #### Gestion des échecs Si une synchronisation échoue (par exemple, vos identifiants de plateforme ont expiré), la ligne de la synchronisation affiche *En échec* avec le message d’erreur de la plateforme, et la connexion indique *Action requise*. Après cinq échecs consécutifs, BAI Analytics cesse de réessayer automatiquement, et la synchronisation continue d’afficher *En échec* jusqu’à ce que vous interveniez. Une fois le problème résolu (**Reconnecter** pour les outils de support et de travail, ou **Modifier** / **Tester la connexion** pour les autres), cliquez sur **Reprendre** sur la synchronisation, ou **Synchroniser maintenant** si elle n’est pas affichée comme en pause. *** ### Importation via Zapier Si un outil n’est pas dans le catalogue, **Zapier** peut faire le lien : un Zap surveille votre application source et pousse chaque nouveau retour vers BAI Analytics via l’API. {% stepper %} {% step %} ### Créer une source de point de terminaison API Dans un groupe de commentaires, ouvrez l’assistant de connecteur (**Ajouter une source**, puis **Ajouter un connecteur**) et choisissez **Point de terminaison API** (*Recevoir des données de Zapier, Make, n8n ou de code personnalisé*). Nommez le point de terminaison et définissez les champs qui recevront les données. BAI Analytics affiche l’ID du groupe, l’ID de source et les ID de champ du point de terminaison, ainsi qu’une requête d’exemple. {% endstep %} {% step %} ### Créer une clé API Sous **Intégrations**, **Outils de développement**, **API**, créez une clé API. Copiez-la immédiatement ; elle n’est affichée qu’une seule fois. {% endstep %} {% step %} ### Construire le Zap Le panneau de détails du point de terminaison affiche un **Connecter avec Zapier** guide avec un **Ajouter BAI Analytics à Zapier** bouton. Dans Zapier, créez un Zap, choisissez l’application d’où proviennent vos données comme déclencheur, ajoutez **BAI Analytics → Envoyer un retour** comme action, puis connectez-le avec votre clé API. Choisissez ce groupe et cette source dans les listes déroulantes, puis mappez vos champs aux questions. {% endstep %} {% step %} ### Tester et activer Mettez un ID d’enregistrement unique dans **ID externe** afin que les nouvelles tentatives ne dupliquent jamais, puis activez votre Zap. Chaque élément arrive dans la source du point de terminaison comme n’importe quel autre retour et est analysé automatiquement. {% endstep %} {% endstepper %} Les données importées via Zapier se comportent exactement comme les données natives du connecteur : elles participent à Grouped Themes, sont couvertes par les moniteurs de couverture automatique et sont intégrées aux rapports. Vous construisez quelque chose de plus personnalisé qu’un Zap ? Le même point de terminaison prend en charge un [API](/boundaryai-docs/boundaryai-docs-fr/api-et-webhooks/getting-started.md) avec des envois en masse, un retour de lecture de l’analyse, et [webhooks](/boundaryai-docs/boundaryai-docs-fr/api-et-webhooks/webhooks.md). *** ### Bonnes pratiques * **Un groupe de commentaires par source et par audience.** Un seul groupe mixte convient aux petites opérations ; pour les plus grandes, la séparation *"Support : UE"*, *"Support : US"*, et *"Bugs d’ingénierie"* permet à Grouped Themes de rester pertinent. Avec plusieurs comptes de la même plateforme, nommez chaque connexion d’après le compte afin que le bon soit évident dans l’importateur. * **Soyez précis avec les filtres.** *"Tous les tickets, tout le temps"* est rarement ce que vous voulez. Filtrez les tickets d’assistance fermés si vous vous intéressez aux problèmes résolus ; filtrez un seul tableau ou dépôt si vous n’analysez qu’une seule équipe. * **Choisissez les champs personnalisés que vous utilisez réellement.** Les champs standard couvrent la plupart des analyses ; n’ajoutez des champs personnalisés que si votre équipe les utilise pour le routage, le marquage ou l’escalade. * **Testez la connexion juste après la configuration.** **Tester la connexion** (ou **Récupérer les nouvelles données** sur la source) fait remonter les problèmes d’identifiants immédiatement plutôt qu’à la prochaine exécution planifiée. * **Prévisualisez les synchronisations Medallia avant de les activer.** Une correspondance qui s’exécute correctement et importe les mauvais enregistrements est l’échec que rien d’autre ne détecte ; l’aperçu montre exactement ce qui serait importé. * **Faites attention au calendrier sur les entrepôts à facturation à l’usage.** Snowflake facture un minimum à chaque reprise d’entrepôt et les analyses BigQuery sont budgétées par requête, donc **Fréquence de synchronisation** est votre principal levier de coût. * **Réauthentifiez-vous de manière proactive lorsque les sièges changent.** Si le membre de l’équipe qui a initialement connecté un outil de support ou de travail part, utilisez **Reconnecter** afin que le jeton longue durée n’expire pas de façon inattendue. * **Déconnectez, ne supprimez pas.** Déconnecter une connexion ou supprimer une synchronisation conserve la disponibilité des enregistrements importés et des analyses ; supprimer la source les fait disparaître.