Intégration n8n

Qu'est-ce que n8n ?

n8n est une plateforme d'automatisation de flux de travail open source qui vous permet de connecter Manatal à des centaines d'autres outils, notamment Slack, Google Sheets, HubSpot, Salesforce, Microsoft Teams, et bien d'autres. Contrairement à d'autres outils d'automatisation, n8n peut être auto-hébergé pour une confidentialité totale des données, ou utilisé via n8n Cloud.

Chaque automatisation dans n8n s'appelle un Workflow, construit à partir de deux composants principaux :

• Le Nœud Déclencheur (Trigger Node) : L'événement qui démarre le workflow (par exemple, un nouveau Candidat est créé dans Manatal).
• Le Nœud d'Action (Action Node) : La réponse automatisée dans une autre application (par exemple, envoyer un message à un canal Slack).

Qu'est-ce que l'Intégration Manatal n8n ?

Cette intégration agit comme un pont entre Manatal et des centaines d'applications, vous permettant d'automatiser votre travail et d'augmenter votre productivité.

• Le nœud Manatal (@manatal/n8n-nodes-manatal) est un nœud communautaire vérifié. La vérification signifie qu'il a passé la revue de sécurité et de qualité de n8n, en faisant une intégration officielle disponible aussi bien pour les utilisateurs du Cloud que pour les utilisateurs auto-hébergés.
• Consultez la liste complète des déclencheurs et actions Manatal dans ce guide.

Pourquoi utiliser l'Intégration Manatal n8n ?

Intégrer Manatal à n8n permet à votre équipe d'automatiser les tâches de recrutement répétitives, de garder vos outils synchronisés et de créer des workflows entièrement personnalisés sans écrire de code :

• Gagnez des Heures de Travail Administratif : Transférez automatiquement les données des candidats embauchés vers votre SIRH, votre système de paie ou votre CRM dès qu'un match est marqué comme embauché.
• Améliorez la Communication : Notifiez votre équipe sur Slack ou Microsoft Teams en temps réel lorsqu'un candidat passe à une nouvelle étape ou qu'un statut de job change.
• Standardisez les Processus : Assurez-vous que chaque nouveau candidat reçoive une invitation à un test, une demande de vérification des antécédents, ou un formulaire de consentement RGPD, sans que personne dans votre équipe n'ait à s'en souvenir.
• Créez vos Propres Solutions : Vous n'avez pas besoin d'attendre que notre équipe développe une intégration spécifique. Connectez Manatal à n'importe quel outil de votre stack et créez des workflows adaptés à votre processus de recrutement unique.

Installer le Nœud Manatal

La façon d'installer le nœud Manatal dépend de si vous utilisez n8n Cloud ou une instance auto-hébergée.

Il existe quatre façons d'installer des nœuds communautaires.

1. Panneau de Nœuds

Les nœuds communautaires vérifiés peuvent être installés directement depuis le canevas n8n, sans page de paramètres requise.

1. Ouvrez un workflow dans votre instance n8n Cloud. Cliquez sur le bouton « + » pour ouvrir le panneau de nœuds.
2. Recherchez « Manatal ».
3. Cliquez sur le nœud et sélectionnez votre déclencheur ou action. Apprenez-en plus dans ce guide.

2. Interface des Paramètres (Auto-hébergé)

1. Dans votre instance n8n, allez dans Paramètres puis dans Nœuds Communautaires.
2. Cliquez sur « Installer un nœud communautaire ».
3. Entrez le nom du paquet : @manatal/n8n-nodes-manatal
4. Acceptez l'avis de risque et cliquez sur « Installer ».

3. Ligne de Commande (Auto-hébergé)

Si votre instance ne prend pas en charge l'installation via interface graphique, vous pouvez installer le nœud manuellement via npm, puis redémarrer votre instance n8n.

1. Accédez à votre shell Docker :

docker exec -it n8n sh

2. Créez ~/.n8n/nodes s'il n'existe pas déjà, et naviguez à l'intérieur :

mkdir ~/.n8n/nodes
cd ~/.n8n/nodes

3. Installez le nœud :

npm install @manatal/n8n-nodes-manatal

4. Redémarrez votre instance n8n après l'installation. Consultez le guide d'installation manuelle de n8n pour plus de détails.

4. Fichier de Configuration (Auto-hébergé)

Si votre équipe informatique configure les instances n8n automatiquement, le nœud Manatal peut être inclus dans la configuration de votre instance afin qu'il s'installe au démarrage, avec une version spécifique sélectionnée. Cela est généralement géré par la personne qui gère votre déploiement n8n.

Demandez-leur de consulter le guide d'installation par variable d'environnement de n8n pour les étapes de configuration. Le nom du paquet est @manatal/n8n-nodes-manatal.

Activer l'Intégration n8n

Récupérer votre Clé API Manatal

1. Rendez-vous sur la page suivante. Vous pouvez aussi cliquer sur « Administration » dans votre menu latéral et ouvrir la catégorie « Fonctionnalités ».
   
   
2. Cliquez sur « API Ouverte ».
   
3. Cliquez sur « Générer un nouveau jeton ».
   
4. Renseignez le nom du jeton API (par exemple, « Intégration n8n ») et cliquez sur « Générer ».
   
5. Copiez la clé API générée.
   
6. Connectez-vous à votre compte Manatal et repérez la connexion à l'application Manatal. Saisissez le jeton API Manatal pour finaliser l'intégration. En savoir plus ici.

Cas d'Usage Courants

Utilisez ces workflows comme source d'inspiration pour ce qui est possible en connectant Manatal à l'ensemble de votre stack de recrutement.

Signatures Électroniques et Offres

Cas d'Usage : Déclenchez automatiquement des documents juridiques et des lettres d'offre dès qu'un candidat passe à l'étape « Offre ». Vous pouvez pré-remplir ces documents avec des données extraites directement de Manatal (comme le nom, le salaire ou le titre du poste), garantissant l'exactitude et évitant à votre équipe une saisie de données répétitive.

• DocuSign : Lorsqu'un Match est déplacé, filtré sur l'étape Offre → Envoie la lettre d'offre ou le contrat de travail correspondant pour signature électronique.
• Dropbox Sign : Lorsqu'un Match est déplacé, filtré sur l'étape Offre → Envoie une demande de signature pré-remplie avec les données du candidat et du poste.
• PandaDoc : Lorsqu'un Match est déplacé, filtré sur l'étape Offre → Génère et envoie un contrat de prestataire pré-rempli depuis Manatal.

Présélection de CV par IA

Cas d'Usage : Présélectionnez les candidats à grande échelle. Lorsqu'un nouveau candidat est ajouté à Manatal, un modèle d'IA évalue et résume son adéquation avec le poste, écrit le résultat sous forme de Note sur son profil, et alerte un recruteur lorsque le score dépasse votre seuil.

• OpenAI : Lorsqu'un Candidat est créé dans Manatal → Envoie son CV et la description du poste à un modèle GPT et écrit le score d'adéquation sous forme de Note Manatal.
• Anthropic Claude : Lorsqu'un Candidat est créé dans Manatal → Génère une évaluation détaillée avec Claude et l'ajoute sous forme de Note Manatal avec les écarts d'expérience signalés.
• Google Gemini : Lorsqu'un Candidat est créé dans Manatal → Extrait les données structurées (compétences, expérience, formation) du CV et met à jour le profil du candidat dans Manatal.
• Slack : En poursuivant le même workflow, lorsque le score dépasse votre seuil → Publie un résumé du candidat dans votre canal de recruteurs.

SIRH et Intégration des Nouveaux Salariés

Cas d'Usage : Comblez l'écart entre le recrutement et les RH. Une fois qu'un match atteint votre étape « Embauché », synchronisez les données du candidat directement avec votre SIRH pour démarrer l'intégration, et ouvrez automatiquement les tâches associées.

• BambooHR : Lorsqu'un Match est déplacé, filtré sur l'étape Embauché → Crée une nouvelle fiche employé pré-remplie avec les données du candidat.
• Workday : Lorsqu'un Match est déplacé, filtré sur l'étape Embauché → Lance une transaction d'embauche et attribue la checklist d'intégration correspondante.
• Jira : Lorsqu'un Match est déplacé, filtré sur l'étape Embauché → Crée un ticket de tâche d'intégration et l'attribue à l'équipe concernée.

Synchronisation des Données de Recrutement et Reporting

Cas d'Usage : Selon une planification nocturne, récupérez chaque candidat, match et job mis à jour depuis la dernière exécution et écrivez-les directement dans votre base de données ou votre entrepôt de données. Garde vos tableaux de bord BI à jour sans exports manuels ni middleware.

• PostgreSQL / MySQL : Sur un déclencheur planifié nocturne, Récupère les Candidats et Matches → Insère ou met à jour les enregistrements dans votre base de données de recrutement interne.
• Google BigQuery : Sur un déclencheur planifié nocturne, Récupère les Candidats et Matches → Diffuse les enregistrements vers votre entrepôt de données pour une analyse à grande échelle.
• Google Sheets : Sur un déclencheur planifié nocturne, Récupère de nombreux Matches mis à jour → Ajoute un résumé quotidien du pipeline pour les parties prenantes.

Planification des Entretiens et Suivi

Cas d'Usage : Envoyez une confirmation par e-mail dès qu'un entretien est planifié, des documents de préparation 24 heures avant, et un rappel le jour même de l'entretien, le tout à partir d'un simple changement d'étape dans Manatal.

• Gmail / Outlook : Lorsqu'un Match est déplacé, filtré sur l'étape Entretien → Envoie une confirmation immédiatement, des documents de préparation après 24 heures, et un rappel le matin de l'entretien.
• Google Calendar : Lorsqu'un Match est déplacé, filtré sur l'étape Entretien → Crée une invitation de calendrier pour le candidat et le panel d'entretien.

Communication d'Équipe

Cas d'Usage : Tenez toute l'équipe informée en temps réel. Publiez un résumé des mouvements du pipeline directement sur la plateforme de discussion de votre équipe.

• Slack : Lorsqu'un Match est déplacé → Publie un résumé du changement d'étape dans votre canal de recrutement.
• Microsoft Teams : Lorsqu'un Candidat est créé dans Manatal → Publie une carte récapitulative du candidat dans le canal de votre équipe de recrutement.

Bonnes Pratiques pour Créer des Workflows

1. Activez votre Workflow :
   • n8n n'enregistre le déclencheur auprès de Manatal que lorsqu'un workflow est activé. Tant qu'un workflow est inactif, les événements Manatal ne l'atteindront pas. Créez et testez à l'aide des contrôles de test manuel de n8n, puis activez-le lorsque vous êtes prêt à passer en production.
2. Commencez par un workflow simple à 2 nœuds.
   • Avant de créer des workflows complexes à plusieurs étapes, commencez par un seul Déclencheur et une seule Action (par exemple, Manatal vers Slack). Une fois à l'aise avec le flux de données, vous pouvez commencer à ajouter davantage d'étapes.
3. Utilisez des Conventions de Nommage Descriptives :
   • À mesure que vous créez davantage d'automatisations, il peut devenir difficile de les gérer. Nommez vos workflows en fonction du flux, par exemple : « [Manatal → DocuSign] Envoyer la Lettre d'Offre lorsque l'Étape est Offre. » Vous pouvez également étiqueter vos workflows pour regrouper les automatisations liées.
4. Exploitez les Nœuds « IF » :
   • Les déclencheurs se déclenchent à chaque événement correspondant dans Manatal. Utilisez le nœud IF intégré de n8n pour vous assurer que le workflow ne se poursuit que lorsque des critères spécifiques sont remplis (par exemple, seulement une étape de pipeline particulière, ou seulement les jobs de type « Temps Plein »). Cela garde vos données propres et réduit les exécutions inutiles. Apprenez-en plus sur la division des workflows avec des conditions.
5. Testez avec des Données « Factices » :
   1. Créez un candidat ou un job de test dans Manatal pour déclencher votre workflow pour la première fois. Cela vous permet de voir exactement comment les données apparaissent dans l'application de destination avant de les appliquer à de vrais candidats. Vous pouvez consulter chaque exécution dans votre historique d'exécutions pour voir exactement quelles données sont passées à chaque étape.
6. Configurez un Workflow de Gestion des Erreurs :
   1. n8n vous permet d'attribuer un workflow dédié à la gestion des erreurs, afin que votre équipe soit automatiquement notifiée en cas d'échec d'une automatisation. Cela garde votre pipeline de données fiable. Consultez le guide n8n pour gérer les erreurs avec élégance.

Pour en savoir plus sur la conception, le test et la maintenance des workflows, consultez le guide n8n pour créer des workflows.

FAQ

Q1. Quels Déclencheurs et Actions Manatal sont disponibles dans n8n ?

L'intégration propose 7 déclencheurs et 69 actions répartis sur 19 ressources. Vous pouvez consulter la liste complète sur notre page de référence des Déclencheurs et Actions.

Q2. Ai-je besoin d'un compte n8n payant pour utiliser l'intégration Manatal ?

Vous pouvez commencer avec le plan gratuit de n8n Cloud, ou auto-héberger n8n gratuitement. Selon la complexité de vos workflows ou votre volume d'exécutions mensuel, vous pourriez avoir besoin d'un abonnement payant n8n par la suite.

Q3. Quels plans Manatal incluent l'accès à l'intégration n8n ?

L'intégration nécessite l'accès à l'API Ouverte, qui est inclus dans notre Plan Enterprise Plus. Si vous êtes sur un plan différent, veuillez contacter notre équipe de support pour discuter d'une mise à niveau ou de l'activation de l'accès API pour votre compte.

Q4. Le transfert de données entre Manatal et n8n est-il instantané ?

Quasi instantané. Dès qu'un événement déclencheur se produit (comme la création d'un nouveau candidat), les données sont envoyées à votre workflow n8n actif via un webhook en quelques secondes.

Q5. Je reçois une erreur « Non autorisé » ; comment la résoudre ?

Cela signifie généralement que le Jeton API a été supprimé ou désactivé dans Manatal. Pour résoudre ce problème, générez simplement un nouveau jeton API Ouverte dans les paramètres d'Administration de Manatal et mettez à jour l'identifiant dans la section « Identifiants » de votre instance n8n.

Q6. Puis-je supprimer des enregistrements Manatal via n8n ?

Non. Pour des raisons de sécurité, l'intégration ne propose délibérément aucune opération de suppression. Les enregistrements peuvent uniquement être créés, consultés et mis à jour.