Spécifications techniques Trustt
Utilisez cette page pour préparer vos fichiers (visuels, imports CSV), intégrer Trustt à votre CRM / PIM / outil externe, et connaître les endpoints APIs et webhooks disponibles.
Pour qui Ops / Data Manager, développeur intégrateur, IT/CTO · Module transverse · Difficulté intermédiaire · Temps de lecture 8 min
Pourquoi cela compte
Un fichier au mauvais format, une colonne CSV manquante ou une clé API mal renseignée peut bloquer la mise en route pendant 48-72 h, le temps d'un aller-retour ticket support. Cette page centralise les valeurs à respecter pour préparer les fichiers et les intégrations en moins de 2 jours, sans dépendre du support.
Selon votre profil
| Profil | Ce que ça change pour vous |
|---|---|
| Ops / Data Manager | Sections Visuels + Imports CSV : formats logo/photos + colonnes obligatoires pour l'import contacts et catalogue produits. |
| Développeur intégrateur | Sections APIs + Webhooks : endpoints REST disponibles (Trustt SMS, Campaign Useguide, MCP), auth par clé API, structure JSON. |
| IT / CTO | Section Limites connues + Méthodologie : ce que Trustt supporte / ne supporte pas nativement en V1, roadmap intégrations. |
1. Formats et poids max — visuels
Trustt accepte exclusivement JPG, JPEG et PNG pour tous les uploads d'images. Les autres formats (GIF, WebP, HEIC, TIFF, SVG) sont refusés.
| Usage | Formats | Fond recommandé | Résolution min | Résolution recommandée | Notes |
|---|---|---|---|---|---|
| Logo marque | JPG, PNG | Blanc (JPG) ou transparent (PNG) | 250 px de large | 500-800 px de large | Affiché dans le header de tous les emails + mode d'emploi. Voir Informations de la marque § 4 Logo |
| Visuel produit campagne | JPG, PNG | Neutre / packshot | 800 × 800 px | 1200 × 1200 px | Affiché sur la page campagne publique + emails d'invitation |
| Photo ambassadeur (avatar) | JPG, PNG | Portrait | 200 × 200 px | 400 × 400 px | Auto-uploadée par l'ambassadeur depuis son espace |
| Cover EMV / bandeau email | JPG, PNG | Cohérent charte | 600 px de large | 1200 px de large | Utilisé dans les emails Marketing Automation (voir spec EMV 2026052) |
| Photo d'avis / UGC (avant/après, swatches) | JPG, PNG | Libre | 400 × 400 px | 800 × 800 px | Uploadée par l'ambassadeur avec son avis. Supprimée à l'anonymisation (voir module-avis § 6) |
| Vignette publication sociale (matching manuel) | JPG, PNG | Screenshot post | libre | 800 px de large | Ajouté manuellement via Ajouter une publication |
ℹ️ Poids maximum par fichier : hérité de la config PHP serveur (
upload_max_filesize+post_max_size, valeur par défaut Trustt = 10 Mo par fichier, 50 Mo par requête). Un fichier > 10 Mo est refusé avec un message explicite. Si vous devez uploader plus lourd (vidéo, PDF haute résolution), contactez votre chargé de compte.
Écueils fréquents
- ❌ Format WebP (généré par défaut par certains PIM Shopify) → refusé, à convertir en PNG ou JPG avant upload
- ❌ Format HEIC (iPhone) → refusé, à convertir en JPG
- ❌ Format SVG (logos vectoriels) → non supporté V1, exporter en PNG à 500-800 px de large
- ❌ Fichier > 10 Mo → refusé, redimensionner ou compresser (recommandé : TinyPNG, Squoosh)
- ❌ Nom de fichier avec caractères spéciaux (accents, espaces, /) → peut poser problème sur certains navigateurs, préférer
nom-du-fichier.jpg
2. Formats vidéo et PDF
Vidéo
Les vidéos ne sont pas uploadées directement dans Trustt V1 (ni dans les campagnes, ni dans les avis, ni dans le programme ambassadeur). Elles sont hébergées ailleurs (YouTube, Vimeo, TikTok, Instagram) et liées par URL :
| Usage | Support | Format | Notes |
|---|---|---|---|
| Vidéo de présentation de la marque | YouTube, Vimeo | URL publique | Voir Informations de la marque § 11 Vidéo de présentation |
| Vidéo publication sociale | Instagram Reels, TikTok, YouTube Shorts | URL publique | Matching automatique via hashtag/mention ; matching manuel via Ajouter une publication |
Aucun upload PDF n'est actuellement supporté côté client (les modes d'emploi sont générés dynamiquement en HTML/PDF côté serveur Trustt). Si votre besoin implique un upload PDF (fiche produit, contrat), contactez votre chargé de compte pour arbitrer.
3. Imports CSV — Contacts
Où importer
Marque > Contacts > menu Actions > Importer. Voir Liste des contacts § 10 Import.
Format attendu
| Propriété | Valeur |
|---|---|
| Format fichier | CSV (.csv) |
| Encodage | UTF-8 obligatoire (un fichier Latin-1 est refusé) |
| Séparateur de colonnes | Virgule (,) ou point-virgule (;) — auto-détecté |
| Délimiteur de texte | Guillemets doubles (") pour les valeurs contenant , ou ; |
| Ligne 1 | En-têtes de colonnes obligatoires |
| Colonne obligatoire | email (ou Email / E-mail — la colonne est détectée automatiquement au mapping) |
| Colonnes optionnelles | firstname, lastname, phone, city, country, + tous vos champs personnalisés définis dans Configuration > Champs personnalisés |
| Doublons | Un contact déjà présent (même email) est mis à jour, pas dupliqué. Source affichée : Import. |
Colonnes recommandées pour la conformité RGPD
Selon la source de vos contacts et le contrat de conformité de votre DPO, il est recommandé d'inclure aussi :
| Colonne | Type | Exemple | Pourquoi |
|---|---|---|---|
consent_date |
Date ISO 8601 | 2026-05-14T10:32:00Z |
Trace de la date de consentement (obligation RGPD art. 7-1) |
consent_source |
Texte | formulaire-newsletter-site |
Justifie l'origine du consentement |
consent_type |
Texte | optin-newsletter ou client-achat |
Distingue prospection commerciale vs client existant |
⚠️ Sans colonne
consent_date+consent_source, votre DPO ne peut pas prouver la licéité du traitement en cas de contrôle CNIL. Trustt ne bloque pas l'import mais la responsabilité juridique reste côté marque.
💡 Ces colonnes sont conservées telles quelles (elles ne se mettent pas à jour ensuite) et l'import ne renseigne pas l'opt-in. Pour des contacts déjà présents sur une autre marque de la même entreprise, la colonne
Écueils fréquents
- ❌ Fichier Excel (
.xlsx) → non supporté, exporter en CSV UTF-8 - ❌ Encodage Windows-1252 avec accents → caractères cassés, ré-enregistrer en UTF-8
- ❌ Séparateur tabulation (
.tsv) → non supporté, convertir en CSV - ❌ Emails invalides (typos,
@@, sans.) → refusés silencieusement au parsing (à corriger avant import) - ❌ Colonne email nommée
mailoucourrielsans mapping manuel → l'import n'est pas validé (voir alerte à l'écran)
4. Imports catalogue produits
Trustt ne propose pas d'import CSV direct de catalogue produits en V1. Le catalogue vient de la boutique : sur Marque > Catalogue, le bouton Actualiser synchronise les produits. Il n'y a pas de bouton pour ajouter un produit à la main.
| Source | Méthode | Documentation |
|---|---|---|
| Shopify | Connecteur OAuth (Trustt App dans Shopify App Store) | Voir Module avis § 3 Récupération des commandes |
| PrestaShop | Module Trustt Reviews (ZIP à installer) | Voir Module avis § 5 Installation |
| WooCommerce, Magento | Plugin dédié | Voir Module avis § 5 Installation |
| PIM externe (Akeneo, Salsify, etc.) | API REST ou export manuel | Contacter le chargé de compte pour arbitrage cas par cas |
Le détail des boutons (Actualiser, GTIN, Audit) est dans Catalogue produits. Le GTIN d'un produit déjà synchronisé se saisit à l'unité ou par import fichier.
GTIN et code-barres
Le GTIN (Global Trade Item Number, 13 chiffres du code-barres produit) est obligatoire pour activer Google Merchant Center et la diffusion des étoiles d'avis dans les résultats Google Shopping. Voir Google Merchant Center § 3 GTIN pour la structure attendue et la procédure.
5. APIs REST disponibles
Toutes les APIs Trustt utilisent une authentification par clé API (key en query string ou header X-API-Key selon l'endpoint). Les clés sont provisionnées par publisher / partenaire (pas de self-service V1).
| Nom | URL de base | Auth | Rate limit | Documentation |
|---|---|---|---|---|
| API Trustt SMS | /api_trusttsms/* |
key={secret} en query |
Aucun V1 (à venir) | Sur demande au chargé de compte |
| API Campaign Useguide | /api/get_campaign_useguide |
key={secret} en query |
Aucun V1 | Sur demande au chargé de compte |
| MCP (Model Context Protocol) | https://pro.trustt.io/mcp (HTTPS SSE) |
OAuth 2.1 | Standard MCP | Assistant IA (MCP) |
| Chatbot Trustt AI | Intégré dans l'app (pas d'API publique V1) | Session utilisateur | — | Trustt AI |
API Trustt SMS — 6 endpoints (V1)
Réservée à l'outil externe Trustt SMS (partenaire) — permet de parcourir companies → marques → campagnes → ambassadeurs sélectionnés et de déclarer / annuler la réception produit.
| # | Méthode | URL | Description |
|---|---|---|---|
| 1 | GET |
/api_trusttsms/companies?key={key} |
Companies avec contrat Community Builder actif |
| 2 | GET |
/api_trusttsms/brands?key={key}&coid={uuid} |
Marques prod d'une company |
| 3 | GET |
/api_trusttsms/campaigns?key={key}&bid={uuid} |
Campagnes éligibles d'une marque |
| 4 | GET |
/api_trusttsms/ambassadors?key={key}&caid={uuid} |
Ambassadeurs sélectionnés d'une campagne |
| 5 | POST |
/api_trusttsms/save_receipt |
Déclaration de réception produit (JSON body) |
| 6 | POST |
/api_trusttsms/cancel_receipt |
Annulation d'une déclaration de réception (JSON body) |
API Campaign Useguide — 1 endpoint
Réservé aux marques disposant d'un contrat Community Builder actif. Retourne le mode d'emploi structuré d'une campagne (utilisé par l'éditeur WYSIWYG de mode d'emploi).
GET /api/get_campaign_useguide?uuid_campaign={uuid}&key={key}
Retour : JSON avec sections brand, product/event, ugcReview, ugcSocialPost, delivery, compensation, photos, video… variables selon le type de campagne et les options activées.
MCP (Model Context Protocol)
Serveur MCP standardisé permettant à un LLM externe (Claude, ChatGPT Enterprise via connecteur, Cursor) de consulter le contexte Trustt (marque, campagnes, avis, ambassadeurs). Auth OAuth 2.1. ~30 tools disponibles (compte, marque, campagne, écriture avec humain dans la boucle). Voir MCP Trustt § 4 Cartographie des outils.
6. Webhooks et notifications sortantes
Périmètre V1
Les webhooks sortants Trustt sont réservés aux publishers / partenaires OEM (ex. revendeurs de la stack Trustt sous marque blanche). Ils ne sont pas configurables par une marque cliente standard en V1.
Événements disponibles (publishers uniquement)
| Événement | Trigger | Payload |
|---|---|---|
campaign.progress_updated |
Changement de id_progress sur une campagne (voir campagne-en-cours § Mises à jour automatiques) |
JSON avec campaign_uuid, old_progress, new_progress, timestamp |
campaign.canceled |
Passage manuel en statut Annulée | JSON avec campaign_uuid, canceled_by, reason, timestamp |
Pour les clients standards
Si vous êtes une marque cliente (pas un publisher partenaire) et souhaitez recevoir des notifications sortantes (candidat sélectionné, avis publié, campagne clôturée), les alternatives V1 sont :
- Emails de notification (voir Emails envoyés)
- Trustt AI / MCP — interroger l'état d'une campagne à la demande (voir MCP Trustt § 3 Playbooks)
- Export CSV programmé (à demander au chargé de compte)
Roadmap : webhooks marque cliente en cours d'arbitrage produit — pas d'ETA V1.
7. Limites connues et méthodologie
Ce que Trustt supporte nativement
- ✅ Images JPG / PNG
- ✅ Import CSV contacts avec mapping manuel colonnes → champs Trustt
- ✅ Connecteurs Shopify / PrestaShop / WooCommerce / Magento pour le catalogue et la synchro commandes
- ✅ APIs REST : Trustt SMS (partenaire), Campaign Useguide (Community Builder), MCP (assistants IA externes)
- ✅ Webhooks sortants (partenaires publishers uniquement)
Ce que Trustt ne supporte pas en V1
- ❌ Upload d'images WebP, HEIC, TIFF, SVG, GIF
- ❌ Upload direct de vidéos (utiliser YouTube / Vimeo + URL)
- ❌ Upload direct de PDF côté client
- ❌ Import CSV catalogue produits standalone (via connecteur uniquement)
- ❌ Import Excel (
.xlsx) → exporter en CSV UTF-8 d'abord - ❌ Webhooks sortants pour clients marque standards (partenaires publishers uniquement)
- ❌ Self-service de clé API (provisionnée par le chargé de compte)
Méthodologie de cette page
Les valeurs de cette page décrivent le comportement de Trustt au 03/09/2026 (formats d'image, SMS, mode d'emploi, copilote, Trustt AI).
Si un écart apparaît entre cette page et l'application, ouvrir un ticket support : la page est mise à jour en même temps que le produit (revalidation tous les 6 mois).
Où trouver l'aide
- Doc HubSpot marketing (parfois périmée) → cette page fait autorité, HubSpot est une aide découverte
- Chargé de compte Trustt pour arbitrage cas-par-cas (limites hors standard, connecteur custom)
En savoir plus
- Informations de la marque § 4 Logo — spécifications détaillées du logo
- Google Merchant Center § 3 GTIN — code-barres produit
- Liste des contacts § 10 Import — assistant d'import CSV
- Module avis § 3 Récupération des commandes — connecteurs e-commerce
- Campagne en cours § Mises à jour automatiques — cycle de vie déclenchant les webhooks
- MCP Trustt — README — cartographie des ~30 tools MCP
- Trustt AI — assistant IA intégré