Commander une campagne UGC par API ou agent IA

Publié le 30 juin 2026 · par UGC Pocket · ~7 min de lecture

Pourquoi commander par agent IA

Les équipes marketing utilisent de plus en plus d'assistants IA pour orchestrer leurs tâches. Plutôt que de remplir un formulaire à la main, un agent peut traduire une intention (« je veux 3 vidéos TikTok de créateurs avec un chien pour lancer notre croquette ») en une campagne prête à confirmer.

L'intérêt est triple :

• Gagner du temps. L'agent prépare le brief, choisit les catégories et le budget, et soumet le brouillon en une requête.
• S'intégrer à vos outils. L'API et le MCP se branchent dans vos workflows (CRM, calendrier de contenu, assistant interne) sans intervention manuelle répétitive.
• Garder le contrôle. L'agent ne fait que proposer : rien n'est payé tant qu'un humain n'a pas confirmé et financé la campagne.

Comment ça marche : le modèle « brouillon confirmé par un humain »

En une phrase : un agent crée un brouillon, la marque le confirme et le finance. C'est le principe human_confirmed_draft, conçu pour combiner automatisation et sécurité.

1. L'agent s'authentifie avec une clé API ugcp_live_… rattachée à votre compte marque.
2. L'agent crée une campagne en envoyant un brief et les paramètres (catégories, budget, nombre de créateurs).
3. UGC Pocket renvoie un brouillon. La campagne n'est pas active : elle attend une action humaine.
4. La marque confirme et finance depuis l'application. C'est seulement à ce moment que la campagne devient publique pour les créateurs.
5. Le reste suit le flux habituel : sélection des créateurs, réception des vidéos, validation, paiement à la validation.

Ce modèle garantit qu'aucun agent ne peut engager de dépense seul. L'IA accélère la préparation ; l'humain valide l'engagement financier.

Le brouillon créé par l'agent, en attente de confirmation humaine.

Les surfaces : REST, MCP, llms.txt

UGC Pocket expose trois portes d'entrée pour les agents :

• API REST: hôte https://ugcpocket.com/api. Endpoints classiques en JSON pour créer et suivre une campagne. Le schéma complet est décrit dans openapi.json.
• Serveur MCP: hôte https://ugcpocket.com/mcp. Le Model Context Protocol permet à un agent compatible de découvrir et d'appeler les outils UGC Pocket nativement, sans coder l'intégration REST à la main.
• llms.txt: un fichier texte qui résume le service et oriente les agents vers la bonne documentation.

Exemple minimal de création de campagne en REST :

curl -X POST https://ugcpocket.com/api/campaigns \
  -H "Authorization: Bearer ugcp_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: camp-croquettes-2026-06-30" \
  -d '{
    "title": "Lancement croquettes",
    "brief": "Vidéo TikTok énergique, ton authentique, montrer la croquette en usage avec un chien.",
    "target_categories": ["dog"],
    "platforms": ["tiktok"],
    "prestation": "ugc_only",
    "budget_per_creator_cents": 12000,
    "creators_wanted": 3
  }'

La réponse renvoie un brouillon (statut non confirmé) avec son identifiant, que la marque retrouve dans l'application pour confirmation.

Valeurs autorisées

L'API valide chaque champ. Voici les valeurs acceptées :

Le budget s'exprime en centimes dans l'API (12000 = 120 €). Les 7 catégories de niche correspondent à : chien, chat, voiture, cuisine, couple, business, podcast. Les 3 prestations : UGC seul, Vidéo + publication, Publication fournie.

Sécurité & limites

La sécurité repose sur trois garde-fous : confirmation humaine, limites de débit, idempotence.

• Confirmation humaine obligatoire. Aucun paiement n'est déclenché par l'agent ; la campagne reste un brouillon jusqu'à confirmation et financement par la marque.
• Limite de débit : 30 requêtes/minute. Au-delà, l'API répond par une erreur de limitation (HTTP 429). Espacez les appels ou mettez en place une file d'attente côté agent.
• Idempotence. En passant un en-tête Idempotency-Key unique, vous évitez de créer deux brouillons identiques si une requête est rejouée (timeout réseau, retry de l'agent).
• Clé scope-limitée. La clé ugcp_live_… est rattachée à un compte marque ; révoquez-la depuis l'application en cas de doute.

En clair : un agent peut préparer et soumettre, mais ne peut ni dépenser ni publier sans votre feu vert explicite.

FAQ