n8n | Quire

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

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

The API keys page with a key named for an n8n automation. — Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.

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

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

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 Trigger sur enrolment.created.
Nœud Quire, ressource Users, opération Get, avec l’ID utilisateur {{$json.data.user_id}}.
Nœud Quire, ressource Courses, opération Get, avec l’ID de cours {{$json.data.course_id}}.
Votre nœud de courriel ou de clavardage, avec le nom de la personne et le titre du cours.

Dépannage

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.