Intégrations › n8n

QRavate et n8n

Ajoutez les QR codes dynamiques à vos workflows n8n : créez-les en masse depuis une base, changez leur destination selon vos règles, déclenchez un workflow quand l’un d’eux atteint un nombre de scans. Le nœud sert aussi d’outil aux agents IA de n8n.

Ce que vous pouvez automatiser

Des centaines de QR codes depuis une base

Un workflow lit vos produits dans Airtable, Postgres ou un fichier CSV et crée un QR code par produit, avec son nom.

Un agent IA qui gère vos codes

Le nœud QRavate est utilisable comme outil par l’agent IA de n8n : « mets en pause les codes de la campagne d’été » devient une action.

Les scans dans votre reporting

Chaque lundi, un workflow lit les statistiques de vos codes et les ajoute à votre tableau de bord ou à votre entrepôt de données.

Des destinations pilotées par vos données

Quand un produit est en rupture dans votre boutique, son QR code renvoie vers un produit équivalent.

Déclencheurs et actions

DéclencheurQuand
Nouveau QR codeUn QR code est créé dans votre espace.
Destination modifiéeLa destination d’un QR code change.
QR code mis en pause ou réactivéUn code est mis en pause, ou relancé.
Seuil de scans atteintUn QR code atteint le nombre de scans que vous fixez (une fois par code).
ActionCe qu’elle fait
Créer un QR codeUn QR code dynamique, avec un nom et une destination.
Modifier un QR codeNouvelle destination ou nouveau nom. Le code imprimé ne change pas.
Mettre en pause ou réactiverPendant la pause, le scan affiche une page neutre.
Lister les QR codesTous les codes, ou filtrés par texte et par état, avec pagination.
Supprimer un QR codeRestaurable 30 jours depuis votre compte.
Lire les statistiquesScans sur une période : total, visiteurs uniques, détail par jour.

Installer l’intégration n8n

L’intégration est en cours de publication sur n8n. Son code est déjà public : QRavate/n8n-nodes-qravate sur GitHub. Une fois publiée, l’installation se fera en trois étapes :

  1. Dans n8n, ouvrez Paramètres → Nœuds de la communauté → Installer et saisissez n8n-nodes-qravate.
  2. Créez l’identifiant QRavate API avec une clé d’API, créée dans API et webhooks de votre espace QRavate.
  3. Ajoutez le nœud QRavate ou QRavate Trigger à votre workflow.

En attendant : la même chose avec les webhooks

Tout ce que fera l’intégration est déjà possible avec les briques génériques de n8n et l’API QRavate :

  1. Dans votre compte, ouvrez API et webhooks et créez une clé (elle commence par sk_ et ne s’affiche qu’une fois).
  2. Pour réagir à un événement : ajoutez un nœud Webhook (méthode POST) et copiez son adresse de production. Dans API et webhooks, ajoutez un webhook vers cette adresse.
  3. Pour agir sur un QR code : utilisez le nœud HTTP Request vers https://www.qravate.com/api/v1/qr, avec un identifiant « Header Auth » (Authorization : Bearer sk_…). Les appels sont décrits dans la documentation de l’API.

Ce qu’il vous faut

  • Un compte QRavate au plan Pro ou Max : l’API, les webhooks et les connecteurs sont inclus à partir du Pro (tarifs).
  • Une clé d’API, créée dans API et webhooks. Une clé donne accès à un seul espace, et se révoque à tout moment.
  • Un compte n8n.

Questions fréquentes

Le nœud fonctionne-t-il en auto-hébergé ?

Oui : c’est un nœud de la communauté, installable sur toute instance n8n récente. Sur n8n Cloud, il sera proposé directement une fois vérifié par n8n.

Quel plan QRavate faut-il ?

Le plan Pro ou Max : l’API, les webhooks et les connecteurs sont inclus à partir du Pro.

Les webhooks sont-ils signés ?

Oui. Chaque appel porte l’en-tête X-Webhook-Signature (HMAC-SHA256), que le déclencheur QRavate vérifie pour vous.

Le code est-il public ?

Oui, sous licence MIT, sur GitHub. Vous pouvez le lire, le signaler ou proposer une amélioration.