- Zapier → Social media studio : une action Webhooks by Zapier appelle l’API REST pour créer ou programmer une publication.
- Social media studio → Zapier : un déclencheur Webhooks by Zapier reçoit les événements envoyés par Social media studio (publication publiée, publication en échec, nouveau commentaire, etc.).
Webhooks by Zapier peut nécessiter un forfait Zapier payant. Vérifiez votre forfait Zapier avant de construire votre automatisation. Côté Social media studio, 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 Zap
Ajoutez une étape d’action : Webhooks by Zapier → POST.
Zapier construit et échappe le JSON pour vous : un texte contenant des guillemets ou des sauts de ligne ne pose donc aucun problème.
Pour publier sur plusieurs plateformes, ajoutez une étape POST par plateforme.
La requête équivalente, pour tester en dehors de Zapier :
201 avec la publication, dont son id et postStatus: "SCHEDULED". Mappez l’id dans les étapes suivantes si vous voulez modifier ou supprimer la publication.
Champs imbriqués : options TikTok et fils
Champs imbriqués : options TikTok et fils
Les publications TikTok nécessitent Custom Request envoie le corps tel que saisi et n’échappe pas les valeurs mappées. Un champ mappé contenant un guillemet double ou un saut de ligne produit un JSON invalide, que l’API rejette avec
tiktok.privacyLevel, et les fils utilisent un tableau threadParts. L’action POST envoie des données clé-valeur à plat ; utilisez donc Webhooks by Zapier → Custom Request pour ces cas, avec la méthode POST, la même URL et les mêmes en-têtes plus Content-Type: application/json, et le corps JSON saisi dans Data :400.Erreurs
Erreurs
Déclencher un Zap depuis un événement Social media studio
1
Créer le déclencheur dans Zapier
Choisissez Webhooks by Zapier → Catch Hook comme déclencheur et copiez l’URL de webhook fournie par Zapier.
2
Abonner cette URL dans Social media studio
Ouvrez Paramètres → Webhooks (app.so-me.studio/settings?tab=webhooks), ajoutez un point de terminaison avec l’URL Zapier et choisissez les événements. Ou créez-le avec l’API :La réponse inclut le
secret de signature de l’abonnement.3
Envoyer un événement de test
Cliquez sur Test sur l’abonnement dans Paramètres → Webhooks, puis sur Test trigger dans Zapier pour qu’il apprenne les champs.
POST JSON avec cette enveloppe :
Event, Data Post Id, Data Platform, etc. Le bloc data contient des identifiants plutôt que le contenu complet ; pour une publication, appelez GET https://api.so-me.studio/v1/posts/{postId} avec une étape Webhooks by Zapier → GET afin de lire son texte, son lien en ligne (shareUrl) ou son failureReason.
Parmi les événements utiles pour les Zaps : 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.