Nœud n8n

Offre Business

Le nœud CRM pour n8n qui gère vos contacts, affaires et conversations

Installez n8n-nodes-pinlyx depuis le panneau Community Nodes, collez une clé API, et un formulaire envoyé devient un contact, une affaire gagnée devient une facture, une conversation restée sans réponse devient un message dans le canal que suit votre équipe. Huit opérations sur trois ressources, aucune dépendance d’exécution, sous licence MIT.

Offre Free gratuite à vie · Sans carte bancaire · Résiliable à tout moment

Dernière mise à jour:

3
Ressources
Contact, affaire, conversation
8
Opérations
Cinq sur les contacts, deux sur les affaires, une sur les conversations
0
Dépendance d’exécution
Chaque appel passe par l’outil HTTP intégré à n8n
MIT
Licence
Code source sur GitHub, publié sur npm

Définition

Un nœud communautaire n8n est un paquet publié sur npm qu’une instance n8n installe à l’exécution pour ajouter un nouveau bloc au canevas. Ce n’est pas un fork de n8n, ni un récepteur de webhooks que vous devez héberger et maintenir en ligne vous-même.

n8n-nodes-pinlyx est celui de Pinlyx. Il s’authentifie avec une clé API que vous générez dans le panneau et donne à un workflow huit opérations sur les contacts, les affaires et les conversations, en gérant pour vous la pagination par curseur.

Publié sur npm sous le nom n8n-nodes-pinlyx, code source sur GitHub sous licence MIT. Testé avec n8n 1.60 et versions ultérieures, sur Node.js 20.15 et plus. npm · GitHub

Le nœud interroge la même API REST publique qu’un script : tout ce qu’il fait se reproduit avec curl, et tout ce qu’il ne fait pas n’est qu’à un nœud HTTP Request de distance.

Ce que le nœud apporte à un workflow

Trois ressources, choisies parce que ce sont celles dont une automatisation a réellement besoin. Toutes les règles ci-dessous sont appliquées par l’API, pas par le nœud.

Contacts, cinq opérations

Créer, lire, lister, modifier et archiver. La liste se filtre par recherche, plateforme, e-mail, ID externe et Updated Since, le filtre sur lequel repose une synchronisation incrémentale.

Affaires, deux opérations

Créez une affaire avec titre, montant, devise, étape, probabilité, date de clôture prévue et notes. Listez-les avec des filtres par étape, par contact et par recherche dans le titre.

Conversations, en lecture seule

Les fils récemment actifs sur tous les canaux connectés, du plus récent au plus ancien, chaque ligne indiquant l’ID du contact, le canal, un indicateur de non-lu et un court aperçu du dernier message.

L’ID externe bloque les doublons

Inscrivez votre propre identifiant sur un contact : une nouvelle exécution est alors refusée avec une erreur HTTP 409 qui désigne la fiche existante, au lieu de créer en silence une deuxième copie de la même personne.

Pagination par curseur intégrée

Activez Return All et le nœud parcourt toutes les pages pour vous. Laissez-le désactivé et fixez une limite. Une page contient au plus 100 lignes pour les contacts et les affaires, 50 pour les conversations : une longue liste représente donc de nombreuses requêtes, quelle que soit la façon de la demander.

Clé à permissions, vérifiée côté serveur

Les identifiants contiennent une seule clé API. Chaque opération déclare la permission dont elle a besoin : une clé sans contacts:write fait échouer une création avec une erreur 403, au lieu de sembler fonctionner sans rien modifier.

Installer le nœud

Le nœud est publié sur npm sous le nom n8n-nodes-pinlyx et s’installe comme tous les nœuds communautaires : depuis n8n, sans copier de fichiers sur un serveur.

  1. Ouvrez Settings, puis Community Nodes. Il vous faut pour cela le compte propriétaire de l’instance. Un compte membre ne peut pas installer de paquets.
  2. Cliquez sur Install et saisissez n8n-nodes-pinlyx. Acceptez l’avertissement sur les nœuds communautaires et lancez l’installation. n8n récupère le paquet et le nœud apparaît dans la recherche du canevas en quelques secondes.
  3. Ajoutez le nœud Pinlyx à un workflow. Il demande des identifiants avant de vous laisser choisir une ressource : c’est donc la prochaine chose à créer.

Ou, sur une instance auto-hébergée, en ligne de commande :

npm install n8n-nodes-pinlyx
# then restart n8n

Une réserve à connaître avant de bâtir quoi que ce soit dessus : n8n Cloud ne propose que les nœuds communautaires que n8n a lui-même examinés et vérifiés, et ce paquet n’est pas passé par cet examen. Les instances auto-hébergées installent n’importe quel paquet publié. Sur Cloud, les mêmes opérations restent accessibles via le nœud HTTP Request appliqué à l’API REST : c’est la réponse honnête, pas un détail que nous préférerions taire.

Le paquet ne déclare aucune dépendance d’exécution. Chaque requête passe par l’outil HTTP intégré à n8n, ce qui permet aux identifiants d’injecter l’en-tête Authorization et garde l’installation légère.

Créer les identifiants

Le nœud s’authentifie avec une clé API Pinlyx : une clé, un en-tête, aucun aller-retour OAuth.

  1. Dans le panneau Pinlyx, ouvrez Paramètres, puis Développeurs. Créez une clé et nommez-la d’après le workflow qui l’utilisera : vous saurez ainsi ce qui cessera de fonctionner le jour où vous la révoquerez.
  2. N’accordez que les permissions dont ce workflow a besoin. Un workflow qui écrit des contacts a besoin de contacts:read et contacts:write. Un rapport sur les affaires a besoin de deals:read. Les conversations se lisent avec contacts:read.
  3. Copiez le jeton une fois pour toutes. Les clés de production commencent par csk_live_ et les clés de test par csk_test_. Le jeton complet n’apparaît qu’à la création ; ensuite, le panneau n’affiche plus que son préfixe.
  4. Ajoutez des identifiants Pinlyx API dans n8n et collez la clé. Laissez Base URL sur https://api.pinlyx.com, sauf si vous visez un environnement de préproduction, puis lancez le test des identifiants.

Le test des identifiants effectue l’appel authentifié le plus léger qui soit :

curl https://api.pinlyx.com/v1/me \
  -H "Authorization: Bearer csk_live_YOUR_KEY"

Les clés API font partie de l’offre Business. Avec Free et Pro, il n’y a aucune clé à générer, et donc rien à mettre dans les identifiants. C’est le seul prérequis à vérifier avant d’installer quoi que ce soit.

Le quota est de 60 requêtes par minute et par clé par défaut. Chaque réponse contient X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset, et un dépassement renvoie une erreur HTTP 429 avec un Retry-After en secondes. Comme la limite s’applique par clé et non par espace de travail, un workflow coincé dans une boucle se bride lui-même au lieu d’affamer vos autres intégrations.

Huit opérations sur trois ressources

Voici la surface complète, pas une sélection des meilleurs moments.

Chaque opération correspond à un seul point de terminaison de l’API publique v1 : rien ici ne se comporte différemment d’une requête que vous écririez à la main.

  • Contact, Create. Exige au moins un nom, un nom d’utilisateur, un téléphone, un e-mail ou un ID externe. Additional Fields accepte l’e-mail, le téléphone, le nom d’utilisateur, la plateforme, des notes et votre propre ID externe.
  • Contact, Get. Un contact, par son ID numérique.
  • Contact, Get Many. Filtres par recherche de sous-chaîne, plateforme, e-mail, ID externe et Updated Since.
  • Contact, Update. Une mise à jour partielle : un champ que vous n’ajoutez pas à la collection reste tel quel au lieu d’être vidé.
  • Contact, Delete. Archive au lieu d’effacer. L’historique des messages et les affaires liées sont conservés, exactement comme avec la même action dans le panneau.
  • Deal, Create. Le titre est obligatoire. Le montant, la devise, l’étape, la probabilité, la date de clôture prévue, les notes et l’ID de contact sont facultatifs.
  • Deal, Get Many. Filtres par étape, contact et recherche dans le titre. L’étape accepte ici won et lost, car lire une affaire clôturée ne pose aucun problème, même si en écrire une est interdit.
  • Conversation, Get Many. Les conversations récemment actives sur tous les canaux connectés, de la plus récente à la plus ancienne, chacune avec un aperçu du dernier message.

Le champ plateforme d’un contact accepte Telegram, WhatsApp, Instagram, LinkedIn, X et Email. Il enregistre le canal par lequel la personne est arrivée, ce qui permet ensuite au CRM de regrouper ses conversations.

Ce qui ne figure pas dans cette liste n’est pas dans le nœud. L’envoi de messages, les étiquettes, le scoring des prospects, les tâches, les factures et les séquences existent tous dans l’API REST. Ils ne font simplement pas partie de ces huit opérations.

Workflow n° 1 : un formulaire envoyé devient un contact

La raison la plus courante d’utiliser ce nœud. Un prospect remplit un formulaire, et la fiche existe dans le CRM avant que quiconque n’ait ouvert un onglet.

  1. Déclenchez sur le formulaire. Un Form Trigger n8n, un nœud Webhook placé derrière votre propre formulaire, ou un nœud Typeform ou Google Forms. Tout ce qui transmet un objet JSON au nœud suivant fait l’affaire.
  2. Associez les champs à Contact, Create. Le nom depuis le champ nom, puis Additional Fields pour l’e-mail, le téléphone et les notes. Réglez Platform sur Email quand le prospect est arrivé sans identifiant de messagerie.
  3. Renseignez External ID avec l’ID de l’envoi. C’est ce champ qui permet de relancer le workflow sans risque. Une deuxième création portant le même ID externe est refusée avec une erreur HTTP 409, et le corps de l’erreur désigne le contact existant : une relance produit un avertissement de doublon, et non un doublon.
  4. Activez Continue On Fail dès que les relances deviennent normales. Avec cette option, la 409 arrive comme un élément porteur d’un message d’erreur et le reste du lot continue. Sans elle, l’exécution s’arrête : c’est ce que vous voulez au premier lancement, pas à trois heures du matin.

Si vous avez besoin d’un vrai upsert plutôt que d’une 409, l’API REST propose un point de terminaison par lots qui fait correspondre les fiches par ID externe, e-mail, téléphone ou nom d’utilisateur et accepte jusqu’à 200 lignes par requête. Le nœud ne l’expose pas. Pointez un nœud HTTP Request vers POST /v1/contacts/batch et vous obtenez le même comportement en un appel au lieu de deux cents.

Workflow n° 2 : une affaire gagnée devient une facture

À lire avant de le construire, car la conception évidente est la mauvaise.

Une affaire ne peut pas du tout passer à l’état gagné via l’API. Gagner une affaire inscrit une recette dans le journal du CRM : cette transition est donc volontairement réservée au panneau, sous les yeux d’un humain. Le nœud en tient compte : Deal, Create refuse les étapes won et lost, et il n’existe aucune opération de mise à jour. Vous lisez les affaires gagnées ; vous ne les écrivez pas.

  1. Interrogez régulièrement les affaires gagnées. Un Schedule Trigger toutes les quinze minutes vers Pinlyx, Deal, Get Many, avec le filtre Stage réglé sur Won.
  2. Ne gardez que celles que vous n’avez pas encore vues. Les affaires arrivent de l’ID le plus récent au plus ancien. Stockez l’ID le plus élevé déjà traité dans les données statiques du workflow et écartez tout ce qui lui est inférieur ou égal, ou inscrivez l’ID de l’affaire dans la référence de la facture et laissez l’outil comptable rejeter le doublon.
  3. Créez la facture. Transmettez le titre, le montant et la devise au nœud de facturation que vous utilisez déjà. L’affaire contient un ID de contact : un Contact, Get placé avant vous donne l’adresse e-mail à laquelle l’envoyer.

Si quinze minutes, c’est trop lent, ne raccourcissez pas l’intervalle. Abonnez-vous plutôt : Pinlyx émet un webhook sortant sur deal.won, signé en HMAC-SHA256 dans un en-tête X-Webhook-Signature et portant le nom de l’événement dans X-Webhook-Event. Pointez-le vers un nœud Webhook n8n et la facture part quelques secondes après la clôture de l’affaire, sans consommer le moindre quota d’interrogation. Il en va de même pour contact.created, contact.updated et message.received.

Workflow n° 3 : lire les conversations et les aiguiller

Conversation, Get Many renvoie les fils récemment actifs sur tous les canaux connectés : Telegram, WhatsApp, Instagram, X, e-mail et chat en direct du site, dans une seule liste. Chaque ligne indique l’ID du contact, le canal, l’état lu ou non lu, et jusqu’à 160 caractères du dernier message.

  1. Récupérez la liste récente à intervalles réguliers. Une limite de 50 suffit pour la plupart des boîtes de réception. Isolez les lignes non lues avec un nœud IF avant d’engager quoi que ce soit dessus.
  2. Classez l’aperçu. Envoyez le texte de l’aperçu au nœud de modèle que vous utilisez et demandez une seule étiquette : question tarifaire, demande d’assistance, spam ou rien à faire.
  3. Agissez selon l’étiquette. Publiez les questions tarifaires dans le canal que suit votre équipe commerciale, ouvrez un ticket pour les demandes d’assistance, et réécrivez le classement avec Contact, Update pour qu’il figure sur la fiche et pas seulement dans la discussion.

Deux limites à connaître avant de le construire. L’aperçu n’est qu’un aperçu : le nœud ne peut pas parcourir un fil de messages complet, un classifieur ne voit donc jamais que le dernier message. Et le nœud ne peut ni étiqueter un contact ni envoyer de réponse. Les deux existent dans l’API REST et sur le serveur MCP ; aucune ne fait partie de ces huit opérations.

Pagination, limites et forme d’une erreur

Trois comportements qui déterminent si un workflow survit à sa première vraie semaine.

  • La pagination fonctionne par curseur. Une réponse de liste contient les lignes et un curseur vers la page suivante. Return All suit ce curseur jusqu’à épuisement des pages ; une limite arrête plus tôt. Une page est plafonnée côté serveur à 100 lignes pour les contacts et les affaires et à 50 pour les conversations : Return All sur 4 000 contacts représente donc 40 requêtes, pas une.
  • La limite de débit s’applique par clé. Soixante requêtes par minute par défaut. Au-delà, vous recevez une erreur HTTP 429 avec un Retry-After en secondes, et les trois en-têtes X-RateLimit présents dans chaque réponse indiquent à quel point vous en étiez proche avant.
  • Les erreurs donnent une raison. 401 signifie que la clé est erronée ou révoquée. 403 signifie que la clé est valide mais n’a pas la permission que déclare l’opération. 404 signifie que l’ID n’appartient pas à cet espace de travail, ce qui donne volontairement la même réponse qu’un ID inexistant. 409 signale une collision d’ID externe et désigne la fiche qui porte déjà cet ID.

Une réponse de liste de l’API sur laquelle repose le nœud :

{
  "items": [ { "Id": 812, "Name": "Sarah Lin", "Platform": "email" } ],
  "nextCursor": 764,
  "hasMore": true
}

Les synchronisations incrémentales reposent sur Updated Since. Stockez l’horodatage de la dernière exécution réussie, transmettez-le à la suivante, et vous ne récupérez que la poignée de contacts modifiés plutôt que tous. C’est la différence entre une synchronisation nocturne qui se termine et une autre qui épuise tout son quota sur des lignes que personne n’a touchées.

Limites, en toute franchise

Ce que ce nœud ne fait pas

Six points qu’il vaut mieux lire ici que découvrir au beau milieu de la construction d’un workflow.

Il ne peut pas envoyer de message

L’API REST peut mettre en file d’attente un message Telegram ou un message privé X, et le serveur MCP aussi. Ces opérations ne figurent pas dans ce nœud. Si un workflow doit joindre un client, utilisez un nœud HTTP Request ou l’un des nœuds de canal natifs de n8n.

Il ne peut pas marquer une affaire comme gagnée

Gagner une affaire inscrit une recette dans le journal : la transition se fait donc uniquement dans le panneau. Le nœud crée des affaires et les liste. Il ne les clôture pas, et Create refuse purement et simplement les étapes won et lost.

Il n’existe pas de nœud déclencheur

C’est un nœud d’action. Pour lancer un workflow à partir d’un événement dans le CRM, enregistrez un webhook sortant et recevez-le avec le nœud Webhook de n8n. Interroger le CRM avec un Schedule Trigger fonctionne aussi, mais consomme un quota de requêtes que le webhook vous épargne.

Il n’étiquette pas, ne note pas et n’attribue pas

Les étiquettes, le scoring des prospects, l’attribution à un responsable, les tâches et les changements d’étape dans le pipeline existent tous dans l’API REST. Aucun ne fait partie des huit opérations. Contact, Update écrit les champs simples, rien de plus.

Il ne touche pas à l’argent

Pas de factures, pas d’écritures comptables, pas de paiements, pas de remboursements. Rien dans ce nœud ne fait circuler d’argent dans un sens ou dans l’autre : c’est la même frontière que trace le serveur MCP.

Il nécessite l’offre Business

Les clés API sont une fonctionnalité de l’offre Business. Avec Free et Pro, il n’y a aucune clé à coller dans les identifiants : le nœud n’a donc rien pour s’authentifier, même parfaitement installé.

Nœud, webhook ou serveur MCP

Trois façons de connecter le même CRM, chacune adaptée à une tâche différente. La plupart des équipes finissent par en utiliser deux.

Le nœud n8n

Des tâches déterministes, planifiées ou déclenchées

Vous savez exactement ce qui doit se passer, et quand. Un formulaire arrive, un contact est créé. Une affaire est conclue, une facture part. La logique vit sur un canevas que toute votre équipe peut lire, et une exécution en échec apparaît dans la liste des exécutions avec les données qui l’ont provoquée.

Idéal quand la règle est fixe et le volume régulier.

Les webhooks sortants

Réagir à l’instant où quelque chose se produit

Enregistrez un point de terminaison dans le CRM et il vous envoie une requête sur contact.created, contact.updated, message.received, deal.won et les autres événements. Signés en HMAC-SHA256, relancés avec un délai croissant et rejouables depuis un journal de livraison. Associez-les à un nœud Webhook n8n et vous passez de l’interrogation à la réception en temps réel.

Idéal quand la latence compte plus que la simplicité.

Le serveur MCP

Du discernement, pas de la tuyauterie

Un assistant IA décide au moment de l’appel, avec le fil réel sous les yeux, au lieu d’appliquer une règle écrite des semaines plus tôt. Des outils, des ressources et des prompts sur un seul point de terminaison authentifié, chaque appel restant borné par les permissions de la clé.

Idéal quand la réponse dépend de la lecture de la situation.

FAQ sur l’intégration n8n

Les questions qui se posent dès la première heure, avec des réponses fondées sur le comportement réel.

C’est un nœud communautaire n8n publié sur npm sous le nom n8n-nodes-pinlyx. Installé dans une instance n8n, il ajoute au canevas des workflows un bloc Pinlyx doté de huit opérations : créer, lire, lister, modifier et archiver un contact ; créer et lister des affaires ; lister les conversations récentes. Il s’authentifie avec une clé API Pinlyx limitée par des permissions et n’a aucune dépendance d’exécution.
Sur une instance n8n auto-hébergée, ouvrez Settings, puis Community Nodes, cliquez sur Install et saisissez n8n-nodes-pinlyx. Il vous faut le compte propriétaire de l’instance. Vous pouvez aussi lancer npm install n8n-nodes-pinlyx dans le répertoire de données de n8n puis redémarrer le processus : c’est la voie à suivre quand l’installateur de nœuds communautaires est désactivé sur votre instance.
n8n Cloud ne propose que les nœuds communautaires que n8n a examinés et vérifiés, et ce paquet n’est pas encore passé par cet examen. Sur Cloud, les mêmes opérations sont disponibles via le nœud HTTP Request pointé vers l’API REST de Pinlyx avec la même clé bearer : un peu plus de configuration, mais exactement le même comportement.
Business. Les clés API sont une fonctionnalité de l’offre Business : les espaces de travail Free et Pro ne peuvent donc pas générer la clé dont les identifiants ont besoin. Tout le reste est gratuit : le paquet est sous licence MIT et son installation comme son utilisation ne coûtent rien.
Pas à lui seul. C’est un nœud d’action, pas un nœud déclencheur. Pour lancer un workflow à partir d’un événement du CRM, enregistrez un webhook sortant dans le panneau et recevez-le avec le nœud Webhook de n8n. Les webhooks se déclenchent notamment sur contact.created, contact.updated, message.received et deal.won, sont signés en HMAC-SHA256 dans un en-tête X-Webhook-Signature et sont relancés avec un délai croissant.
Dans Contact, Create, renseignez External ID avec un identifiant stable qui vous est propre pour cette personne, comme l’ID de l’envoi du formulaire ou l’ID client de votre boutique. Une deuxième création avec le même ID externe est refusée avec une erreur HTTP 409, et le corps de l’erreur indique l’ID du contact existant. Activez Continue On Fail pour qu’une relance signale la collision au lieu d’arrêter l’exécution.
Non. Il n’existe aucune opération d’envoi, de quelque nature que ce soit. L’envoi existe dans l’API REST et sur le serveur MCP, derrière des permissions comme telegram:send et social:write, mais il est volontairement exclu de ce nœud. Un workflow qui doit joindre une personne a besoin d’un nœud HTTP Request ou de l’un des nœuds de canal natifs de n8n.
La requête échoue avec une erreur HTTP 403 au lieu de sembler réussir. Chaque opération déclare l’unique permission dont elle a besoin : contacts:read pour les lectures, contacts:write pour la création, la modification et la suppression, deals:read et deals:write pour les opérations sur les affaires. Les permissions sont appliquées côté serveur : restreindre une clé est donc une vraie restriction, pas une simple indication.
Utilisez le filtre Updated Since de Contact, Get Many. Stockez l’horodatage de votre dernière exécution réussie, transmettez-le à la suivante, et l’API ne renvoie que les contacts modifiés à partir de cet instant. Combiné à Return All, c’est le socle d’une synchronisation incrémentale, et cela maintient une tâche nocturne sous la limite de débit par minute.
Oui, sous licence MIT sur GitHub, dans Pinlyx/n8n-nodes-pinlyx. Le nœud tient en un seul fichier TypeScript plus une définition d’identifiants : le lire de bout en bout prend quelques minutes et vous montre exactement quel point de terminaison appelle chaque opération.

Prêt à l’emploi

Intégrez votre CRM à vos workflows

Installez le nœud, générez une clé avec deux permissions et laissez le premier formulaire envoyé arriver sous forme de contact. Tout le reste se résume à glisser un nœud de plus sur le canevas.

Offre Free gratuite à vie · Conçu pour le RGPD · Sans carte bancaire