Aller au contenu principal

Workflows n8n

AI-School peut démarrer des workflows n8n au moyen d'un webhook de production. C'est utile lorsque vous voulez déclencher un processus automatisé en dehors de AI-School, par exemple créer une tâche, mettre à jour une fiche CRM, lancer un workflow de rapport ou transmettre des données de formulaire à un autre système.

Exemple : article d’actualité sur le site de l’école​

Supposons que l’école ait créé un workflow n8n qui publie un article d’actualité sur son site WordPress. Dans AI-School, l’utilisateur saisit seulement un court texte, par exemple quelques phrases sur une semaine de projet, une journée sportive ou une journée portes ouvertes. Ce texte déclenche le workflow dans n8n.

Le workflow n8n peut ensuite, par exemple :

  1. Transformer le court texte en brouillon soigné avec un nœud LLM et un prompt adapté au ton de l’école.
  2. Créer une illustration adaptée avec un deuxième nœud LLM, par exemple avec les couleurs de l’école et dans un style illustratif reconnaissable.
  3. Préparer ou publier le texte et l’image comme article de blog sur le site WordPress.

Voici comment AI-School et n8n travaillent ensemble : dans AI-School, l’utilisateur choisit le workflow et saisit les informations nécessaires. n8n exécute ensuite les étapes automatisées et veille à ce que l’article soit correctement placé sur le site.

Que fait cette intégration ?​

Un workflow n8n dans AI-School n'est pas un chat IA. Le workflow est démarré directement depuis l'aperçu des workflows.

  • Si le workflow n’a pas de champs, le webhook est appelé immédiatement.
  • Si le workflow contient des champs, une fenêtre s’ouvre d’abord. L’utilisateur remplit le formulaire puis démarre le workflow avec le bouton.
  • Les valeurs saisies sont envoyées en JSON dans une requête POST vers le webhook n8n.

Créer un workflow n8n dans AI-School​

Un administrateur enregistre le workflow comme suit :

  1. Allez dans Assistants.
  2. Ouvrez Workflows.
  3. Choisissez Nouveau workflow n8n.
  4. Saisissez le nom du workflow et l’URL de production n8n.
  5. Configurez Header authentication avec un nom d’en-tête et une valeur d’en-tête secrète.
  6. Ajoutez éventuellement les champs à envoyer dans la requête POST.
  7. Enregistrez le workflow.

Champs​

  • Les champs sont facultatifs.
  • Chaque champ possède un seul nom de champ et un type.
  • Les types pris en charge sont texte court, texte long, nombre, oui/non et date.
  • Les champs obligatoires doivent être remplis avant le démarrage du workflow.
  • Le nom du champ devient la clé dans le corps JSON envoyé à n8n.

Créer un workflow compatible dans n8n​

  1. Créez un nouveau workflow dans n8n.
  2. Ajoutez un Webhook Trigger comme premier node.
  3. Réglez HTTP Method sur POST.
  4. Configurez Header authentication dans n8n. Utilisez le même nom et la même valeur d’en-tête que dans l’application.
  5. Copiez la Production URL du webhook. N’utilisez pas l’URL de test.
  6. Activez le workflow dans n8n.
  7. Utilisez le corps JSON reçu dans les nodes n8n suivants.

Exemple de corps JSON​

Si vous définissez des champs nommés prompt, customerName et date, n8n reçoit par exemple ce corps JSON :

{
  "prompt": "Create a short summary of the request.",
  "customerName": "Example organization",
  "date": "2026-09-22"
}

Limitations importantes​

  • Seuls les Webhook Triggers sont pris en charge.
  • Seules les URLs de webhook de production sont prises en charge.
  • Les URLs de test contenant /webhook-test/ sont refusées.
  • Seule la méthode POST est prise en charge.
  • Seule la generic header authentication est prise en charge.
  • La valeur de l’en-tête est traitée comme un secret dans l’application.
  • Le tenant est déterminé côté serveur à partir de l’utilisateur connecté, pas à partir d’une valeur envoyée par le navigateur.

Résolution des problèmes​

  • 404 ou webhook non enregistré : activez le workflow dans n8n et utilisez l’URL de production.
  • Erreur d’authentification : vérifiez que le nom et la valeur de l’en-tête sont exactement identiques dans les deux systèmes.
  • Données manquantes : vérifiez que les noms de champs dans l’application correspondent aux clés attendues par n8n.
  • Aucune requête dans n8n : vérifiez que le workflow commence par un Webhook Trigger et utilise POST.
WhatsApp