- Make → Social media studio : le module HTTP → Make a request appelle l’API REST pour créer ou programmer une publication.
- Social media studio → Make : le déclencheur Webhooks → Custom webhook reçoit les événements envoyés par Social media studio (publication publiée, publication en échec, nouveau commentaire, etc.).
L’API REST nécessite un forfait Standard, Advanced ou Lifetime (Lite ne l’inclut pas). Le nombre de points de terminaison webhook que vous pouvez créer dépend de votre forfait ; voir Présentation des webhooks.
Avant de commencer
1
Créer une clé d'API
Dans Social media studio, ouvrez Paramètres → API (app.so-me.studio/settings?tab=api) et créez une clé. Elle commence par
sk_live_ et n’est affichée qu’une seule fois. Voir Authentification.2
Trouver les identifiants de vos comptes (facultatif)
Si vous avez connecté plusieurs comptes sur la même plateforme, chaque publication doit indiquer lequel utiliser. Listez vos comptes une fois et notez l’Avec un seul compte sur une plateforme, vous pouvez omettre
id de chacun :accountId.Créer ou programmer une publication depuis un scénario
1
Construire le corps avec un module JSON
Ajoutez JSON → Create JSON. Définissez une structure de données avec les champs ci-dessous et mappez les valeurs depuis les modules précédents. Make échappe les guillemets et les sauts de ligne pour vous, ce que ne fait pas un corps JSON saisi à la main.
2
L'envoyer avec le module HTTP
Ajoutez HTTP → Make a request :
Le corps envoyé par le module HTTP ressemble à ceci :
201 avec la publication, dont son id et postStatus: "SCHEDULED". Pour publier sur plusieurs plateformes, utilisez un module HTTP par plateforme, ou un Iterator sur une liste de plateformes.
Erreurs
Erreurs
Ajoutez une route de gestion d’erreurs au module HTTP si un scénario doit continuer après l’échec d’une publication.
Déclencher un scénario depuis un événement Social media studio
1
Créer le webhook dans Make
Démarrez le scénario avec Webhooks → Custom webhook, cliquez sur Add et copiez l’adresse fournie par Make.
2
Abonner cette adresse dans Social media studio
Ouvrez Paramètres → Webhooks (app.so-me.studio/settings?tab=webhooks), ajoutez un point de terminaison avec l’adresse Make et choisissez les événements. Ou créez-le avec l’API :La réponse inclut le
secret de signature de l’abonnement.3
Laisser Make apprendre la structure
Avec le module Custom webhook en écoute (Run once), cliquez sur Test sur l’abonnement dans Paramètres → Webhooks. Make enregistre les champs de la livraison d’exemple.
POST JSON avec cette enveloppe :
event lorsqu’un même webhook reçoit plusieurs types d’événements. Le bloc data contient des identifiants plutôt que le contenu complet ; pour une publication, ajoutez un module HTTP avec GET https://api.so-me.studio/v1/posts/{{data.postId}} et l’en-tête X-API-Key afin de lire son texte, son lien en ligne (shareUrl) ou son failureReason.
Parmi les événements utiles : post.published, post.failed, post.scheduled, inbox.message_received, inbox.comment_received, social.account_disconnected et quota.limit_reached. Voir Présentation des webhooks pour la liste complète et Format des charges utiles pour des exemples de charges utiles.
Social media studio attend une réponse pendant 10 secondes et relance une livraison en échec jusqu’à 4 fois. Un abonnement qui échoue 10 fois de suite est désactivé ; réactivez-le dans Paramètres → Webhooks.