Posts

Publier des stories sur Instagram via l'API

Avec format story, Connect publie le média en story sur le compte Instagram connecté par votre client. C'est le même appel POST /posts que pour les autres formats, pour tout compte connecté.

L'appel

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "story-77",
  "format": "story",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/story.jpg"
    }
  ],
  "instagram": {
    "collaborators": [
      "marca_parceira"
    ]
  }
}

Ce que vous pouvez faire

  • Publier une story à partir d'une URL https:// publique d'image ou de vidéo.
  • Inviter des collaborateurs avec instagram.collaborators.
  • Identifier des utilisateurs sur le média avec media[].user_tags.
  • Cibler le compte par customer_integration ou par integration_slug et source_name.

Règles et limites

  • Les stories n'ont pas de légende : n'envoyez pas caption.
  • Dans le bloc instagram, une story n'accepte que collaborators, 5 au plus, sans @.
  • 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 Idempotency-Key évite de dupliquer l'appel.

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).
instagram.collaboratorsarrayNonJusqu'à 5 utilisateurs invités comme collaborateurs, sans @. Valable en feed, reels et story.

Pour qui

  • Alertes et promotions

    Votre SaaS publie une story de vente flash sur le compte du client au moment où l'utilisateur clique sur publier.

  • Outil d'événements

    Générez une story avec le visuel de l'événement pour chaque participant et publiez-la sur son compte.

  • Agent IA

    Un agent transforme une actualité de la marque en image verticale et la publie automatiquement en story.

Fonctionne avec

  • Instagram Business
  • Instagram

Questions fréquentes

Puis-je ajouter une légende à une story ?

Non. Les stories n'ont pas de légende ; le texte doit être dans l'image ou la vidéo elle-même.

Quelles options du bloc instagram valent pour une story ?

Seulement collaborators. Les autres options sont pour feed et reels.

Cela marche sur les comptes instagram et instagram_business ?

Oui, les deux connexions acceptent format story.

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.