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

ChampTypeObligatoireDescription
external_referencestringOuiL'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.
formatstringOuiFormat du post. Sur Instagram : feed, reels ou story. Sur Facebook : feed, reels ou story.
captionstringNonTexte du post. Jusqu'à 2200 caractères. Les stories n'ont pas de légende.
mediaarrayOuiListe des médias, dans l'ordre. Chaque élément a type et url.
media.urlstringOuiURL https:// publique que le réseau peut télécharger (2048 caractères max).
facebook.titlestringNonTitre du reel, 255 caractères max. Reels uniquement.
facebook.cover_urlstringNonURL 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.

Voir aussi

Voir tout ce que vous pouvez faire avec Posts

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.