---
title: Relier le CRM à n8n
description: "Recevoir les événements du CRM dans n8n, appeler l'API par le nœud HTTP Request et mettre en service le modèle « e-mail reçu vers brouillon de fiche »."
url: "https://illizeo.com/centre-aide/crm-n8n/"
updated: "2026-11-08"
category: CRM
---

# Relier le CRM à n8n

n8n se branche au CRM par deux nœuds standard : **Webhook** pour recevoir les événements du CRM, **HTTP Request** pour lire et écrire par l'API v1. Illizeo fournit en plus un modèle de workflow prêt à importer, qui transforme un e-mail reçu en tâche de suivi ou en nouveau contact. Cet article s'adresse aux personnes qui construisent les workflows n8n.

## Avant de commencer

- Le module CRM doit être activé. Pour recevoir des événements, votre abonnement Illizeo doit comprendre les webhooks, et votre instance n8n doit être joignable en https sur l'internet public.
- Pour télécharger le modèle : « Réglages du CRM : consulter ». Pour créer l'abonnement aux événements : « Réglages du CRM : créer » (voir [Les webhooks du CRM](https://illizeo.com/centre-aide/crm-webhooks/)).
- Un jeton d'API, créé dans **Paramètres › Gérer Illizeo › Jetons API** (voir [Créer et gérer les jetons API](https://illizeo.com/centre-aide/api-gerer-les-jetons/)). Pour le modèle : **Lire** et **Écrire** pour « CRM — contacts », **Écrire** pour « CRM — activités ». Pour recevoir des événements : la lecture des objets concernés.
- Le jeton agit avec les droits et la portée de la personne qui l'a créé : pour le modèle, « Contacts CRM : consulter » et « créer », « Activités CRM : créer ».
- Dans n8n, créez une identification de type **Header Auth** : nom `Authorization`, valeur `Bearer`, une espace, puis votre jeton.

## Recevoir les événements du CRM

1. Dans n8n, ajoutez un nœud **Webhook**, méthode `POST`, et copiez son adresse de production (https).
2. Dans Illizeo, ouvrez **Paramètres › CRM › Webhooks et intégrations**, cliquez sur **Nouveau webhook** et créez un abonnement vers cette adresse, avec votre jeton et les événements voulus. Copiez le secret de signature.
3. Activez le workflow dans n8n : son adresse de production n'écoute que lorsqu'il est actif.
4. Avant de traiter un appel, vérifiez sa signature : recalculez le HMAC-SHA256 de `<t>.<corps brut>` avec le secret et comparez-le à la valeur `v1` de l'en-tête `Illizeo-Signature`. Gardez pour cela le corps brut dans le nœud Webhook, et faites le calcul dans un nœud Crypto ou Code.
5. Répondez vite par un code 2xx (réponse immédiate du nœud Webhook), puis traitez. Ignorez un `id` déjà traité : une relance porte le même.

Le contenu reçu, les événements et les règles de relance sont décrits dans [Les webhooks du CRM](https://illizeo.com/centre-aide/crm-webhooks/). Le bouton **Envoyer un test** de la fiche de l'abonnement envoie un événement `ping` pour vérifier le branchement.

![La fenêtre Nouveau webhook remplie pour n8n : l'adresse de production du nœud Webhook en https, le jeton d'API et les événements du CRM.](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/crm-n8n-01.fr_.png?resize=672%2C810&quality=80&ssl=1)
Un abonnement vers l'adresse de production du nœud Webhook de n8n.

## Lire et écrire par l'API

Un nœud **HTTP Request** appelle l'API v1 du CRM : choisissez l'authentification par identification générique, de type **Header Auth**, et l'identification créée plus haut. Les chemins sont ceux de l'API (`/v1/crm/accounts`, `/v1/crm/contacts`, `/v1/crm/opportunities`, `/v1/crm/activities`), avec la recherche `q`, `modified_since` et la pagination par curseur : voir [Importer, exporter et utiliser l'API](https://illizeo.com/centre-aide/crm-import-export-et-api/). Une liste répond dans `data.items`.

## Le modèle « e-mail reçu vers brouillon de fiche »

Le modèle reçoit un e-mail (expéditeur, nom, objet, texte) et cherche son expéditeur dans le CRM : connu, il crée une tâche de suivi sur son compte ; inconnu, il crée le contact. Il compte six nœuds :

| Nœud | Rôle |
| --- | --- |
| Webhook — e-mail reçu | Reçoit en `POST` l'e-mail : `from` (l'adresse), `from_name` (le nom), `subject` (l'objet), `text` (le texte). |
| HTTP Request — chercher le contact | Cherche un contact dont la fiche contient l'adresse (`GET /v1/crm/contacts?q=…`). |
| Contact connu ? | Oriente selon que la recherche a trouvé une fiche. |
| Rattaché à un compte ? | Poursuit si le contact trouvé a un compte principal que le jeton peut lire : une tâche se pose toujours sur un compte. Sinon, le workflow s'arrête sans rien écrire. |
| HTTP Request — tâche de suivi | Crée sur ce compte une tâche « Répondre : » suivi de l'objet, à échéance du lendemain, liée au contact, avec le texte de l'e-mail en compte rendu. |
| HTTP Request — brouillon de contact | Crée le contact, avec le nom de l'expéditeur et son adresse en e-mail professionnel principal. |

![Schéma du modèle n8n : le nœud Webhook reçoit l'e-mail, le nœud HTTP Request cherche le contact par son adresse ; s'il est connu et rattaché à un compte, une tâche de suivi à échéance du lendemain est créée sur ce compte ; connu sans compte, le workflow s'arrête ; inconnu, un contact est créé avec le nom et l'adresse de l'expéditeur.](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/crm-n8n-flux-01-v2.fr_.png?resize=800%2C504&quality=80&ssl=1)
Le modèle tel qu'il est livré : la tâche se pose sur le compte du contact trouvé.

1. Dans Illizeo, ouvrez **Paramètres › CRM › Webhooks et intégrations**. Dans la carte **Intégrations**, sous **n8n**, cliquez sur **Télécharger le modèle** : vous obtenez `illizeo-crm-n8n-email-vers-fiche.json`, sans secret ni jeton.
2. Dans n8n, ouvrez un nouveau workflow et importez le fichier (menu du workflow, **Import from File**).
3. Associez votre identification Header Auth aux trois nœuds HTTP Request.
4. Adaptez le modèle à vos règles (par exemple l'échéance de la tâche, ou une suite pour les contacts sans compte), puis activez-le.
5. Envoyez au nœud Webhook les e-mails à traiter, depuis votre outil de messagerie ou un autre workflow, avec les champs `from`, `from_name`, `subject` et `text`.

![La carte Intégrations des réglages du CRM : n8n et son bouton Télécharger le modèle, à côté de Power Automate.](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/crm-n8n-02.fr_.png?resize=800%2C165&quality=80&ssl=1)
Le modèle de workflow n8n se télécharge depuis les réglages du CRM.

## À savoir

- Le « brouillon » est une vraie fiche de contact, dont la personne qui a créé le jeton devient propriétaire : complétez-la ensuite dans le CRM (compte, fonction, base légale).
- Le nom est obligatoire : sans nom d'expéditeur, le modèle reprend l'adresse comme nom, à corriger ensuite dans le CRM. Créer le contact répond `409 DUPLICATES_FOUND` si la fiche ressemble à un contact existant, tant que le corps n'envoie pas `confirmer_doublon` à vrai. Une adresse d'un contact en opposition donne un contact en opposition.
- Un contact sans compte principal, ou dont le compte n'est pas lisible par la personne qui a créé le jeton, ne reçoit pas de tâche : le nœud « Rattaché à un compte ? » arrête le workflow. Rattachez le contact à un compte dans le CRM, ou branchez une autre suite sur la sortie « false ».
- Le modèle construit ses corps avec `JSON.stringify` : un guillemet ou un retour à la ligne dans l'objet ou le texte de l'e-mail passe sans rendre le corps invalide. Construisez de la même façon les champs que vous ajoutez.
- Si votre espace soumet une écriture à une validation humaine, l'API répond `202` sans rien écrire (voir [Faire valider les fiches et les envois](https://illizeo.com/centre-aide/crm-validations/)).
- Pour préparer une fiche à partir d'un e-mail sans outil tiers, le CRM a aussi son adresse de transfert (voir [L'adresse de transfert du CRM](https://illizeo.com/centre-aide/crm-adresse-de-transfert/)).

## Questions fréquentes

### Le nœud « tâche de suivi » répond par une erreur 422 ou 403.

Le corps ne passe pas les contrôles de l'API, qui précise la clé en cause : une tâche demande un compte (`compte_id`) et une échéance (`echeance_le`, au format AAAA-MM-JJ). Le modèle envoie les deux ; si vous avez modifié le corps, vérifiez qu'ils y sont toujours. Une erreur 403 tient aux droits : le jeton doit porter **Écrire** pour « CRM — activités », et son créateur avoir « Activités CRM : créer ».

### Le workflow ne reçoit pas les événements du CRM.

Vérifiez que le workflow est actif, que l'abonnement vise l'adresse de production du nœud Webhook, et ouvrez la fiche de l'abonnement dans Illizeo : son journal des livraisons dit ce que n8n a répondu.

### *Similaire*