Intégration Intercom n8nAutomatiser Intercom avec n8n.

Inscrit une nouvelle société dans Intercom et transmet la fiche créée au nœud suivant.

• Company ID : l'identifiant de société que tu as défini de ton côté, celui sur lequel tu relanceras tes recherches plus tard.
• Industry, Size, Plan : des Additional Fields pour le secteur d'activité de la société, son nombre d'employés et le nom du plan que tu lui as associé.
• Website : l'URL du site de la société. La valeur n'est pas validée, n'importe quelle chaîne est acceptée : nettoie-la avant l'envoi.

Va chercher une société précise et la remet au reste du workflow.

• Select By : la propriété utilisée pour interroger la société, au choix companyId, id ou name. Prends celle que tes autres outils stockent vraiment.
• Value : requis, la valeur recherchée, qui doit correspondre au Select By choisi. Depuis un nœud précédent, ça s'écrit avec une expression du type {{ $json.field }}.

Renvoie les sociétés sous forme de liste, un item n8n par société.

• Return All : coché, n8n enchaîne les pages de l'API jusqu'à la dernière société. Décoché, il s'arrête à Limit, le nombre maximal de résultats renvoyés.
• Segment ID et Tag ID : les deux Filters, pour ne garder que les sociétés d'un segment ou portant une étiquette donnée.

Modifie une société déjà enregistrée, plutôt que d'en empiler une seconde.

• Company ID : l'identifiant de société que tu as défini, qui sert ici à retrouver la fiche à modifier.
• Custom Attributes : un ensemble de paires clé et valeur pour les données personnalisées que tu veux rattacher, à remplir attribut par attribut avec Add Attribute.
• Plan et Size : des Additional Fields pour le nom du plan associé et le nombre d'employés.

Liste les utilisateurs rattachés à une société. C'est la seule opération qui relie deux objets entre eux.

• List By : id pour l'identifiant défini par Intercom, ou companyId pour celui que tu as donné à la société.
• Value : requis, l'identifiant qui correspond au List By retenu.
• Return All : coché pour tous les utilisateurs du compte, décoché pour s'arrêter à Limit.

Ajoute un lead, la fiche qu'Intercom tient pour quelqu'un qui n'est pas encore utilisateur.

• Email : requis, l'email de la personne, au format name@email.com.
• Name et Phone : des Additional Fields pour le nom et le numéro de téléphone.
• UTM Campaign, UTM Medium, UTM Term : la campagne d'origine, le type de lien utilisé et les termes de recherche.

Retire une fiche lead d'Intercom. Aucun retour arrière n'existe dans le workflow, donc la branche qui précède compte autant que l'opération.

• Delete By : id pour l'identifiant défini par Intercom pour ce lead, ou userId pour l'identifiant généré automatiquement.
• Value : requis, la valeur à supprimer, alignée sur la propriété choisie juste avant.

Lit un seul lead pour que le workflow décide quoi en faire.

• Select By : la propriété de sélection du lead, parmi email, id, userId et phone. Quatre entrées, ce qui aide quand chaque outil garde une clé différente.
• Value : requis, la valeur recherchée pour la propriété retenue.

Ramène une liste de leads, un item par fiche.

• Return All : coché pour parcourir l'ensemble, décoché pour plafonner avec Limit.
• Email et Phone : les deux Filters, l'adresse email du lead et son numéro de téléphone, pour restreindre le tirage au lieu de trier après coup.

Met à jour un lead déjà présent, ce qui évite la fiche en double.

• Update By : la propriété d'interrogation du lead, userId ou id.
• Value : requis, la valeur de cette propriété pour le lead à modifier.
• Unsubscribed From Emails et Company Names or IDs : des Additional Fields pour l'état de désinscription aux emails et les sociétés auxquelles la personne appartient.

Crée la fiche qu'Intercom tient pour un client identifié.

• Identifier Type : userId, un identifiant unique requis à la création si aucun email n'est fourni, ou email, requis à la création si aucun user_id ne l'est.
• Value : requis, la valeur de cet identifiant unique.
• Name, Phone, Session Count, Company Names or IDs : quelques-uns des 14 Additional Fields, dont le nombre de sessions enregistrées pour cette personne.

Supprime une fiche utilisateur. C'est l'opération la plus courte du nœud, et celle qu'on câble en dernier.

• ID : requis, l'identifiant défini par Intercom pour cette fiche. C'est le seul champ, donc le workflow doit déjà le tenir, en général via une lecture antérieure passée sous la forme {{ $json.field }}.

Récupère un utilisateur et met sa fiche à disposition de tous les nœuds en aval.

• Select By : la propriété de sélection, id pour l'identifiant défini par Intercom ou userId pour l'identifiant généré automatiquement.
• Value : requis, la valeur à consulter. Le champ attend un identifiant, pas un nom : c'est la confusion la plus fréquente ici.

Renvoie les utilisateurs en liste, avec le jeu de filtres le plus large du nœud.

• Return All : coché pour enchaîner les pages, décoché pour s'arrêter à Limit.
• Company ID, Email, Segment ID, Tag ID : les 4 Filters, respectivement la société rattachée, l'adresse email, le segment et l'étiquette.

Réécrit des champs sur un utilisateur existant. C'est l'opération sur laquelle finissent la plupart des workflows.

• Update By : la propriété d'interrogation, id, email ou userId.
• Value : requis, la valeur de cette propriété pour l'utilisateur à modifier.
• Update Last Request At : indique à Intercom de mettre à jour la valeur last_request_at de l'utilisateur à l'heure courante du service API, en UTC.