> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Synchroniser des prompts depuis un tableur avec n8n

> Gardez les prompts d’un workspace alignés sur un tableur avec le nœud HTTP Request de n8n, grâce aux clés d’idempotence, aux versions If-Match et aux rejeux.

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](https://docs.qwairy.co/fr/developers/writing-data.md).
* 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](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/).

Toutes les valeurs sont synthétiques.

## Vue d’ensemble du workflow

| Nœud | Rôle |
| - | - |
| Déclencheur planifié ou manuel | Lance une synchronisation |
| Nœud tableur | Lit les lignes |
| HTTP Request : lister les prompts | `GET /brands/{brandId}/prompts?view=configuration`, paginé, pour lire l’`id`, le `text`, le `status`, la `frequency` et la `version` de chaque prompt |
| Code | Compare les lignes aux prompts existants et produit un élément par changement |
| Loop Over Items | Envoie un changement à la fois, avec un nœud Wait pour rester sous la limite de débit |
| HTTP Request : écriture | `POST` pour créer, `PATCH` pour mettre à jour |

## Lire l’état actuel

Demandez la vue de configuration pour inclure les prompts archivés et les versions :

```text theme={null}
GET https://www.qwairy.co/api/v1/brands/{{ $json.brandId }}/prompts?view=configuration&limit=100&offset=0
Authorization: Bearer <credential>
```

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](https://docs.qwairy.co/fr/developers/endpoints/prompts/list.md).

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

```javascript theme={null}
const rows = $('Read sheet').all().map((i) => i.json);
const existing = $('List prompts').all().flatMap((i) => i.json.prompts);

const norm = (t) => t.trim().replace(/\s+/g, ' ').toLowerCase();
const hash = (s) => {
  let h = 5381;
  for (const c of s) h = ((h << 5) + h + c.charCodeAt(0)) >>> 0;
  return h.toString(36);
};
const byText = new Map(existing.map((p) => [norm(p.text), p]));

const out = [];
for (const row of rows) {
  const found = byText.get(norm(row.text));
  const frequency = row.frequency || null;
  if (!found) {
    out.push({ json: {
      op: 'create',
      key: 'prompt-sync-' + row.rowId + '-' + hash(norm(row.text) + '|' + frequency),
      body: { text: row.text.trim(), frequency },
    } });
  } else if (found.status === 'ARCHIVED') {
    out.push({ json: { op: 'restore', promptId: found.id, version: found.version } });
  } else if ((found.frequency ?? null) !== frequency) {
    out.push({ json: { op: 'update', promptId: found.id, version: found.version, body: { frequency } } });
  }
}
return out;
```

## Écrire les changements

**Créer** avec une clé déterministe :

```text theme={null}
POST https://www.qwairy.co/api/v1/brands/{{ $json.brandId }}/prompts
Idempotency-Key: {{ $json.key }}
Content-Type: application/json

{{ JSON.stringify($json.body) }}
```

**Mettre à jour ou restaurer** avec la version que vous venez de lire, entre guillemets :

```text theme={null}
PATCH https://www.qwairy.co/api/v1/brands/{{ $json.brandId }}/prompts/{{ $json.promptId }}
If-Match: "{{ $json.version }}"
Content-Type: application/json

{{ JSON.stringify($json.body ?? { status: 'ACTIVE' }) }}
```

Pour de nombreux changements identiques, comme archiver ou changer la fréquence de 20 prompts au plus, la [mise à jour de prompts en masse](https://docs.qwairy.co/fr/developers/endpoints/prompts/bulk.md) 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](https://docs.qwairy.co/fr/developers/endpoints/credits.md) avant un import volumineux.

## Voir aussi

* [Créer un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/manage.md)
* [Mettre à jour un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/update.md)
* [Limites de débit](https://docs.qwairy.co/fr/developers/rate-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.