n8n

• 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.

• 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é avec GET /v1/me.
• 3. Utilisez-le dans un workflow. Un seul identifiant atteint tous vos établissements, avec vos droits.

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.

• 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’id renvoyé par l’étape précédente. Une fois la publication partie, son status vaut published, partial ou failed, 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à.

• 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 error au 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.