Aller au contenu
Trustt

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

PDF

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 email suffit : voir RGPD côté marque § 4.5.

É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 mail ou courriel sans 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