Posts
Publier des stories sur une Page Facebook via l'API
Avec format story et integration_slug facebook, Connect publie le média en story sur la Page que votre client a connectée, avec le même appel POST /posts que les autres formats.
L'appel
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "fb-story-23",
"format": "story",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/story.jpg"
}
]
}Ce que vous pouvez faire
- Publier une story à partir d'une URL https:// publique d'image ou de vidéo.
- Cibler la Page par connexion (customer_integration) ou par integration_slug et source_name.
- Réessayer en toute sécurité avec Idempotency-Key.
Règles et limites
- Les stories n'ont pas de légende : n'envoyez pas caption.
- Le format story n'a pas d'options dans le bloc facebook.
- 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 évite de publier deux fois la même référence sur le compte (409).
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). |
Pour qui
Avis rapides
Le SaaS publie une story de promo du jour sur la Page du client d'un clic de l'utilisateur.
Chaîne de magasins
Publiez le même visuel vertical en story sur les Pages de plusieurs points de vente.
Agent IA
Un agent transforme un lancement en image verticale et la publie en story.
Fonctionne avec
Facebook
Questions fréquentes
Puis-je ajouter une légende à la story ?
Non. Les stories n'ont pas de légende.
Y a-t-il des options supplémentaires dans le bloc facebook ?
Pas pour story. Le bloc facebook a link en feed, et titre et couverture en reels.
Comment suivre la publication ?
POST /posts répond 202. Consultez GET /posts/{uuid}.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
