Posts
Publier des reels sur une Page Facebook via l'API
Avec format reels et integration_slug facebook, Connect publie un reel sur la Page que votre client a connectée. La vidéo de Page Facebook passe par ce format.
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-reel-55",
"format": "reels",
"caption": "Bastidores da loja",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/reel.mp4"
}
],
"facebook": {
"title": "Bastidores",
"cover_url": "https://cdn.example.com/capa.jpg"
}
}Ce que vous pouvez faire
- Publier un reel à partir d'une URL de vidéo https:// publique.
- Définir le titre avec facebook.title.
- Choisir la couverture avec facebook.cover_url.
- Cibler la Page par connexion ou par integration_slug et source_name.
Règles et limites
- Reels accepte exactement 1 vidéo.
- Le titre va jusqu'à 255 caractères.
- Si le réseau refuse l'image de cover_url, le reel sort avec la couverture qu'il choisit.
- 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 la publication.
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.title | string | Non | Titre du reel, 255 caractères max. Reels uniquement. |
| facebook.cover_url | string | Non | URL https:// de la couverture du reel. Si le réseau refuse l'image, le reel sort avec la couverture qu'il choisit. Reels uniquement. |
Pour qui
Outil vidéo
Votre SaaS publie la vidéo courte exportée directement sur la Page du client, avec titre et couverture.
Agence
Publiez le même reel sur les Pages de plusieurs clients avec un appel par connexion.
Agent IA
Un agent génère la vidéo, définit le titre et publie le reel sans intervention.
Fonctionne avec
Facebook
Questions fréquentes
Pourquoi ne puis-je pas envoyer une vidéo dans le feed ?
Le feed de la Page refuse la vidéo : la vidéo de Page passe en reels.
Puis-je choisir la couverture ?
Oui, avec facebook.cover_url. Si le réseau refuse l'image, le reel sort avec la couverture qu'il choisit.
Combien de vidéos par reel ?
Exactement 1.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
