Posts
Publier des trial reels sur Instagram via l'API
Un trial reel est d'abord montré aux personnes qui ne suivent pas encore le compte. Avec format reels et instagram.trial_graduation_strategy, Connect publie le reel dans ce mode, sans app review ni gestion de tokens.
L'appel
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "reel-trial-12",
"format": "reels",
"caption": "Teste novo: o que acha?",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/trial.mp4"
}
],
"instagram": {
"trial_graduation_strategy": "SS_PERFORMANCE"
}
}Ce que vous pouvez faire
- Publier un reel en trial reel avec une seule option, trial_graduation_strategy.
- Choisir MANUAL pour que le compte décide de promouvoir le reel sur le profil.
- Choisir SS_PERFORMANCE pour qu'Instagram le promeuve seul si la performance est bonne.
- Combiner avec couverture, audio, collaborateurs et premier commentaire, comme pour tout reel.
Règles et limites
- trial_graduation_strategy ne vaut qu'avec format reels et accepte MANUAL ou SS_PERFORMANCE.
- Reels accepte exactement 1 vidéo.
- La réponse est 202 : la publication tourne en arrière-plan. Suivez-la avec GET /posts/{uuid}.
- external_reference est obligatoire et Idempotency-Key permet de réessayer sans dupliquer.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| external_reference | string | Oui | L'id du post dans votre système (100 caractères max). Empêche de publier deux fois le même post sur le même compte. |
| format | string | Oui | Format du post. Sur Instagram : feed, reels ou story. Sur Facebook : feed, reels ou story. |
| caption | string | Non | Légende. Sur Instagram, jusqu'à 2200 caractères, 30 hashtags et 20 mentions. Les stories n'ont pas de légende. |
| media | array | Oui | Liste des médias, dans l'ordre. Chaque élément a type et url. |
| media.url | string | Oui | URL https:// publique que le réseau peut télécharger (2048 caractères max). |
| instagram.trial_graduation_strategy | string | Non | Publie en trial reel. MANUAL : le compte décide de le promouvoir sur le profil. SS_PERFORMANCE : Instagram le promeut si la performance est bonne. Reels uniquement. |
| instagram.share_to_feed | boolean | Non | Si le reel apparaît aussi dans la grille du profil. Reels uniquement. |
Pour qui
Test de contenu
Votre SaaS publie des variantes d'une vidéo en trial reels pour mesurer la portée chez les non-abonnés avant le profil.
Agence
Validez les créations de plusieurs clients : SS_PERFORMANCE ne promeut que celles qui performent.
Agent IA de growth
Un agent publie un lot de reels de test et, avec MANUAL, laisse la décision finale au compte.
Fonctionne avec
Instagram Business
Instagram
Questions fréquentes
Qu'est-ce qu'un trial reel ?
Un reel montré d'abord aux non-abonnés. Vous définissez comment il est promu sur le profil : MANUAL ou SS_PERFORMANCE.
Quelle différence entre MANUAL et SS_PERFORMANCE ?
Avec MANUAL le compte décide de promouvoir le reel sur le profil. Avec SS_PERFORMANCE Instagram le promeut automatiquement si la performance est bonne.
Puis-je utiliser trial_graduation_strategy en feed ou story ?
Non. L'option ne vaut que pour reels.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
