Connecter Intercom à n8n : qualifier les leads et automatiser les conversations avec l'IA

Intercom concentre souvent trois usages à la fois — chat en direct, base de leads marketing et support client — sans qu'aucun de ces flux ne communique naturellement avec le reste de la pile (CRM, Slack, base documentaire). Un lead qui démarre une conversation dans le widget Intercom reste une ligne isolée dans Intercom tant que personne ne la recopie ailleurs à la main. Connecter Intercom à n8n comble cet écart : un lead entrant peut être scoré et poussé vers le CRM en quelques secondes, une conversation non résolue peut remonter dans un digest Slack, et un contact peut être enrichi automatiquement avant même qu'un commercial ne le contacte. Ce guide couvre l'authentification, les ressources réelles du node, le déclenchement d'un workflow (Intercom n'a pas de trigger natif dans n8n), puis trois cas d'usage concrets.

Authentification : l'Access Token via le Developer Hub

Le node Intercom de n8n s'authentifie avec un Access Token, généré non pas dans les paramètres classiques du compte mais dans le Developer Hub d'Intercom :

1. Sur developers.intercom.com, créez (ou ouvrez) une app dans votre workspace.
2. Dans l'onglet Authentication, générez un Access Token — Intercom le crée automatiquement à la création de l'app.
3. Dans n8n, créez un credential Intercom API et collez ce token.

Ce token porte les permissions accordées à l'app (lecture/écriture des contacts, des companies, des conversations…) : donnez-lui uniquement les scopes dont vos workflows ont réellement besoin, plutôt qu'un accès complet par défaut. Comme pour tout token à privilèges larges, créez l'app sur un compte technique dédié plutôt que sur le compte d'un employé, pour que l'automatisation survive à son départ.

Les ressources du node Intercom

Le node couvre trois ressources, chacune avec les opérations Create, Update, Get, Get Many et Delete :

• Lead — un visiteur anonyme ou non authentifié qui a interagi avec Intercom (widget de chat, formulaire) sans encore être rattaché à un compte utilisateur identifié.
• User — un contact déjà associé à un compte connu dans votre produit, généralement identifié par son user_id ou son email.
• Company — l'organisation commerciale à laquelle un Lead ou un User peut être rattaché ; en plus des cinq opérations standards, la ressource Company expose une opération Users qui liste tous les contacts associés à une entreprise donnée.

Chaque ressource accepte des attributs personnalisés (custom attributes) en plus des champs standards (nom, email, téléphone, avatar, paramètres UTM de la première visite), ce qui permet d'écrire un score de qualification, une catégorie ou tout autre champ métier directement sur la fiche.

Un point utile à connaître avant de concevoir un workflow : Intercom a fusionné ses anciennes API Leads et Users dans une API Contacts unifiée il y a plusieurs années, mais le node n8n a été construit avant cette évolution et garde Lead et User comme deux ressources distinctes (une consolidation vers une ressource Contact unique est en cours de revue dans le dépôt n8n). En pratique, cela ne change rien à l'usage : choisissez Lead pour un visiteur pas encore identifié, User pour un contact déjà lié à un compte, et les deux retombent côté Intercom sur le même objet contact.

Déclencher un workflow depuis Intercom

Il n'existe pas de node Intercom Trigger dans n8n. Le déclenchement en temps réel passe par les webhooks natifs d'Intercom, configurés depuis la même app du Developer Hub que le token :

1. Dans l'app Intercom, onglet Webhooks, ajoutez l'URL d'un node Webhook n8n (en POST).
2. Abonnez-vous aux topics pertinents — par exemple conversation.user.created (nouvelle conversation ouverte par un contact), conversation.admin.replied (réponse d'un agent), ou contact.lead.created (nouveau lead capté par le widget).
3. Chaque événement souscrit arrive en POST sur le webhook n8n, avec le payload complet de l'objet concerné.

Sans app Intercom configurée pour les webhooks, l'alternative est un polling léger : un Schedule Trigger toutes les cinq à dix minutes suivi d'un Intercom → Lead/User → Get Many, filtré sur les contacts mis à jour depuis le dernier passage.

Cas d'usage 1 — Scoring et qualification automatique des nouveaux leads

Le webhook contact.lead.created déclenche un node AI Agent avec un Structured Output Parser, qui analyse le message initial du lead (et, si disponible, sa page de provenance ou ses paramètres UTM) pour produire un score de qualification et une catégorie. Le résultat est réécrit sur la fiche via Intercom → Lead → Update (en attribut personnalisé), et un node IF route les leads chauds vers une alerte Slack immédiate. Le barème de scoring, les exemples de prompt et la boucle de feedback pour affiner le modèle sont détaillés dans notre guide sur la qualification automatique des leads entrants avec l'IA — le pipeline y est décrit pour un formulaire générique, transposable tel quel à un webhook Intercom.

Cas d'usage 2 — Synchronisation Intercom vers le CRM

Un lead qualifié dans Intercom ne devient utile à l'équipe commerciale que s'il atterrit dans le CRM. Après le scoring, un node HubSpot ou Pipedrive recherche le contact par email (pour éviter les doublons), puis crée ou met à jour la fiche avec le score, la catégorie et le lien vers la conversation Intercom d'origine. Cette logique de recherche-avant-création, la gestion des champs personnalisés et le traitement des rate limits sont couverts en détail dans notre guide de synchronisation CRM avec n8n.

Cas d'usage 3 — Digest quotidien des conversations en attente

Un Schedule Trigger quotidien déclenche un appel HTTP Request vers GET /conversations (filtré sur les conversations ouvertes et non assignées), suivi d'un node AI Agent qui résume les sujets dominants, repère les conversations en attente depuis plus de X heures et signale les messages au ton négatif. Le résultat part vers un canal Slack, sur le modèle du digest quotidien du Pack Inbox IA (79 €) — la même architecture (agrégation, synthèse IA, envoi Slack), appliquée à un flux de conversations plutôt qu'à une boîte mail.

Un point de vigilance sur les délais de réponse mérite d'être cité : une étude d'Ulrich Gnewuch, Stefan Morana, Marc T. P. Adam et Alexander Mädche, Opposing Effects of Response Time in Human–Chatbot Interaction, publiée en 2022 dans Business & Information Systems Engineering, montre que l'effet d'un temps de réponse rapide n'est pas toujours positif : au-delà d'un simple accusé de réception automatique, une réponse trop instantanée peut paraître moins humaine et réduire la confiance perçue, alors qu'un délai modéré et cohérent avec la complexité de la question améliore la satisfaction. Pour un digest ou un brouillon de réponse généré par IA, cela plaide pour laisser un agent relire et publier lui-même plutôt que d'automatiser la réponse instantanée de bout en bout.

Limites et bonnes pratiques

Le node natif ne couvre ni les conversations ni les tags associés aux contacts : tout ce qui touche à /conversations, /tags ou /notes passe par un node HTTP Request réutilisant le credential Intercom API — le réflexe standard pour toute opération absente d'un node natif. Sur un workflow qui traite des lots (synchronisation, enrichissement), surveillez les en-têtes X-RateLimit-Remaining renvoyés par l'API et ajoutez un nœud Wait ou une logique de retry, comme détaillé dans notre guide sur les erreurs 429 et le rate limiting. Et comme pour tout workflow qui touche des données client en production, prévoyez un Error Workflow dédié pour ne jamais perdre silencieusement un lead suite à une erreur d'API.

En résumé

Connecter Intercom à n8n tient en un Access Token généré via le Developer Hub, trois ressources bien couvertes par le node natif (Lead, User, Company), un détour par HTTP Request pour les conversations, et un déclenchement par webhooks Intercom plutôt qu'un trigger natif. Cette architecture — webhook, scoring IA, écriture CRM et digest Slack — est exactement celle du Pack Inbox IA (79 €) ; si vos leads Intercom doivent aussi alimenter une base documentaire ou un chatbot RAG, le Pack Assistant RAG (119 €) et le Bundle FlowKit Complet (269 € au lieu de 347 €) couvrent l'ensemble du pipeline.