Posts
Publier sur une Page Facebook via l'API
Avec format feed et integration_slug facebook, Connect publie sur la Page que votre client a connectée. Le même appel POST /posts couvre texte, liens et photos.
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-post-901",
"format": "feed",
"caption": "Conheça a novidade da semana",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/foto1.jpg"
},
{
"type": "image",
"url": "https://cdn.example.com/foto2.jpg"
}
]
}Ce que vous pouvez faire
- Publier un post de texte seul.
- Partager un lien avec facebook.link.
- Publier jusqu'à 10 photos dans un seul post.
- Cibler la Page par connexion (customer_integration) ou par integration_slug et source_name.
Règles et limites
- Le feed exige au moins une légende, un lien ou un média.
- La légende va jusqu'à 2200 caractères.
- Un post avec lien n'accepte pas de média.
- La vidéo dans le feed est refusée : la vidéo de Page passe en reels.
- La réponse est 202 : la publication tourne en arrière-plan. Suivez-la avec GET /posts/{uuid}.
- external_reference est obligatoire (409 si une publication identique existe) et Idempotency-Key évite de 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 | Texte du post. Jusqu'à 2200 caractères. 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). |
| facebook.link | string | Non | Lien partagé dans le post (2048 caractères max). Feed uniquement. Un post avec lien n'a pas de média. |
Pour qui
Gestionnaire de réseaux sociaux
L'utilisateur rédige le post dans votre SaaS et il sort sur la Page Facebook qu'il a connectée.
Annonces de magasins
Une chaîne de magasins publie la même annonce, avec photos, sur des dizaines de Pages.
Agent IA
Un agent résume une actualité et publie le texte avec le lien sur la Page du client.
Fonctionne avec
Facebook
Questions fréquentes
Puis-je publier une vidéo dans le feed de la Page ?
Non. La vidéo passe en reels. Le feed accepte texte, lien ou photos.
Combien de photos par post ?
Jusqu'à 10. Un post avec lien n'a pas de média.
Cela publie-t-il sur un profil personnel ?
Non. Ce format est pour les Pages Facebook, avec integration_slug facebook.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
