Automatisation
n8n
Publiez, programmez et suivez vos publications depuis n’importe quel workflow n8n avec le nœud Sofia, vérifié par n8n : une clé personnelle suffit.
Le nœud Sofia pour n8n relie votre compte à vos workflows, sans écrire une ligne de code : un formulaire, une boutique ou un tableur peuvent déclencher une publication, et une publication parue ou en échec peut lancer un autre workflow.
L’installer
- 1. Ouvrez le panneau des nœuds. Dans un workflow, cliquez sur « + » et cherchez « Sofia ».
- 2. Installez le nœud. Sélectionnez Sofia, puis « Install node ». Le propriétaire de l’instance l’installe une fois, pour tous les membres.
- 3. Ou installez le paquet. Sur une instance auto-hébergée, ouvrez « Settings › Community nodes › Install » et saisissez le nom du paquet,
n8n-nodes-sofia-post.
Le 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. Créez l’identifiant dans n8n. Ajoutez un identifiant « Sofia API » et collez la clé dans le champ « Personal Key » (
sofia_pk_live_…). Laissez « API URL » tel quel ; n8n teste la clé avecGET /v1/me. - 3. Utilisez-le dans un workflow. Un seul identifiant atteint tous vos établissements, avec vos droits.
Ce qui est disponible
| Élément | Nom dans n8n | Ce qu’il fait |
|---|---|---|
| Action | Sofia › Post › Create | Publie, programme ou enregistre un brouillon, avec une publication par compte choisi et des médias par adresse |
| Action | Sofia › Post › Get | Lit une publication et l’état de chaque réseau |
| Déclencheur | Sofia Trigger › Post Published | Lance le workflow quand une publication est parue sur au moins un réseau |
| Déclencheur | Sofia Trigger › Post Failed | Lance le workflow quand un réseau refuse une publication, même si d’autres l’ont publiée |
Les listes « Establishment » et « Accounts » se remplissent depuis vos établissements et vos comptes connectés. Laissez « Schedule At » vide pour publier tout de suite ; une date se lit dans le fuseau horaire du workflow. « Draft » enregistre la publication sans la publier. Un champ incohérent (brouillon daté, adresse de média incomplète) est refusé avant que la publication soit créée.
Un exemple
- 1. Créez la publication. Ajoutez un nœud « Sofia » sur « Post › Create », choisissez un établissement et ses comptes, écrivez le texte, puis ajoutez « Media URLs » et « Schedule At » sous « Additional Fields ».
- 2. Lisez son état. Ajoutez un second nœud « Sofia » sur « Post › Get » et donnez-lui l’
idrenvoyé par l’étape précédente. Une fois la publication partie, sonstatusvautpublished,partialoufailed, avec le lien et la réponse de chaque réseau. - 3. Réagissez à un échec. Commencez un autre workflow par un nœud « Sofia Trigger » sur « Post Failed », et reliez-le à un nœud Slack ou e-mail avec le message ci-dessous.
{{ $json.platforms }}: {{ $json.errors }}Le déclencheur interroge Sofia à intervalles réguliers. Il part des publications qui apparaissent après l’activation du workflow : les précédentes ne sont pas rejouées. « Fetch Test Event » montre la dernière publication pour associer ses champs, et choisir un établissement ne surveille que celui-là.
Les erreurs dans n8n
- 401 : la clé n’est plus valable, créez-en une nouvelle et collez-la dans le même identifiant.
- 429 : trop d’appels ; l’erreur indique combien de secondes attendre avant de réessayer.
- Tout autre refus : l’erreur de Sofia, avec son code, s’affiche dans n8n. Avec « Continue On Fail », un élément refusé devient un élément
errorau lieu d’arrêter le workflow.
Utilisez n8n quand vos automatisations y vivent déjà. Préférez Zapier si vos outils s’y branchent, et les webhooks ou Sofia API quand vous écrivez du code.