> 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/social-listening.md).

# Social Listening

**Agents** laissez BAI Analytics aller recueillir à votre place des retours du web ouvert (avis publics, avis sur les boutiques d’apps et avis employeur, publications sur les réseaux sociaux, mentions dans l’actualité, commentaires vidéo) et ramener le tout dans les mêmes Groupes de feedback où se trouvent vos enquêtes et vos données de connecteurs. Un seul agent peut surveiller de nombreuses plateformes à la fois, et les données sont normalisées dans le même modèle analytique que tout le reste, de sorte que les thèmes et le sentiment couvrent toutes les sources.

Cette page couvre les agents de bout en bout : quelles plateformes sont prises en charge, comment en créer un, comment fonctionnent les niveaux d’intensité et les crédits, comment BAI Analytics écarte les contenus non pertinents, comment répondre à ce que vous collectez, et comment les données récupérées apparaissent dans vos tableaux de bord.

Pour d’autres façons d’importer des retours, voir [Créer une enquête](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/surveys/editor.md), [Téléverser un jeu de données existant](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/uploading-an-existing-dataset.md), et [Connecter vos outils](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/connect-to-your-existing-systems.md).

***

### Quand utiliser un agent

Utilisez un agent lorsque :

* Vous voulez **surveiller une marque ou un produit** sur des sites d’avis (Google Reviews, Trustpilot, TripAdvisor, Avis Vérifiés) sans exporter manuellement les avis selon une planification.
* Vous voulez **des avis sur les applications** de l’Apple App Store et de Google Play, ou **des avis produits** d’Amazon, au même endroit que le reste de vos retours.
* Vous voulez **des avis employeur** de Glassdoor et Indeed pour comprendre comment les collaborateurs et les candidats vous décrivent.
* Vous voulez **de la veille sociale** sur vos propres canaux ou sur des comptes spécifiques (X / Twitter, Reddit, Instagram, LinkedIn, Facebook, YouTube, TikTok).
* Vous voulez surveiller **les mentions presse et actualités** d’un sujet, d’un produit ou d’un concurrent (Google News).
* Vous voulez que les retours publics arrivent dans le même Groupe de feedback que vos enquêtes et vos tickets de support, afin que les thèmes puissent être comparés entre les canaux.

Si ce que vous voulez savoir est **comment les assistants IA décrivent votre marque** (ChatGPT, Claude, Gemini, Perplexity, et autres), il s’agit d’un autre type de source construit sur le même assistant : voir [Visibilité IA](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/ai-visibility.md).

Si les données existent déjà dans un outil que vous contrôlez (un help-desk, un projet Jira, un CRM), utilisez plutôt un connecteur. Les connecteurs s’authentifient en votre nom et récupèrent directement les objets natifs. Les agents vont chercher des données publiques via l’automatisation web.

***

### Accès et crédits

La veille Web et sociale est une option activée par organisation par l’équipe BAI Analytics. Si elle n’est pas activée pour la vôtre, la page Agents affiche **Fonction non activée** avec une note vous invitant à contacter votre interlocuteur BAI Analytics.

Les agents sont comptabilisés séparément du reste de la plateforme :

* **Crédits Web et médias sociaux** sont un solde dédié (indépendant du quota d’utilisation qui exécute les enquêtes et les analyses). Vous voyez le solde restant dans le Hub des intégrations, sous *Crédits Web et médias sociaux*.
* Chaque exécution **déduit des crédits à l’avance** en fonction du niveau d’intensité que vous choisissez (voir ci-dessous). Vous n’êtes facturé que pour les données réellement collectées : si une exécution retourne moins d’éléments que prévu, la différence est remboursée.
* Si une exécution **échoue** avant de produire des données, les crédits sont **remboursés automatiquement**.
* Votre organisation peut disposer d’une **allocation mensuelle de crédits** mise en place par l’équipe BAI Analytics. Vous pouvez aussi **ajouter des crédits** par forfaits fixes (25 / 50 / 100 / 250 / 500 / 1 000 crédits, 1 crédit = 1 USD) via le paiement Stripe sécurisé depuis la même section.
* Un **historique des crédits** complet est disponible depuis la même section, avec une ligne par recharge, exécution et remboursement.

Le solde est vérifié avant chaque exécution. Si vous n’avez pas assez de crédits, l’exécution ne démarre pas et aucun débit n’est effectué.

***

### Sources prises en charge

Dix-sept plateformes de veille sociale sont prises en charge aujourd’hui, regroupées selon ce pour quoi elles sont les plus adaptées :

#### Sites d’avis

| Plateforme          | Identifiant                     | Notes                                                                                                                                                                                              |
| ------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Avis Google**     | URL Google Maps ou nom du lieu  | Les notes en étoiles sont conservées ; le lieu est détecté automatiquement si vous fournissez un nom d’entreprise.                                                                                 |
| **Trustpilot**      | URL de page d’avis d’entreprise | Sous-domaines de pays pris en charge (`trustpilot.com`, `.de`, `.co.uk`, etc.) afin que les marques multi-régions puissent être suivies sous un seul agent.                                        |
| **TripAdvisor**     | URL de fiche                    | Hôtel, restaurant, attraction, etc.                                                                                                                                                                |
| **Avis Vérifiés**   | URL de page d’avis d’entreprise | Plateforme française d’avis certifiés (avis-verifies.com).                                                                                                                                         |
| **Apple App Store** | URL de l’application            | `apps.apple.com/.../app/.../id...`. Apple limite les avis par pays, donc des intensités plus élevées récupèrent la même application depuis plusieurs boutiques nationales (et langues).            |
| **Google Play**     | URL de la page de l’application | `play.google.com/store/apps/details?id=...`. Les réponses du développeur sont capturées avec l’avis.                                                                                               |
| **Amazon**          | URL de la page produit          | N’importe quelle place de marché (`amazon.com`, `.fr`, `.de`, `.co.jp`, etc.). Les longues URL avec des paramètres de suivi sont acceptées et nettoyées pour revenir au lien canonique du produit. |
| **Glassdoor**       | URL de page d’avis d’entreprise | N’importe quel domaine national. Les avis sont anonymes ; l’intitulé du poste du rédacteur est affiché comme auteur. Les réponses de l’employeur sont capturées.                                   |
| **Indeed**          | URL de page d’avis d’entreprise | `indeed.com/cmp/<company>/reviews` et les variantes nationales. Les avis sont anonymes ; l’intitulé du poste du rédacteur est affiché comme auteur.                                                |

#### Plateformes sociales

| Plateforme      | Identifiant                                                         | Capture                                                                                                                                                         |
| --------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **X (Twitter)** | hashtags, identifiants de compte, termes de recherche               | Publications correspondant aux filtres.                                                                                                                         |
| **Reddit**      | sous-reddits (+ filtres de mots-clés facultatifs)                   | publications et commentaires ; ordre de tri configurable.                                                                                                       |
| **Instagram**   | URL de profil, de publication ou de reel                            | Publications et commentaires.                                                                                                                                   |
| **Facebook**    | URL de page ou de publication                                       | Publications et commentaires.                                                                                                                                   |
| **LinkedIn**    | URL de profil, d’entreprise, d’école ou de publication              | Publications et commentaires.                                                                                                                                   |
| **YouTube**     | URL d’une vidéo, ou URL d’une chaîne (jusqu’à 10 par agent)         | Commentaires, avec les dates de publication exactes. Une URL de chaîne récupère les commentaires de chaque vidéo publiée par la chaîne dans la période choisie. |
| **TikTok**      | identifiant de compte, hashtags, URL de vidéo ou terme de recherche | Vidéos et leurs commentaires.                                                                                                                                   |

#### Actualités

| Plateforme      | Identifiant         | Notes                                                                                                                                                                                                                                                    |
| --------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Google News** | Termes de recherche | Nous recommandons 1 à 3 termes de recherche ; chacun s’exécute comme sa propre recherche d’actualités. Recherche multilingue prise en charge (anglais, français, espagnol, allemand, italien, portugais, néerlandais, japonais, coréen, arabe, chinois). |

#### Assistants IA

Le même assistant peut aussi interroger **Claude, ChatGPT, Gemini, Perplexity, Grok, DeepSeek et Mistral** au sujet de votre marque. Il s’agit d’un type de source distinct avec sa propre analyse : voir [Visibilité IA](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/ai-visibility.md).

{% hint style="info" %}
**Vous ne voyez pas votre source ?** Parlez-en à votre interlocuteur BAI Analytics. D’autres sources peuvent être intégrées au même flux.
{% endhint %}

***

### Créer un agent

L’assistant de création d’agent est conçu autour de ce que vous voulez réellement surveiller, pas autour de la configuration technique. Le flux est le suivant : décrivez votre objectif, BAI Analytics suggère les bonnes plateformes et les bons identifiants, vous confirmez ou ajustez.

#### Étape 0 : Définir l’objectif

Lorsque vous cliquez sur **Nouvel agent**, le premier écran demande **"Que cherchez-vous ?"**. Décrivez ce que vous voulez suivre, en langage simple. Exemples :

* *"Trouvez tous les retours clients et les plaintes concernant l’Hôtel Nimbus."*
* *"Surveillez ce que les gens disent à propos d’Acme CRM."*
* *"Suivez le sentiment de marque pour notre nouveau restaurant à Barcelone."*

BAI Analytics analyse la demande, suggère **quelles plateformes conviennent à l’objectif**et préremplit les URL, identifiants ou termes de recherche lorsqu’il le peut. Vous choisirez les plateformes et les dates exactes aux étapes suivantes, donc il n’est pas nécessaire de les mentionner ici.

{% hint style="success" %}
**Astuce.** Une demande précise qui nomme la marque, le produit ou le lieu produit de meilleures suggestions qu’une demande générique. *"retours clients"* ne donne aucun point d’ancrage à l’IA ; *"retours clients sur le tableau de bord BAI Analytics"* lui permet de suggérer des identifiants et des requêtes concrets.
{% endhint %}

L’objectif que vous saisissez ici a une double fonction : c’est aussi ce que l’agent utilise pour décider si chaque publication ou commentaire collecté concerne réellement votre sujet (voir [Conserver des résultats pertinents](#keeping-results-relevant) ci-dessous). Il reste modifiable à l’étape Sources.

#### Étape 1 : Choisir les sources

L’étape Sources affiche toutes les plateformes prises en charge, **regroupées selon la quantité d’informations que vous devez fournir**:

* **Fonctionne à partir de votre requête**: Reddit, X, TikTok, Google News. Vous fournissez des termes de recherche, des hashtags ou des identifiants (ou laissez l’IA les suggérer avec **Suggérer avec l’IA**); BAI Analytics se charge du reste.
* **Vous fournissez les liens**: Google Reviews, Trustpilot, TripAdvisor, Avis Vérifiés, Glassdoor, Indeed, Google Play, Apple App Store, Amazon, Instagram, Facebook, LinkedIn, YouTube. Collez les URL des pages, ou appuyez sur **Suggérer des URL** pour laisser l’IA trouver des candidats à partir de votre objectif. Chaque plateforme dispose d’un **Comment obtenir l’URL** assistant.
* **Interroger des modèles d’IA**: Claude, ChatGPT, Gemini, Perplexity, Grok, DeepSeek, Mistral. Les sélectionner bascule l’assistant vers le flux centré sur la marque. [Visibilité IA](/boundaryai-docs/boundaryai-docs-fr/importer-vos-retours/ai-visibility.md) flux centré sur la marque.

Pour chaque plateforme que vous activez, un champ vous permet de coller des URL, des identifiants ou des mots-clés. Les saisies deviennent des puces validées à l’appui sur Entrée, virgule ou collage, afin que vous puissiez déposer d’un coup une liste de dix URL et obtenir un retour immédiat sur celles que la plateforme a reconnues. Survolez une puce pour la vérifier, ou cliquez sur un lien pour confirmer qu’il ouvre la bonne page. Une puce jaune signifie que l’URL est valide mais n’est peut-être pas liée à votre sujet (par exemple, une page Glassdoor suggérée par l’IA pour une autre entreprise) ; supprimez-la si elle a été ajoutée par erreur.

Lorsque l’IA suggère des URL ou des mots-clés, une courte étape de revue vous demande de les confirmer avant de continuer. Les entrées hors sujet introduisent des données non pertinentes dans votre analyse, donc un contrôle rapide vaut le coup.

Un petit compteur de progression sur chaque groupe ("2 sur 3 prêts") vous indique quand vous avez suffisamment de sources pour continuer.

{% hint style="info" %}
**Un seul agent, plusieurs plateformes.** Un seul agent peut surveiller simultanément n’importe quelle combinaison de plateformes. Il n’est pas nécessaire de créer un agent par source.
{% endhint %}

#### Étape 2 : Définir le comportement

Une fois vos sources ajoutées, l’étape **Planification et paramètres** couvre quand l’agent s’exécute, combien il collecte et comment cela est analysé :

* **Planification**: choisissez **Exécution unique**, **Planifié**, ou **Continu**. Pour **Planifié** et **Continu**les agents, choisissez un **Quotidien**Hebdomadaire **Mensuel**UTC [Choisir la fréquence d’exécution d’un agent](#choosing-how-often-an-agent-runs).
* **Jusqu’où remonter ?**: la fenêtre de remontée pour la première exécution (**7 / 30 / 90 derniers jours**, **Dernière année**, **Depuis toujours**, ou une plage personnalisée).
* **Volume de données**: le **Intensité de scraping**, *Standard*, *Élevé*, *Très élevé*, ou *Personnalisé*. Voir les niveaux d’intensité ci-dessous. L’étape affiche une estimation des éléments et des crédits avant l’enregistrement.
* **Analyse**: le **Langue d’analyse** (définit la langue source pour le sentiment, les thèmes et la traduction) ainsi que les moniteurs du groupe qui surveilleront les données collectées.
* **Recharge automatique**: ajoutez automatiquement des crédits si besoin afin qu’un agent continu ne s’arrête jamais.

Enregistrez l’agent et BAI Analytics le place dans le Groupe de feedback dans lequel vous l’avez créé, ou dans *Enquêtes individuelles* si aucun groupe n’a été sélectionné. L’agent apparaît sous forme de carte avec des badges de plateforme, le statut de la dernière exécution et un **Exécuter maintenant** bouton.

***

### Niveaux d’intensité

L’intensité contrôle la quantité de données récupérées par une exécution. Les niveaux supérieurs coûtent plus de crédits, mais vont plus en profondeur sur toutes les plateformes sélectionnées.

| Niveau           | Éléments par plateforme (typique) | Commentaires par publication | Crédits (solde minimum pour démarrer) |
| ---------------- | --------------------------------- | ---------------------------- | ------------------------------------- |
| **Standard**     | jusqu’à 250                       | 10                           | 5                                     |
| **Élevé**        | jusqu’à 2 500                     | 20                           | 25                                    |
| **Très élevé**   | jusqu’à 5 000                     | 50                           | 75                                    |
| **Personnalisé** | jusqu’au maximum de la plateforme | configurable                 | calculé à partir de vos paramètres    |

Chaque plateforme a son propre plafond par niveau (les sources à fort volume comme X ou Google Reviews dépassent largement la valeur typique ; les plateformes basées sur des pages comme LinkedIn, Facebook, Instagram ou Amazon restent bien en dessous), et *Personnalisé* est limité par ces plafonds. Vous n’avez pas besoin de les mémoriser : l’assistant plafonne automatiquement votre saisie, et l’estimation avant exécution comme la vérification des crédits utilisent les mêmes plafonds par plateforme, de sorte que l’exécution ne peut jamais exiger plus de crédits que l’estimation ne l’indique.

{% hint style="success" %}
**Choisissez Standard pour les premières exécutions.** Si une exécution Standard vous renvoie déjà l’étendue de retours dont vous avez besoin, vous n’avez aucune raison de payer pour Élevé. Si vous voyez des indicateurs "plus disponibles" dans l’analyse, montez en intensité.
{% endhint %}

***

### Paramètres par source

Chaque plateforme expose un petit nombre d’options spécifiques que l’assistant affiche lorsque c’est pertinent :

* **Reddit**: sous-reddits, tri (nouveaux / populaires / meilleurs / pertinence / commentaires), type de publication (lien / texte / tous), score minimum, nombre max de commentaires par publication.
* **X (Twitter)**: hashtags, identifiants de compte, termes de recherche, nombre max de publications.
* **Google Reviews / Trustpilot / TripAdvisor / Avis Vérifiés**: liste d’URL de lieu / entreprise / fiche, nombre max d’avis.
* **Apple App Store / Google Play**: liste d’URL d’application, nombre max d’avis.
* **Amazon**: liste d’URL de produits, nombre max d’avis.
* **Glassdoor / Indeed**: liste d’URL de pages d’avis d’entreprise, nombre max d’avis.
* **Instagram / Facebook / LinkedIn**: liste d’URL de profil, de page ou de publication.
* **YouTube**: URL de vidéo, ou URL de chaîne (jusqu’à 10) pour récupérer chaque vidéo d’une période donnée.
* **TikTok**: identifiants de compte, hashtags, URL de vidéo ou termes de recherche.
* **Google News**: termes de recherche ; recherche multilingue sur 11 langues.

L’assistant valide chaque saisie selon les règles spécifiques à la plateforme. Par exemple, les URL Trustpilot doivent suivre `trustpilot.<country-tld>/review/<company>`, les URL Glassdoor doivent contenir l’identifiant de l’entreprise, et les URL de produits Amazon sont réduites à leur format `/dp/<ASIN>` pour éviter les incohérences dues aux fautes de frappe.

***

### Conserver des résultats pertinents

Les plateformes publiques sont bruyantes : une marque qui est aussi une expression courante, un événement concurrent dans la même ville, ou un hashtag qui déborde sur des conversations sans rapport. BAI Analytics filtre ce qu’un agent récupère pour que votre analyse reste centrée sur votre sujet :

* **Chaque publication est vérifiée par rapport à votre objectif.** Chaque élément collecté reçoit un score pour déterminer s’il concerne réellement la marque, le produit, le lieu ou l’événement nommé dans votre objectif de surveillance. Les contenus portant sur une entité différente mais de la même catégorie sont écartés plutôt qu’importés.
* **Les commentaires sont vérifiés aussi.** Les commentaires et les réponses sont évalués sur leur propre texte, avec la publication parente comme contexte, de sorte que les réponses composées uniquement d’emojis et les fils hors sujet ne saturent plus une source.
* **Les sites d’avis sont importés tels quels.** Les avis publiés sur une page que vous avez choisie (Google Reviews, Trustpilot, une fiche d’application, etc.) concernent par définition cette entreprise, donc ils ne sont jamais filtrés.

Une source très axée sur les commentaires importera donc nettement moins d’éléments qu’un simple comptage brut de tout ce qui correspond aux mots-clés. C’est le bruit qui est éliminé, pas les données qui sont perdues.

#### Marquer un commentaire comme non pertinent

Si quelque chose passe au travers, ouvrez l’onglet **Données brutes** de la source (la vue **Flux** ) et cliquez sur **Non pertinent** sur le commentaire. La carte s’estompe, affiche une **Non pertinent** puce **Annuler**. Chaque marquage est enregistré avec la recherche qui a fait apparaître le commentaire, et l’équipe BAI Analytics examine ces cas pour améliorer le filtrage de l’agent. Le marquage n’est disponible que sur les commentaires récupérés.

***

### Exécution d’un agent

#### Choisir la fréquence d’exécution d’un agent

Lorsque vous configurez un agent, la **Planification** section demande **"À quelle fréquence doit-il s’exécuter ?"** Vous avez trois choix :

* **Exécution unique**: collecter les retours à la demande.
* **Planifié**: s’exécuter automatiquement selon une planification.
* **Continu**: s’exécuter automatiquement selon une planification récurrente ; seules les nouvelles données sont récupérées à chaque exécution.

Pour **Planifié** et **Continu** les agents, choisissez un **Quotidien** (**Quotidien**, **Hebdomadaire**, **Mensuel**, ou **Tous les 3 mois**) et l’heure de la journée en **Mensuel**. Pour **Hebdomadaire**, choisissez aussi un jour de la semaine. Pour **Mensuel** et **Tous les 3 mois**, choisissez un jour du mois. La carte de l’agent affiche alors **Suivant : …**.

{% hint style="info" %}
**Les groupes suivis se synchronisent avec leurs périodes.** Lorsque vous créez un agent continu dans un groupe de feedback qui suit les retours dans le temps (Évolution), les sélecteurs de fréquence sont remplacés par une seule planification recommandée, **Synchronisé avec les périodes de ce groupe**: de nouvelles publications sont récupérées chaque jour pour les périodes hebdomadaires (chaque semaine pour les périodes mensuelles ou trimestrielles), et chaque période est complétée juste après sa clôture, afin qu’aucune période ne reste incomplète. La carte de l’agent affiche un **Synchronisé avec les périodes** badge. Cliquez sur **Personnaliser la planification** si vous préférez définir vous-même la fréquence ; vous pouvez revenir à tout moment à la planification recommandée.
{% endhint %}

#### Première exécution vs exécutions ultérieures

La fenêtre de remontée que vous choisissez lors de la création d’un agent s’applique à la **première exécution uniquement**. Ensuite, chaque **Planifié** ou **Continu** exécution ne collecte que les **nouvelles données depuis l’exécution précédente**, vous ne payez donc pas pour extraire à nouveau les mêmes publications.

Pour **Continu** agents, une période de retour personnalisée est un seul **date de début** plutôt qu'une plage fermée : la première exécution remonte jusqu'à cette date, et chaque exécution ultérieure ne récupère que les nouveautés, donc il n'existe pas de date de fin. La carte de l'agent affiche une période de retour sans fin comme *Depuis {date}*. Seuls **Exécution unique** les agents nécessitent une date de début **et** date de fin.

Entre les exécutions planifiées, **Récupérer les données les plus récentes** sur la carte de l'agent ne récupère que les nouveaux éléments depuis la dernière exécution sans modifier la planification.

#### Où vont les données d'une nouvelle exécution

Si vous relancez manuellement un agent qui possède déjà une source dans le groupe Feedback, il vous est demandé **"Où doivent aller les nouvelles données ?"**:

* **Ajouter à la source existante**: fusionner les nouveaux éléments dans la même source.
* **Écraser la source existante**: remplacer le contenu existant par les résultats de cette exécution.
* **Créer une nouvelle source**: conserver cette exécution comme une source distincte à côté de l'ancienne.

Les sources alimentant un groupe suivi dans le temps sautent ce choix : elles sont toujours en ajout uniquement, car l'évolution nécessite que les données de chaque période soient conservées intactes.

#### Maintenir les agents continus en marche avec le rechargement automatique

L'assistant de configuration de l'agent comprend une **Recharge automatique** option :

> Ajouter automatiquement des crédits pour qu'un agent continu ne s'arrête jamais.

Les agents planifiés et continus s'interrompent si vos **Crédits Web et médias sociaux** crédits sont épuisés.

Activer **Recharge automatique** pour ajouter automatiquement des crédits lorsque votre solde passe sous un seuil que vous définissez. Le rechargement automatique nécessite un moyen de paiement enregistré.

Si une exécution planifiée ne peut pas obtenir suffisamment de crédits, la carte d'exécution affiche **L'exécution planifiée n'a pas démarré**. La raison explique ce qui a bloqué l'exécution. Les messages possibles sont :

* *Crédits insuffisants, rechargez pour reprendre.*
* *Une tentative de rechargement automatique a été effectuée, mais les crédits restent insuffisants.*
* *Aucun moyen de paiement enregistré pour le rechargement automatique.*
* *Le rechargement automatique a échoué. Veuillez vérifier votre carte.*

#### Progression en temps réel

Une fois une exécution lancée, une carte de progression affiche :

* A **barre de pourcentage** pour l'exécution globale.
* La **plateforme en cours** en cours d'extraction et les éléments collectés jusqu'à présent.
* A **grille d'état par plateforme**: des coches pour les plateformes terminées, des indicateurs de chargement pour celles en cours, une croix pour celles en erreur.
* Tout **messages d'erreur** avec un code spécifique à la plateforme.

Vous pouvez continuer à travailler dans un autre onglet ; la progression est suivie de manière centralisée et la notification vous suit.

#### Exécutions bloquées et échouées

Une exécution qui se bloque est automatiquement marquée comme échouée afin que vous puissiez en lancer une nouvelle. Les crédits débités au début d'une exécution échouée sont automatiquement remboursés. Si la vérification de pertinence d'une plateforme ne peut pas se terminer, cette plateforme est marquée comme échouée et peut être relancée, au lieu d'importer un résultat discrètement incomplet.

#### Annulation

Cliquez sur **Arrêter l'agent** sur la carte de l'agent pendant une exécution pour l'arrêter plus tôt. Les données déjà extraites sont conservées ; les plateformes en cours sont interrompues proprement.

#### Nouvelle tentative

Si une exécution échoue ou échoue partiellement (par ex. une plateforme a échoué tandis que deux ont réussi), l'historique d'exécution propose en un clic un **Réessayer**.

***

### À quoi ressemblent les données extraites dans un groupe Feedback

Chaque élément extrait (un avis, une publication, un commentaire, une mention d'actualité) devient une réponse structurée dans le groupe Feedback de destination, cartographiée comme suit :

| Champ                          | Source                                                       | Utilisé pour                                                                                                |
| ------------------------------ | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| **Réponse** *(Réponse longue)* | Le corps principal du texte (avis, publication, commentaire) | Détection de thèmes, sentiment, analyse par IA.                                                             |
| **Source** *(Métadonnées)*     | Le nom de la plateforme (par ex. *Avis Google*)              | Segmentation : filtrer les analyses par plateforme.                                                         |
| **URL** *(Métadonnées)*        | Lien direct vers la publication d'origine                    | Accès depuis l'analyse vers la source.                                                                      |
| **Note** *(Métadonnées)*       | Note de 1 à 5 étoiles (plateformes d'avis)                   | Vérification croisée du sentiment sur le site d'avis ; utilisée dans le graphique de répartition des notes. |
| **J'aime** *(Métadonnées)*     | Nombre d'interactions                                        | X / Twitter uniquement ; disponible comme dimension de segmentation.                                        |

Comme tout finit sous forme de réponses standard, les données extraites participent pleinement à **Thèmes groupés (anciennement appelés Super-thèmes)** au niveau du groupe Feedback, peuvent être **filtrées par date ou sentiment** dans la vue d'analyse, et peuvent être **intégrées aux rapports** aux côtés des réponses aux sondages et des tickets de connecteurs.

La note moyenne en étoiles affichée dans l'en-tête de l'analyse n'apparaît que lorsque la source inclut une plateforme d'avis (Google Reviews, Trustpilot, TripAdvisor, Avis Vérifiés, Glassdoor, Indeed, Google Play, Apple App Store, Amazon) ; les sources sociales n'ont pas de score en étoiles.

La surveillance n'est pas configurée dans l'assistant de l'agent : les moniteurs du groupe avec **Couvrir automatiquement les nouvelles sources** surveillent automatiquement les nouvelles sources de l'agent, et l'assistant indique lesquels s'appliqueront. Voir [Surveillance personnalisée](/boundaryai-docs/boundaryai-docs-fr/analyser-vos-retours/custom-monitoring.md).

#### La carte Source de données

Dans l'aperçu qualitatif de la source d'un agent, une *Source de données* carte affiche :

* A **répartition par plateforme** avec le nombre d'éléments par plateforme.
* A **graphique de répartition des notes** (de 1 à 5 étoiles) pour les plateformes d'avis, un aperçu visuel rapide du sentiment global issu des sites d'avis.
* La **dernière collecte** date.
* A **bannière d'avertissement des plateformes en échec** si une plateforme a rencontré une erreur lors de la dernière exécution, avec la liste des plateformes concernées.
* Liens directs vers **Gérer les agents** et **Données brutes**.

***

### Répondre à ce que vous collectez

Chaque commentaire ou avis extrait comporte un **Répondre** bouton partout où il apparaît dans l'analyse : l'onglet Données brutes, la vue par plateforme, Thematics, Surveillance personnalisée, et les panneaux de preuves des thèmes groupés et des moniteurs. Cliquer dessus vous mène au bon endroit pour répondre, avec une réponse rédigée par IA pour commencer :

* **Réponse suggérée.** Dès que vous ouvrez Répondre, BAI Analytics rédige une courte réponse fondée sur le texte et le ton de l'avis (une ou deux phrases, dans la langue de l'avis, sans formule toute faite). Modifiez-la librement ; elle est indiquée comme une suggestion générée par IA à relire avant publication. Si aucune suggestion ne peut être générée, vous rédigez simplement la vôtre.
* **X (Twitter)**: continuer ouvre le rédacteur de réponse natif de X avec votre brouillon déjà rempli.
* **Reddit, Facebook, Instagram, TikTok, LinkedIn, YouTube, Google Reviews**: continuer ouvre la publication ou le commentaire exact dans un nouvel onglet ; copiez votre réponse et collez-la là.
* **Trustpilot, TripAdvisor, Avis Vérifiés, Glassdoor, Indeed, Google Play, Apple App Store, Amazon**: les réponses sont publiées depuis votre compte professionnel ou développeur sur la plateforme, donc la fenêtre modale cite l'avis, propose **Copier**, et ouvre votre console professionnelle. Un lien secondaire affiche l'avis lui-même lorsque la plateforme en fournit un.
* **Google News** et **Les réponses IA** n'ont rien à quoi répondre, donc aucun bouton n'est affiché.

Vos identifiants de plateforme ne transitent jamais par BAI Analytics : vous vous connectez sur le site propre de chaque plateforme.

***

### Gestion des agents

La carte de chaque agent affiche un total cumulé : le nombre total d'éléments collectés sur toutes les exécutions à ce jour, pas seulement la plus récente, afin que vous puissiez voir d'un coup d'œil la taille globale d'une source.

Chaque agent apparaît sous forme de carte dans l'onglet **Mes agents** avec des actions rapides :

* **Exécuter maintenant**: lancer une nouvelle exécution ; le sélecteur d'intensité et une estimation des crédits apparaissent d'abord (**Confirmer et lancer**).
* **Récupérer les données les plus récentes**: récupérer uniquement les nouveaux éléments depuis la dernière exécution, sans modifier la planification.
* **Configurer**: rouvrir l'assistant avec la configuration enregistrée de l'agent. L'intensité est détectée automatiquement à partir des limites enregistrées, afin qu'un agent réglé sur mesure ne perde pas ses paramètres lors de la modification.
* **Renommer l'agent**: le nouveau nom est appliqué à l'agent, à sa source et à ses libellés d'analyse.
* **Voir l'analyse**: accéder à la page d'analyse de la source.
* **Arrêter l'agent**: arrêter une exécution en cours.
* **Enregistrer comme modèle**: voir les modèles ci-dessous.
* **Supprimer**: supprimer définitivement l'agent.

La carte se met à jour automatiquement pendant qu'une exécution est en cours, vous pouvez donc suivre la progression sans actualiser.

#### Historique d'exécution

Chaque agent dispose d'un **historique d'exécution** avec :

* Une ligne par exécution, indiquant l'heure de démarrage, les éléments collectés, les éléments importés (après déduplication et filtrage de pertinence), le statut et un bref résumé d'erreur le cas échéant.
* A **répartition par plateforme** pour chaque exécution : quelles plateformes ont réussi, lesquelles ont échoué, et le nombre d'éléments pour chacune.
* A **Réessayer** bouton sur les exécutions échouées ou partiellement échouées qui réutilise la même configuration.

C'est l'endroit où aller pour enquêter sur « pourquoi y a-t-il eu moins d'éléments cette semaine » ou « pourquoi Trustpilot a-t-il cessé de renvoyer des données » sans quitter BAI Analytics.

***

### Modèles

Si vous créez une configuration d'agent qui fonctionne bien (par exemple, une configuration d'écoute de marque sur plusieurs plateformes), vous pouvez l'enregistrer avec **Enregistrer comme modèle** sur la carte de l'agent. Les modèles :

* Devenir **clonable** au sein de votre organisation depuis l'onglet **Modèles** afin qu'un coéquipier puisse lancer un agent similaire en quelques secondes avec **Utiliser le modèle**.
* Sont indépendants des versions. La modification de l'agent d'origine ne change pas rétroactivement les clones.
* Sont utiles pour **procédures standard** (surveillance d'événements, écoute de lancement de produit, suivi des concurrents) que vous prévoyez de relancer.

***

### État de la plateforme

A **Statut** bouton sur la page Agents ouvre la **État de la plateforme** fenêtre modale : un contrôle de santé en temps réel pour chaque plateforme prise en charge, basé sur les exécutions des 48 dernières heures (Opérationnelle / Dégradée / Hors service, avec le taux de réussite). Utilisez-le pour déterminer si une mauvaise exécution vient de votre configuration ou d'un problème temporaire côté plateforme. Un **Rafraîchir** bouton force une nouvelle vérification.

***

### En quoi les agents diffèrent des connecteurs et des importations

| Fonctionnalité          | À utiliser pour                                                                       | Authentification            | Cadence                           |
| ----------------------- | ------------------------------------------------------------------------------------- | --------------------------- | --------------------------------- |
| **Agents (cette page)** | Données publiques : avis, publications sociales, actualités                           | Aucune (automatisation web) | À la demande, planifié ou continu |
| **Connecteurs**         | Données dans les outils que vous possédez : support, développement, gestion de projet | Connexion sécurisée         | Continu (30 min)                  |
| **Importations**        | Exports historiques ou de tiers                                                       | Aucune                      | Ponctuel                          |
| **Sondages**            | Contact direct auprès de répondants connus                                            | Code d'accès facultatif     | À la soumission du répondant      |

Vous pouvez mélanger les quatre dans un seul groupe Feedback, et les analyses de BAI Analytics les traitent de manière uniforme.

***

### Bonnes pratiques

* **Commencez par un objectif précis.** *"Sentiment de marque pour X sur les principaux sites d'avis et Twitter"* donne un agent plus ciblé et plus utile que *"Retour client."* L'objectif pilote aussi le filtrage de pertinence, alors nommez précisément la marque, le produit ou l'événement.
* **Choisissez l'intensité adaptée à la cadence.** Une exécution Standard hebdomadaire pour une petite marque suffit généralement ; une exécution Standard quotidienne pour une grande marque peut manquer des données. Passez plutôt en Élevé.
* **Utilisez un groupe Feedback dédié par sujet.** Ne mélangez pas l'écoute de marque et les retours des employés dans le même groupe ; les thèmes groupés seront confus. Les agents Glassdoor et Indeed doivent avoir leur propre groupe.
* **Validez les sources après la première exécution.** La fenêtre modale État de la plateforme et la vue de l'historique d'exécution vous indiquent quelles plateformes renvoient des données. Si une plateforme est systématiquement vide, vérifiez à nouveau l'URL ou le pseudo.
* **Signalez ce qui est passé au travers.** Quelques **Non pertinent** marques sur les commentaires hors sujet aident l'équipe à ajuster les filtres de l'agent.
* **Traitez&#x20;*****Personnalisé*****&#x20;l'intensité comme l'exception, pas comme la valeur par défaut.** Les trois niveaux prédéfinis couvrent la plupart des cas d'usage ; *Personnalisé* est destiné aux utilisateurs avancés qui savent exactement quelle limite propre à la plateforme ils veulent pousser.
* **Enregistrez les configurations éprouvées comme modèles.** Une équipe qui mène l'écoute de marque sur plusieurs produits va construire la même configuration à plusieurs reprises. Les modèles suppriment ce travail répétitif.
* **Relances tenant compte des remboursements.** Les exécutions échouées remboursent les crédits, donc relancer un agent en échec est sans risque. Vous ne serez pas facturé deux fois.
