blackdark
Automatisation

Claude publie tes reels test sur Instagram via l’API officielle : publie, teste, mesure, améliore

Les reels test (Trial Reels) sont d’abord montrés à des gens qui ne te suivent pas et n’apparaissent pas sur ton profil. Comment les publier via l’API Instagram avec connexion Instagram (token IGAA, trial_params), lire chaque matin le skip rate et monter avec Claude Code une boucle qui teste des accroches sans griller ton compte.

Par Mis à jour le 6 min de lecture
Aller directement au prompt

Testé par nous

Le 12-nov-2026, nous avons publié un reel comme reel test par cette voie et il est bien sorti comme tel (is_shared_to_feed=false, il n’est pas apparu dans la grille). Meta change souvent des choses : vérifie chaque reel après publication, comme expliqué à l’étape 2.

Les reels test (Trial Reels) sont une fonction officielle d’Instagram : le reel est d’abord montré à des gens qui ne te suivent pas et n’apparaît ni sur ton profil ni auprès de tes abonnés. Parfait pour tester des accroches sans griller ton compte.

Ce que peu de gens savent : on peut les publier via l’API officielle d’Instagram. Et si une API peut les publier, Claude aussi.

La boucle

  1. Publie

    Claude publie une version de la vidéo comme reel test. Une par jour.

  2. Teste

    Instagram la montre à des gens qui ne te suivent pas. Ton profil n’en sait rien.

  3. Mesure

    Chaque matin, Claude lit le skip rate, le temps de visionnage, les vues et la portée.

  4. Améliore

    Il te dit quelle accroche a gagné et te propose des changements pour tes skills. C’est toi qui décides.

Ce qu’il te faut

  • Un compte Instagram professionnel (créateur ou entreprise).
  • Un compte développeur Meta (gratuit) sur developers.facebook.com.
  • Claude Code (ou n’importe quel Claude capable d’exécuter du code sur ton ordinateur).
  • Un endroit où déposer ton MP4 sur une URL publique quelques minutes : ton site, un bucket, un serveur… (étape 3).

L’API Instagram est gratuite. Tu ne paies que ton abonnement Claude.

Étape 1 : l’app Meta avec connexion Instagram

  1. Sur developers.facebook.com → Mes apps → Créer une app (My Apps → Create App) → type « Entreprise » (Business).
  2. Ajoute le produit Instagram et choisis « API avec connexion Instagram » (Instagram API with Instagram Login).
  3. Dans la configuration de l’API, ajoute ton compte Instagram comme testeur (tester), accepte-le depuis l’app Instagram (Paramètres → Applications et sites web, en anglais Settings → Apps and websites) et génère le token d’accès. Il commence par IGAA.
  4. Permissions : instagram_business_basic, instagram_business_content_publish et instagram_business_manage_insights.
  5. Enregistre le token dans un fichier .env de ton projet. Jamais dans un chat, une capture d’écran ou sur GitHub.

Les noms des menus de Meta changent de temps en temps ; si tu n’en trouves pas un, cherche l’équivalent en anglais.

Il faut utiliser CETTE variante de l’API

Il existe deux façons d’utiliser l’API Instagram. Avec celle de connexion Facebook (tokens qui commencent par EAA, graph.facebook.com), nous avons essayé d’envoyer des reels test et Meta a ignoré le paramètre sans renvoyer d’erreur : le reel est sorti NORMAL, dans la grille. Utilise celle de connexion Instagram : token IGAA et graph.instagram.com.

Pour vérifier que le token fonctionne, demande ton nom d’utilisateur : GET https://graph.instagram.com/v23.0/me?fields=user_id,username avec le token comme access_token.

Étape 2 : publier une vidéo comme reel test

Ce sont trois appels, tous vers https://graph.instagram.com/v23.0 :

1. Créer le conteneur avec trial_params :

POST /<IG_USER_ID>/media
{
  "media_type": "REELS",
  "video_url": "https://ton-site.com/temporaire/aleatoire.mp4",
  "caption": "Ton texte…",
  "trial_params": { "graduation_strategy": "MANUAL" }
}
graduation_strategyCe qui se passe
MANUALLe reel reste en test. Si tu veux le passer sur ton profil, tu le « gradues » toi-même à la main depuis l’app.
SS_PERFORMANCEInstagram le passe sur ton profil seulement s’il marche bien.

2. Attendre le traitement : GET /<ID_CONTENEUR>?fields=status_code jusqu’à ce qu’il indique FINISHED.

3. Publier : POST /<IG_USER_ID>/media_publish avec { "creation_id": "<ID_CONTENEUR>" }.

Vérifie-le TOUJOURS juste après :

GET /<ID_DU_REEL>?fields=permalink,is_shared_to_feed

Si is_shared_to_feed vaut false, c’est un reel test. S’il vaut true ou si le reel apparaît dans ta grille, il est sorti comme un reel normal : archive-le et vérifie que tu utilises bien le token IGAA et graph.instagram.com.

Étape 3 : le MP4 doit être sur une URL publique (un instant)

Pour les reels, graph.instagram.com n’accepte pas l’envoi direct du fichier : il exige video_url et Instagram télécharge la vidéo depuis cette adresse.

  1. Mets le MP4 en ligne sur ton site, ton serveur ou ton bucket avec un nom aléatoire.
  2. Vérifie que l’URL renvoie vraiment le MP4 (et pas une page d’erreur ou de connexion).
  3. Crée le conteneur, attends FINISHED et supprime le fichier.

Étape 4 : lire les chiffres chaque matin

GET /<ID_DU_REEL>/insights?metric=reels_skip_rate,ig_reels_avg_watch_time,views,reach
MétriqueCe qu’elle te dit
reels_skip_rateLe % de gens qui passent ton reel dans les 3 premières secondes. C’est le « partis en 3 s » : celle qui dit si l’accroche fonctionne. Meta la présente comme estimée et en développement : utilise-la pour comparer tes accroches entre elles, pas comme un chiffre exact.
ig_reels_avg_watch_timeLe temps moyen de visionnage.
viewsVues.
reachComptes touchés.

Laisse passer au moins 24 h avant de comparer un reel test avec un autre.

Étape 5 : la boucle avec Claude Code

L’idée : pour chaque vidéo, tu fais 5 versions avec des accroches différentes (même contenu ; seuls la première phrase, le premier plan et la couverture changent) et Claude en publie une par jour comme reel test. Chaque matin, il lit les chiffres et note quelle accroche a gagné. Avec ça, tu ajustes tes skills : celle qui écrit les scripts et celle qui monte.

Ouvre Claude Code dans le dossier de ton projet (avec le token déjà dans .env) et colle-lui ceci :

Prompt · Monte ma boucle de reels test
On va monter une boucle de reels test sur Instagram avec l’API Instagram avec connexion Instagram.
Le token est dans .env (INSTAGRAM_TOKEN, il commence par IGAA). Ne me demande pas de le coller dans le chat. Utilise toujours https://graph.instagram.com/v23.0.

1. Crée un script "publier-test" qui reçoit un MP4 et un texte, le dépose sur une URL publique temporaire avec un nom aléatoire (je te dis où), vérifie que cette URL renvoie bien le MP4, crée le conteneur avec media_type=REELS et trial_params {"graduation_strategy":"MANUAL"}, attend FINISHED, publie, supprime le MP4 temporaire et vérifie is_shared_to_feed. S’il vaut true, préviens-moi et arrête-toi.
 Note chaque reel dans tests.csv (date, fichier, accroche, id du reel, permalink).
2. Crée un script "lire-chiffres" qui, pour chaque reel de tests.csv publié il y a plus de 24 h, demande reels_skip_rate, ig_reels_avg_watch_time, views et reach, et l’enregistre dans le même CSV.
3. Chaque matin : exécute lire-chiffres, dis-moi quelle accroche a gagné (skip rate le plus bas et temps de visionnage le plus long) et pourquoi tu penses qu’elle a gagné. Propose un changement concret pour ma skill de scripts et un autre pour celle de montage. Ne modifie pas les skills sans m’avoir montré le changement avant.
4. Ensuite, publie la version suivante en attente avec publier-test. Une par jour maximum.

Les 5 versions, tu peux les faire à la main ou les demander à Claude :

Prompt · 5 accroches pour le même script
Donne-moi 5 accroches différentes pour ce script, une de chaque type : résultat, curiosité, erreur, contradiction et histoire. Pour chacune : la première phrase, ce qu’on voit dans le premier plan et le texte de la couverture.

Avertissements

  • Commence doucement : un test par jour. Publier en masse via l’API peut se heurter aux limites et aux règles de Meta. Ton quota se consulte avec GET /<IG_USER_ID>/content_publishing_limit.
  • Vérifie chaque reel après publication (étape 2). Si Meta change quelque chose, il peut sortir comme un reel normal.
  • « Il s’améliore tout seul » veut dire que Claude te propose les changements avec des données ; le dernier mot t’appartient.
  • Ton token est à toi : seulement dans le .env, jamais dans le chat, sur des captures d’écran ou sur GitHub. S’il fuite, révoque-le dans la console Meta.
  • Ce n’est pas un outil payant ni tiers : c’est l’API officielle d’Instagram + Claude.

Checklist

  • Compte Instagram professionnel.
  • App Meta avec « API avec connexion Instagram » et ton compte comme testeur.
  • Token IGAA dans .env avec les 3 permissions.
  • Un endroit où déposer le MP4 sur une URL publique un instant.
  • Premier reel test publié et is_shared_to_feed = false.
  • Boucle montée avec Claude Code : un test par jour et lecture chaque matin.

FAQ

Une fonction officielle d’Instagram (Trial Reels) pour les comptes professionnels : le reel est d’abord montré à des gens qui ne te suivent pas et n’apparaît ni dans ta grille ni auprès de tes abonnés. Ça sert à tester des accroches sans que ton compte s’en ressente.

L’API Instagram est gratuite. Tu ne paies que ton abonnement Claude, et l’endroit où tu déposes le MP4 un instant si tu n’en as pas.

Le plus probable, c’est que tu utilises l’autre variante de l’API (connexion Facebook, tokens qui commencent par EAA, graph.facebook.com). Nous l’avons testée ainsi et Meta a ignoré trial_params sans renvoyer d’erreur. Utilise le token IGAA et graph.instagram.com, et archive le reel s’il est déjà apparu dans ta grille.

Parce que pour les reels, graph.instagram.com n’accepte pas l’envoi direct du fichier : il exige video_url et télécharge la vidéo depuis là. Mets-la en ligne avec un nom aléatoire, publie et supprime-la quand le conteneur indique FINISHED.

Le pourcentage de gens qui passent ton reel dans les 3 premières secondes : la métrique qui dit si l’accroche fonctionne. Meta la présente comme estimée et en développement, donc utilise-la pour comparer tes accroches entre elles, pas comme un chiffre exact.

Nous ne le recommandons pas : commence par un test par jour. Publier en masse via l’API peut se heurter aux limites et aux règles de Meta. Ton quota se consulte avec l’endpoint content_publishing_limit.

Avec le prompt de ce guide, non : Claude te propose les changements avec des données et c’est toi qui décides. Le dernier mot t’appartient.

Continuez à approfondir le même sujet.

Partager
Newsletter

Recevez les prochains guides par e-mail

Des idées et ressources sur l'IA et le marketing, sans remplissage. Ce qui marche et comment l'appliquer.

Des idées et des ressources, sans spam. Désabonne-toi quand tu veux.

Ce guide vous est utile ?

S'abonner