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

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.linkstringNonLien 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.

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.