Passer au contenu principal
Considérez un tableur comme la source de vérité des prompts d’un workspace et appliquez les différences via l’API REST. Ce guide utilise le nœud générique HTTP Request de n8n et n’exige donc aucun nœud communautaire. La même logique fonctionne dans tout outil d’automatisation capable d’envoyer des requêtes HTTP.

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 rowId stable, le text, et éventuellement un Topic et une fréquence.
  • Dans n8n, un identifiant Header Auth avec le nom Authorization et la valeur Bearer <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.
Toutes les valeurs sont synthétiques.

Vue d’ensemble du workflow

Lire l’état actuel

Demandez la vue de configuration pour inclure les prompts archivés et les versions :
Paginez avec 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 :
Mettre à jour ou restaurer avec la version que vous venez de lire, entre guillemets :
Pour de nombreux changements identiques, comme archiver ou changer la fréquence de 20 prompts au plus, la mise à jour de prompts en masse tient en une seule requête. Elle utilise un 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 renvoie 409 IDEMPOTENCY_CONFLICT, d’où le hash du contenu dans la clé ci-dessus. Un 409 IDEMPOTENCY_IN_PROGRESS signifie que le résultat est inconnu : relisez les prompts avant de continuer.
  • If-Match. Un 412 PRECONDITION_FAILED signifie 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. Un 428 signifie que l’en-tête est absent.
  • Doublons. Après 24 heures, une création rejouée n’est plus reconnue et renvoie 409 CONFLICT pour 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, attendez Retry-After secondes avant de réessayer, et réutilisez la même clé pour une création. Sur 503 SERVICE_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 avec view=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.

Voir aussi