Créer une publication sur les réseaux sociaux

Crée une publication pour une marque sur un ou plusieurs de ses comptes sociaux connectés. Le même appel couvre les trois cycles de vie : enregistrer un DRAFT, mettre un SCHEDULE en file d’attente ou effectuer PUBLISH immédiatement.

Cas d’utilisation : programmer une campagne à partir de votre propre calendrier. Votre application sait déjà ce qu’un client souhaite communiquer et à quel moment. Pour chaque créneau, appelez cet endpoint avec action: "SCHEDULE" et soit scheduledAt, soit scheduleDate + scheduleTime, et transmettez votre propre identifiant de créneau dans clientReference afin de pouvoir faire le rapprochement sans stocker l’UUID renvoyé. Affichez l’entrée comme étant en attente jusqu’à ce que GET /social/posts/{postId} indique que la publication est en ligne sur chaque canal, et proposez un bouton d’annulation relié à POST /social/posts/cancel.

La publication est asynchrone

action: "PUBLISH" ne publie pas avant de répondre. L’appel accepte la publication, renvoie un socialPostId et la transmet au pipeline de publication. Pour savoir ce qui s’est réellement passé, interrogez régulièrement GET /social/posts/{postId} et consultez le tableau channels[] des résultats par canal : le champ status de chaque entrée correspond au résultat pour cette seule plateforme. Une publication peut réussir sur Instagram et échouer sur LinkedIn dans la même requête : channels[] fait donc foi, tandis que le champ status au niveau de la publication en est un résumé.

Choisir une programmation

action: "SCHEDULE" exige exactement l’une des deux formes suivantes, jamais les deux :

L’envoi des deux formes, de scheduleDate sans scheduleTime ou de scheduledAt sans décalage horaire est rejeté avec SY95046. DRAFT et PUBLISH ne doivent comporter aucune programmation.

Remarques.

• Le corps de la requête doit être encapsulé dans un objet input.
• Vérifiez success, et non le statut HTTP. Les échecs de validation sont renvoyés sous la forme HTTP 200 avec success: false et une entrée par problème dans le tableau error. Rien n’est créé lorsque success vaut false.
• La marque est identifiée dans le corps par socialProfileId. brandId est toujours un paramètre du chemin de l’URL, jamais un champ du corps.
• Chaque plateforme dans platforms doit déjà disposer d’une connexion pour la marque. Une plateforme sans canal actif entraîne un échec avec SY95045 ; consultez d’abord les connexions de la marque, puis dirigez l’utilisateur vers un lien de connexion pour toute connexion manquante.
• Les valeurs des plateformes sont les noms d’énumération en majuscules FACEBOOK, INSTAGRAM, TWITTER, LINKEDIN, PINTEREST. TWITTER correspond à X ; la valeur a conservé son ancien nom, et toute valeur en minuscules est rejetée.
• Instagram et Pinterest n’acceptent pas les publications contenant uniquement du texte : fournissez au moins une entrée mediaUrls lorsque l’une de ces plateformes figure dans platforms.
• Les identifiants de publication sont de simples UUID, et non les identifiants relay en Base64 utilisés pour les publications d’établissement.
• Pour traiter plus de quelques publications à la fois, utilisez POST /social/bulk-posts, qui accepte la même structure de ligne et valide l’ensemble du lot au préalable.

Opération d’écriture : non exécutée sur le compte réel. La requête et la réponse présentées sont construites à partir du schéma de l’API ; cette opération publie sur de véritables comptes sociaux lorsqu’elle est exécutée.