---
title: "n8n"
description: "Automatisez Quire avec n8n et le nœud communautaire Quire."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/fr-CA/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

<span id="n8n"></span>

Le nœud communautaire Quire pour n8n comprend un nœud d’action pour l’API REST et un nœud déclencheur qui lance un flux de travail lorsqu’un événement se produit dans Quire. Il n’a aucune dépendance à l’exécution; il n’ajoute donc rien d’autre que lui-même à votre instance n8n.

## Installation <!--quire:install-->

Dans n8n, ouvrez **Settings**, puis **Community nodes**, choisissez **Install** et saisissez `@quire/n8n-node`. Sur une instance n8n autohébergée, vous pouvez aussi exécuter `npm install @quire/n8n-node` dans le dossier utilisateur de n8n, puis redémarrer.

## Connexion <!--quire:connect-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-api-keys.webp" alt="The API keys page with a key named for an n8n automation." width="944" height="700" loading="lazy" decoding="async"><figcaption>Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.</figcaption></figure>

Créez un identifiant. Deux types sont offerts :

- **Quire API Key** : **Base URL** est l’adresse de votre organisation sans barre oblique finale, par exemple `https://acme.quirelms.com`. **API Key** est une clé créée par un administrateur dans `/admin/integrations/api-keys` et commençant par `qk_live_`. Accordez-lui seulement les portées nécessaires au flux de travail.
- **Quire OAuth2** : pour les flux de travail qui doivent agir au nom d’une personne en particulier. Enregistrez un client OAuth dans `/admin/integrations/oauth-clients` avec l’adresse de redirection de n8n (n8n l’affiche dans l’identifiant), puis saisissez l’ID du client, le secret et les portées.

## Actions <!--quire:actions-->

Le nœud **Quire** couvre les utilisateurs, les cours, les inscriptions, les groupes, les achèvements, les notes, les certificats, les travaux remis, les tentatives de quiz, les programmes, les commandes, les courriels et les organisations. Pour chaque ressource, il offre les opérations de liste, de lecture, de création, de mise à jour et de suppression lorsque l’API le permet, ainsi que l’upsert par ID externe, ce qui convient à une synchronisation : exécutez le même flux de travail deux fois sans rien dupliquer.

Les opérations sont générées à partir du document OpenAPI de Quire; elles correspondent donc champ par champ à la [référence de l’API](https://docs.quirelms.com/api/). Chaque opération peut aussi servir d’outil à un agent d’IA n8n; sa description provient de la référence de l’API.

Par défaut, les listes renvoient toutes les pages. Désactivez **Return All** et fixez une limite pour les grandes organisations.

## Déclencheur <!--quire:trigger-->

Ajoutez le nœud **Quire Trigger**, choisissez l’identifiant, puis sélectionnez les **Events** : un événement par nom, comme `enrolment.created`, une catégorie complète comme `course.*` ou tous les événements. Lorsque vous activez le flux de travail, le nœud crée dans Quire un abonnement webhook pour l’adresse de n8n; lorsque vous le désactivez, l’abonnement est supprimé.

La signature de chaque livraison est vérifiée avant l’exécution du flux. Une livraison dont la signature n’est pas valide est ignorée et produit une erreur de nœud; une requête falsifiée ne peut donc pas lancer votre flux de travail. Le champ `data` de l’événement contient des identifiants; ajoutez un nœud Quire après le déclencheur pour récupérer l’enregistrement complet.

## Exemple : courriel de bienvenue lors d’une inscription <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** sur `enrolment.created`.
2. Nœud **Quire**, ressource **Users**, opération **Get**, avec l’ID utilisateur `{{$json.data.user_id}}`.
3. Nœud **Quire**, ressource **Courses**, opération **Get**, avec l’ID de cours `{{$json.data.course_id}}`.
4. Votre nœud de courriel ou de clavardage, avec le nom de la personne et le titre du cours.

## Dépannage <!--quire:troubleshooting-->

- **401** à chaque appel : l’URL de base et la clé appartiennent à des organisations différentes, ou la clé a été révoquée.
- **403** pour une opération : la clé n’a pas la portée nécessaire. Ajoutez-la dans `/admin/integrations/api-keys`.
- Le déclencheur ne s’exécute jamais : l’adresse webhook de n8n doit être accessible à Quire par HTTPS. Vérifiez le journal des livraisons de l’abonnement dans `/admin/webhooks`.

Source: https://docs.quirelms.com/fr-CA/integrations/n8n/index.mdx