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.
Nœud n8n
Offre BusinessInstallez 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:
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.
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.
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.
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.
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.
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.
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.
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.
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.
Ou, sur une instance auto-hébergée, en ligne de commande :
npm install n8n-nodes-pinlyx
# then restart n8nUne 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.
Le nœud s’authentifie avec une clé API Pinlyx : une clé, un en-tête, aucun aller-retour OAuth.
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.
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.
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.
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.
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.
À 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.
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.
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.
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.
Trois comportements qui déterminent si un workflow survit à sa première vraie semaine.
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
Six points qu’il vaut mieux lire ici que découvrir au beau milieu de la construction d’un workflow.
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.
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.
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.
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.
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.
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é.
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.
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.
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é.
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.
Les questions qui se posent dès la première heure, avec des réponses fondées sur le comportement réel.
Les autres accès aux mêmes données, et les parties du CRM dans lesquelles un workflow va écrire.
La couche sous le nœud : clés à permissions, pagination par curseur, écritures idempotentes, en-têtes de limite de débit et webhooks sortants.
Le même CRM pour un assistant IA plutôt que pour un workflow : des outils, des ressources et des prompts sur un seul point de terminaison authentifié.
Un pas-à-pas pour développeurs : génération des clés, première requête authentifiée, vérification de la signature des webhooks et gestion des limites de débit.
Quand un assistant doit décider au moment de l’appel, quand écrire du code, et quand un déclencheur sans code est la bonne réponse.
Gmail, Outlook, Calendly, Zoom, GitHub et les webhooks sortants qui relient le CRM à tout le reste.
Ce que contient réellement une fiche contact : étiquettes, champs personnalisés, scoring, responsable et historique complet des activités.
Le pipeline dans lequel écrivent les opérations Deal, et pourquoi la transition vers gagné enregistre un chiffre d’affaires et reste dans le panneau.
La comparaison des offres, dont l’offre Business qui inclut les clés API et les webhooks, et le serveur MCP disponible avec toutes les offres.
Prêt à l’emploi
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.