Playbook — Analyser une campagne ambassadeur
Utilisez cette page pour croiser, sur une campagne, les réponses d’inscription, les fiches du panel, les tests d’usage, les avis déposés et les publications déjà rattachées. La fiche de toutes les candidatures (y compris refusées) est une lecture à part, en fin de page.
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 : analyser une campagne ambassadeur (inscription, fiche, tests d’usage, avis, publications) Module requis : Community Builder (accès lecture à la campagne) Personas primaires : Influence / Community, Brand / Product Manager
Pourquoi : cinq lectures séparées, jointes par la même personne, évitent d’ouvrir le formulaire, la fiche, le test, l’avis et la publication un écran après l’autre.
Bénéfice : un brief qualitatif du panel (ce qui a été répondu, noté, publié) sans mélanger le catalogue produit ni la liste des actions en attente.
Selon votre profil
| Profil | Ce qu’il faut faire en priorité |
|---|---|
| Influence / Community | Lancer les cinq lectures sur la campagne, relier les lignes par candidate_uuid, repérer qui a répondu au test, déposé un avis, publié. |
| Brand / Product Manager | Lire les verbatims de test et les avis de la campagne. Ces avis ne sont pas les avis publiés du catalogue. |
| Marketing Lead | Demander une synthèse (thèmes, notes, EMV). L’e-mail, le ton Qualité email, le nom, l’indicateur influenceur, l’audience des comptes scannés et les étiquettes CRM ne sortent que de la fiche. |
1. Prompt type
Analyse la campagne [nom] : réponses d’inscription du panel, fiches, tests d’usage, avis déposés et publications rattachées.
Même identifiant de campagne pour les cinq lectures. Relie les lignes par candidate_uuid.
Rappelle le curseur tant que next_cursor n’est pas none.
E-mail, ton Qualité email, nom, indicateur influenceur, audience des comptes scannés et étiquettes CRM seulement depuis la fiche.
2. Chaîne d’outils
get_user_brands— retrouver la marque si besoinget_brand_campaigns— retrouvercampaign_uuidà partir du nom. La liste indique aussi, pour chaque campagne, si elle attend des tests d’usage (expectsUsageTest), un avis sur le site marchand (expectsMerchantReview, avec l’adresse de la boutique dansmerchantReviewUrl) ou un avis sur le site de livraison (expectsExternalDeliveryReview). Sans test d’usage attendu, la lectureget_campaign_usage_test_answersest inutile.- Les cinq lectures ci-dessous, avec le même
campaign_uuid - Joindre les lignes sur
candidate_uuid - Page suivante : rappeler
cursor=next_cursortant que la valeur n’est pasnone
⚠️
get_campaign_ambassadorsliste les actions en attente du panel. Il ne remplace aucune des cinq lectures.
⚠️
get_product_reviewslit les avis publiés d’un produit (catalogue).get_campaign_reviewslit les avis déposés par les ambassadeurs de la campagne.
3. Les cinq lectures
Toutes : scope campaigns.read, format texte lines, plafond 60 000 caractères par page, clé personne candidate_uuid. Il n’y a pas de uuid_tester dans ces sorties. Paramètre commun optionnel : user_uuid.
| Outil | Rôle | Paramètres utiles | Ligne (après les en-têtes) |
|---|---|---|---|
get_campaign_registration_answers |
Réponses au formulaire d’inscription | ambassadors_only défaut true (panel sélectionné) ; false = aussi les candidats non retenus ; candidate_uuid ; limit défaut 50, plafond 100 ; cursor |
candidate_uuid | date | qN:valeur — en-têtes # form= et # legend: |
get_campaign_ambassador_profiles |
Fiche du panel sélectionné : prénom, nom, e-mail, ton Qualité email, téléphone, adresse, indicateur influenceur, réseaux et audience du compte scanné, étiquettes CRM, rappel court des critères d’inscription | candidate_uuid ; limit 50 / 100 ; cursor |
candidate_uuid | prénom | nom | e-mail | mail | téléphone | adresse | inf | réseaux | étiquettes | qN |
get_campaign_usage_test_answers |
Réponses reçues aux tests d’usage (formulaire de type test, pas l’inscription) | candidate_uuid ; limit 50 / 100 ; cursor |
candidate_uuid | date | qN:valeur — en-têtes # form= et # legend: |
get_campaign_reviews |
Avis déposés par les ambassadeurs de la campagne | candidate_uuid ; limit défaut 40, plafond 80 ; min_rating / max_rating de 1 à 5 ; cursor |
candidate_uuid | uuid_review | date | note | texte | ph:n | v:0|1 — en-tête # ratings |
get_campaign_social_posts |
Publications sociales déjà rattachées aux ambassadeurs | candidate_uuid ; limit 50 / 100 ; cursor |
personne, date, réseau, type, compte, URL (identité de la publication), likes, commentaires, vues, partages, EMV campagne, légende |
ph:n = nombre de photos (ph:0 s’il n’y en a pas). v:1 = avis avec vidéo, v:0 = sans vidéo. Sur une publication, les chiffres sont préfixés lk: (likes), cm: (commentaires), vw: (vues), sh: (partages), emv: (EMV campagne).
ambassadors_only à false inclut des candidats non retenus : ces personnes n’ont pas de ligne dans get_campaign_ambassador_profiles. Leur fiche est dans la lecture de toutes les candidatures.
Fiche — ton d’e-mail. mail a trois valeurs, les mêmes que la pastille Qualité email : joignable, injoignable, non_verifie. L’absence d’injoignable n’est pas joignable : un e-mail non vérifié reste non_verifie.
Fiche — influenceur et comptes scannés. inf=1 seulement si le compte est marqué influenceur ; toute autre situation donne inf=0. Le jeton est toujours présent. Sur un réseau, st=0 signifie compte scanné non utilisable : pas d’abonnés ni de moyennes ; la date scan= reste si elle existe. Une valeur de st autre que 0 (en pratique st=1, compte utilisable) ajoute f (abonnés), l (likes moyens), c (commentaires moyens), e (engagement moyen), emv (EMV moyen) et s (partages moyens), plus scan (dernier scan). Une moyenne absente en base n’apparaît pas ; f=0 et e=0.0 sont des valeurs réelles. Un réseau sans st est un compte déclaré, non rapproché d’un scan : le nom seul. Aucune lecture ne relance un scan.
Fiche — étiquettes CRM. Le segment liste les étiquettes déjà liées au contact de l’entreprise de la marque. Préfixe sys: si l’étiquette est système (Product explorer, Risky, et toute autre étiquette système liée). Une étiquette de l’entreprise s’écrit sans préfixe. Segment vide s’il n’y a pas de contact correspondant ou pas d’étiquette. Pas d’identifiant, pas de couleur.
L’assistant connecté reçoit le détail de chaque clé directement du serveur MCP.
4. Pagination et jointure
Chaque page annonce le total, le nombre de lignes renvoyées et next_cursor.
| Signal | Action |
|---|---|
next_cursor a une valeur autre que none |
Rappeler l’outil avec cursor = cette valeur, mêmes filtres (candidate_uuid, et ambassadors_only pour l’inscription) |
next_cursor = none |
Dernière page |
Page plus courte que limit |
Le plafond de 60 000 caractères a coupé la page : le curseur reste valable, le rappeler |
La jointure se fait uniquement sur candidate_uuid. Une publication n’a pas d’UUID : son identité est l’URL.
5. Contenu exposé
| Lecture | Exposé | Non exposé |
|---|---|---|
| Inscription | candidate_uuid, date, réponses qN |
E-mail, nom |
| Fiche | Prénom, nom, e-mail, mail (joignable, injoignable ou non_verifie), téléphone, adresse, inf=1 ou inf=0, réseaux, audience du compte scanné quand il est utilisable, étiquettes CRM (sys: si étiquette système), rappel des critères d’inscription |
Réponses détaillées de test d’usage (elles sont dans l’outil test). Pas d’audience si le compte scanné n’est pas utilisable (st=0) ou s’il n’est pas rapproché. Pas le formulaire d’inscription entier |
| Test d’usage | candidate_uuid, date, réponses qN |
E-mail, nom |
| Avis de campagne | candidate_uuid, uuid_review, date, note, texte, compteur de photos, indicateur vidéo |
Pseudo, e-mail, nom |
| Publications | candidate_uuid, date, réseau, type, compte, URL, likes, commentaires, vues, partages, EMV campagne, légende (coupée à 400 caractères) |
E-mail, nom, UUID de publication |
6. Garde-fous
| Règle | Détail |
|---|---|
| Lecture seule | Aucune écriture, aucun envoi, aucune modération |
| Scope | campaigns.read |
| Hors widget Trustt AI | Ces cinq lectures, et la fiche de toutes les candidatures, ne sont pas préchargées dans le widget. Une question dans Trustt AI ne renvoie pas ces textes |
| Panel | Sauf ambassadors_only à false sur l’inscription : panel sélectionné, hors ambassadeurs de démonstration |
| Publications | Hors posts supprimés, hors posts sans ambassadeur, hors posts de démonstration |
| Avis catalogue | Verbatims d’un produit e-shop → Avis publiés d’un produit |
Les schémas et codes d’erreur sont fournis à l’assistant par le serveur MCP — contrats get_campaign_registration_answers, get_campaign_ambassador_profiles, get_campaign_candidate_profiles, get_campaign_usage_test_answers, get_campaign_reviews, get_campaign_social_posts.
7. Limites connues
Plafonds relus sur le contrat serveur le 03/10/2026. Indicateur influenceur, audience des comptes scannés, ton Qualité email, étiquettes CRM et fiche de toutes les candidatures relus le 05/10/2026.
- Page coupée à 60 000 caractères, avant
limits’il le faut. - Légende de publication coupée à 400 caractères.
- Avis de campagne : pas de statut de modération dans cette lecture (note supérieure à 0, personne du panel).
- Les questions
qNdes tests, de l’inscription et des avis ne partagent pas la même numérotation : l’en-tête# legend:de chaque page fait foi. - Un
candidate_uuidhors population renvoie un total à 0, sans erreur. - La fiche du panel ne couvre pas les candidatures refusées ni les candidatures pas encore retenues. Ces personnes sont dans la fiche de toutes les candidatures.
8. Fiche de toutes les candidatures
get_campaign_candidate_profiles reprend la même fiche (identité, mail, inf, réseaux, étiquettes, rappel qN) sur toutes les candidatures de la campagne, y compris refusées et déjà passées ambassadeur. Scope campaigns.read. Hors widget Trustt AI. Plafond 60 000 caractères, limit défaut 50, plafond 100, curseur opaque.
Quatre jetons en plus, après les étiquettes :
| Jeton | Sens |
|---|---|
reg |
Date d’inscription. Segment vide s’il n’y a pas de date |
form=1 / form=0 |
Formulaire d’inscription complet, ou non |
sel |
Verdict. En-tête coselection=1 : untreated, validated, to_study, refused. En-tête coselection=0 : untreated ou retained |
prosp=1 / prosp=0 |
prosp=1 si la personne est dans une séquence de cette campagne, même compte, et que la date d’inscription est postérieure au début calendaire de la séquence. Les trois écrans SaaS (tableau de bord, Candidatures, page séquence) attribuent autrement : inscription strictement après le premier email envoyé à ce contact — un prosp=1 peut donc dépasser le chiffre affiché dans l’interface |
Filtres : candidate_uuid ; selection (all par défaut, untreated, to_study, retained, refused) ; from_prospecting (absent = pas de filtre ; oui = seulement prosp=1 ; non = seulement prosp=0).
selection=retained alors que la co-sélection est active garde les personnes dont la ligne affiche sel=validated. to_study ou refused alors que la co-sélection est éteinte : page vide et avertissement coselection_off.
Cette lecture ne score pas les candidatures (le score reste Sélection du panel) et ne renvoie pas le formulaire entier (les réponses détaillées restent get_campaign_registration_answers).
Alternative dans la plateforme
- Campagne en cours — panel, actions en attente, avis à relancer
- Publications sociales — publications dans l’interface
- Trustt AI — actions en attente du panel ; pas ces cinq lectures ni la fiche de toutes les candidatures
Voir aussi
- Hub MCP
- Prompts prêts
- Suivi campagne
- Avis publiés d’un produit
- Funnel ambassadeurs
- Sélection du panel — score et refus ; pas la fiche