Intégrations tierces

2 min de lecture

Reliez Sofia à vos autres outils avec Zapier : une seule clé personnelle suffit pour publier, programmer et suivre vos publications.

L’intégration Zapier de Sofia relie votre compte à vos autres outils, sans écrire une ligne de code : un formulaire, une boutique ou un tableur peuvent déclencher une publication, et une publication parue peut en déclencher d’autres actions.

Sur cette pageLa connecterCe qui est disponibleLes erreurs dans ZapierEn quoi c’est différent de l’API et des webhooks

La connecter

  • 1. Créez une clé personnelle. Dans les réglages, page « Sofia API », onglet « Accès personnel », « Nouvelle clé ». Elle n’est affichée qu’une fois.
  • 2. Ajoutez Sofia dans Zapier. Collez la clé dans le champ « Personal key » (sofia_pk_live_…). Zapier la teste avec GET /v1/me, et la connexion porte le nom de vos Workspaces.
  • 3. Utilisez-la dans un Zap. Une seule connexion atteint tous vos établissements, avec vos droits.

Ce qui est disponible

ÉlémentNom dans ZapierCe qu’il fait
DéclencheurPost PublishedSe déclenche quand une publication est parue
DéclencheurPost FailedSe déclenche quand une publication échoue
ActionCreate PostPublie, programme ou enregistre un brouillon, avec une cible par compte choisi et des médias par adresse
RechercheFind PostRetrouve une publication

Les listes « Establishment » et « Accounts » du Zap se remplissent depuis vos établissements et vos comptes connectés. Un champ incohérent (brouillon daté, compte inconnu) est refusé avant tout appel.

Les erreurs dans Zapier

  • 401 : la clé n’est plus valable, reconnectez le compte Zapier avec une nouvelle clé.
  • 429 : trop d’appels ; Zapier attend le délai indiqué par Sofia (Retry-After) avant de réessayer.
  • Tout autre refus : l’erreur de Sofia, avec son code, s’affiche dans Zapier.

En quoi c’est différent de l’API et des webhooks

CritèreIntégration ZapierSofia API et webhooks
Où ça tourneDans ZapierChez vous
Ce qu’il fautUne clé personnelle, sans codeDu code qui appelle l’API
DéclencheursSondage des publications parues ou en échec (la plus récente en premier, 100 publications par page)Événements signés envoyés à votre adresse, voir Webhooks
Ce que vous obtenezLes opérations de l’intégrationToute l’API, voir Réglages › API

Utilisez Zapier quand vos outils s’y branchent déjà. Utilisez directement Sofia API quand vous avez besoin de toutes ses opérations.