Avant de commencer
- Une offre Business, Agency Business ou Enterprise, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Écrire des données.
- Une feuille avec une ligne par prompt : un
rowIdstable, letext, et éventuellement un Topic et une fréquence. - Dans n8n, un identifiant Header Auth avec le nom
Authorizationet la valeurBearer <your token>. Ne mettez jamais le jeton dans un paramètre de nœud ni dans un export de workflow. - Les libellés de l’interface n8n changent d’une version à l’autre. Les éléments stables sont l’URL, les en-têtes et le corps de chaque requête. Consultez la documentation du nœud HTTP Request de n8n.
Vue d’ensemble du workflow
Lire l’état actuel
Demandez la vue de configuration pour inclure les prompts archivés et les versions :offset jusqu’à ce que pagination n’indique plus de résultats. La vue de configuration renvoie id, text, status, frequency, monitoringEnabled, keywordId, tagIds et version pour chaque prompt. Consultez Lister les prompts.
Calculer les changements
Ce nœud Code (JavaScript) associe les lignes aux prompts par texte normalisé et émet une création ou une mise à jour. Le hash sert uniquement à construire une clé d’idempotence déterministe.Écrire les changements
Créer avec une clé déterministe :Idempotency-Key et pas de If-Match, et renvoie un résultat pour chaque prompt, que vous devez examiner.
Rendre les rejeux sans risque
- Idempotence. La même clé avec le même corps renvoie la réponse d’origine pendant 24 heures, avec
Idempotent-Replay: true. La même clé avec un corps différent renvoie409IDEMPOTENCY_CONFLICT, d’où le hash du contenu dans la clé ci-dessus. Un409IDEMPOTENCY_IN_PROGRESSsignifie que le résultat est inconnu : relisez les prompts avant de continuer. - If-Match. Un
412PRECONDITION_FAILEDsignifie que quelqu’un a modifié le prompt après votre lecture. Ne réessayez pas avec l’ancienne version. Relancez la synchronisation pour qu’elle lise des versions à jour. Un428signifie que l’en-tête est absent. - Doublons. Après 24 heures, une création rejouée n’est plus reconnue et renvoie
409CONFLICTpour un texte en doublon. Lire d’abord, comme le fait ce workflow, transforme ce cas en opération sans effet, et restaure un prompt archivé au lieu de le recréer. - Limite de débit. Les écritures sont limitées à 120 par minute et par équipe. Envoyez un changement par itération et ajoutez un nœud Wait. Sur
429, attendezRetry-Aftersecondes avant de réessayer, et réutilisez la même clé pour une création. Sur503SERVICE_UNAVAILABLE, rien n’a changé : réessayez avec un backoff borné. - Erreurs. Configurez le nœud d’écriture pour continuer en cas d’erreur et dirigez les échecs vers un journal, afin qu’une ligne défectueuse n’arrête pas le lot.
Vérifier
Exécutez le workflow deux fois. La seconde exécution ne doit émettre aucun changement. Listez ensuite les prompts avecview=configuration et comparez les lignes au résultat.
Limites
- La synchronisation ne supprime jamais de prompts : les lignes retirées ne sont pas archivées, sauf si vous ajoutez cette règle. L’archivage conserve les réponses et l’historique.
- Les nouveaux prompts suivis ajoutent une consommation récurrente de crédits. Vérifiez Crédits avant un import volumineux.

