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

ChampTypeObligatoireDescription
external_referencestringOuiL'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.
formatstringOuiFormat du post. Sur Instagram : feed, reels ou story. Sur Facebook : feed, reels ou story.
captionstringNonLégende. Sur Instagram, jusqu'à 2200 caractères, 30 hashtags et 20 mentions. Les stories n'ont pas de légende.
mediaarrayOuiListe des médias, dans l'ordre. Chaque élément a type et url.
media.urlstringOuiURL https:// publique que le réseau peut télécharger (2048 caractères max).
instagram.trial_graduation_strategystringNonPublie 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_feedbooleanNonSi 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.

Voir aussi

Voir tout ce que vous pouvez faire avec Posts

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.