Posts
Publier des stories sur Instagram via l'API
Avec format story, Connect publie le média en story sur le compte Instagram connecté par votre client. C'est le même appel POST /posts que pour les autres formats, pour tout compte connecté.
L'appel
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "story-77",
"format": "story",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/story.jpg"
}
],
"instagram": {
"collaborators": [
"marca_parceira"
]
}
}Ce que vous pouvez faire
- Publier une story à partir d'une URL https:// publique d'image ou de vidéo.
- Inviter des collaborateurs avec instagram.collaborators.
- Identifier des utilisateurs sur le média avec media[].user_tags.
- Cibler le compte par customer_integration ou par integration_slug et source_name.
Règles et limites
- Les stories n'ont pas de légende : n'envoyez pas caption.
- Dans le bloc instagram, une story n'accepte que collaborators, 5 au plus, sans @.
- Jusqu'à 10 médias par appel, chacun devient une story, publiées dans l'ordre. Le réseau vérifie tous les fichiers avant la sortie du premier, donc un fichier défectueux ne laisse jamais la séquence à moitié publiée.
- 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 évite de dupliquer l'appel.
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. |
| media | array | Oui | Liste des médias, dans l'ordre. Chaque élément a type et url. |
| media.type | string | Oui | Type de média : image, video ou document (document : LinkedIn uniquement). |
| media.url | string | Oui | URL https:// publique que le réseau peut télécharger (2048 caractères max). |
| instagram.collaborators | array | Non | Jusqu'à 5 utilisateurs invités comme collaborateurs, sans @. Valable en feed, reels et story. |
Pour qui
Alertes et promotions
Votre SaaS publie une story de vente flash sur le compte du client au moment où l'utilisateur clique sur publier.
Outil d'événements
Générez une story avec le visuel de l'événement pour chaque participant et publiez-la sur son compte.
Agent IA
Un agent transforme une actualité de la marque en image verticale et la publie automatiquement en story.
Fonctionne avec
Instagram Business
Instagram
Questions fréquentes
Puis-je ajouter une légende à une story ?
Non. Les stories n'ont pas de légende ; le texte doit être dans l'image ou la vidéo elle-même.
Quelles options du bloc instagram valent pour une story ?
Seulement collaborators. Les autres options sont pour feed et reels.
Cela marche sur les comptes instagram et instagram_business ?
Oui, les deux connexions acceptent format story.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
