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

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.
mediaarrayOuiListe des médias, dans l'ordre. Chaque élément a type et url.
media.typestringOuiType de média : image, video ou document (document : LinkedIn uniquement).
media.urlstringOuiURL 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}.

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.