Aller au contenu
Trustt

Playbook — Lire les avis publiés d’un produit

Public : tous les profils utilisateurs (depuis le 01/09/2026) Connexion : menu Assistant IA (MCP) > Connexion (Claude / Cursor en un clic ; autres assistants via l’URL MCP) Intention : consulter les verbatims déjà publiés d’un produit (pas la file à modérer) Module requis : Trustt Reviews (accès lecture à la marque ; le droit de modération n’est pas requis) Personas primaires : Brand / Product Manager, Marketing Lead


Prompt type

Montre les avis publiés du produit [nom exact OU GTIN OU URL fiche OU UUID produit]
sur la marque [nom]. Format lignes, note ≥ 3, avec photos si possible.
Enchaîne les pages via le curseur tant qu’il reste des avis.

Chaîne d’outils

  1. get_user_brands — retrouver l’identifiant de marque (brand_uuid) si besoin
  2. get_product_reviews — page d’avis publiés du produit (note 1–5, modération publiée)
  3. En cas d’ambiguïté produit : reprendre l’appel avec le product_uuid d’un candidat renvoyé
  4. Pour la page suivante : rappeler cursor = next_cursor tant qu’il n’est pas nul

⚠️ Ne pas confondre avec get_pending_reviews (file à modérer) ni avec get_brand_catalog_stats (volumes et notes, sans textes d’avis).


Identifiant produit

Exactement un identifiant parmi :

Paramètre Règle
product_name Nom exact (égalité stricte, pas de recherche partielle)
gtin GTIN exact
product_url URL de la fiche e-commerce
product_uuid UUID produit (après désambiguïsation)

Zéro ou plusieurs identifiants → paramètre invalide.


Formats de sortie

Format Usage
lines (défaut) Une ligne par avis : date, note, langue, texte ; photos et profil fermé seulement s’ils existent ; dept: NN si la ville est publique
json Champs structurés sans URL photo
full Comme json + URL des photos visibles

Filtres optionnels courants : min_rating / max_rating, date_from, has_photos, limit (défaut 40, plafond 80 avis).


Contenu exposé (vie privée)

Exposé par défaut Non exposé par défaut
Texte / titre / critères d’avis, photos visibles Pseudo, e-mail, nom, adresse, âge calculé depuis la date de naissance
Critères de profil fermés (radio, liste, tranche d’âge) Ville, code postal complet, pays
Département (2 premiers chiffres du code postal) si la ville du compte est publique Lieu si ville privée

include_author=true (même scope reviews.read) ajoute le pseudo (celui de l’iframe, « Utilisateur vérifié » si l’avis est anonymisé) et la ville, le code postal et le pays lorsque la ville est publique.

La réponse JSON compacte est aussi coupée vers 60 000 caractères : les avis sont ajoutés un par un. Si la page s’arrête avant limit, un curseur reste présent — le rappeler pour la suite. max_body_chars tronque le texte de chaque avis.


Livrable attendu


Garde-fous

Règle Détail
Lecture seule Aucune écriture ; pour valider / rejeter → Modération des avis
Scope reviews.read (même scope que la file de modération et les stats catalogue ; grain différent)
Trustt AI Le widget ne précharge pas cet outil : question « avis publiés d’un produit » → pas de verbatims dans Trustt AI
Mots-clés « avis en attente » Dirigent vers get_pending_reviews, pas vers cet outil

Les schémas et codes d’erreur de get_product_reviews sont fournis à l’assistant par le serveur MCP.


Alternative dans la plateforme


Voir aussi