Intégration Keap n8nAutomatiser Keap avec n8n.

Crée une société dans Keap, l'objet auquel tu rattaches ensuite des contacts et des commandes quand tu vends à des organisations plutôt qu'à des particuliers.

• Company Name : le seul champ obligatoire, souvent alimenté par {{ $json.company }} depuis un formulaire.
• Addresses, Phones et Faxes : des collections distinctes, à remplir ligne par ligne plutôt que dans une seule zone de texte.
• Additional Fields : regroupe Email, Website, Notes et Opt In Reason, plus l'adresse détaillée dont le Country Code au format ISO Alpha-3.

Sort la liste des sociétés de Keap, entière ou filtrée, et renvoie un item par société pour la suite du workflow.

• Return All : coché, n8n enchaîne les pages jusqu'à épuiser l'API ; décoché, il s'arrête à Limit.
• Company Name : restreint la requête aux sociétés qui portent ce nom.
• Order et Order Direction : tri sur datecreated, id ou name, croissant ou décroissant.
• Fields : liste de propriétés séparées par des virgules à réintégrer dans la réponse, puisque les notes, le numéro de fax et les champs personnalisés en sont absents par défaut.

Un seul appel qui crée le contact ou met à jour celui qui existe déjà, sans avoir à traiter les doublons après coup.

• Duplicate Option : obligatoire. Email compare la seule adresse, Email And Name exige que l'adresse et le nom correspondent pour que Keap considère qu'il s'agit de la même personne.
• Emails, Phones, Addresses et Social Accounts : des collections, chaque entrée étant typée par Field ou Type.
• Additional Fields : 17 champs, dont Given Name, Family Name, Job Title, Owner Name or ID, Company ID et Source Type.

Supprime un contact de Keap. Le nœud ne demande aucune confirmation : ce qui arrive en entrée est effacé.

• Contact ID : obligatoire, l'identifiant Keap et pas l'adresse email. Il vient en général d'une recherche placée juste avant, sous la forme {{ $json.id }}.

Récupère une fiche contact à partir de son identifiant et la renvoie en un item, prêt à être lu par les expressions des nœuds suivants.

• Contact ID : obligatoire, l'identifiant numérique de la personne dans Keap.
• Fields : liste de propriétés à inclure, séparées par des virgules, car l'identifiant de source du lead, les champs personnalisés et la fonction ne remontent pas par défaut.

Parcourt la base de contacts page après page, avec des filtres qui rendent le résultat exploitable plutôt qu'énorme.

• Return All : coché pour un export complet, décoché pour plafonner à Limit.
• Since et Until : une fenêtre de dates appliquée à la dernière mise à jour, ce qui transforme l'export en synchronisation incrémentale.
• Email, Given Name, Family Name : les filtres pour retrouver une personne précise.
• Order et Order Direction : tri sur date, email, id ou name.

Inscrit une note dans l'historique d'un contact, celle que le commercial relit avant de décrocher son téléphone.

• Contact ID : la personne à qui la note se rattache.
• User Name or ID : l'utilisateur Infusionsoft au nom duquel la note est créée, à prendre dans la liste ou à fournir par expression.
• Additional Fields : Title, Body, et Type parmi appointment, call, email, fax, letter et other.

Retire définitivement une note de l'historique. Le reste de la fiche contact n'est pas touché.

• Note ID : obligatoire, l'identifiant de la note elle-même, à ne pas confondre avec celui du contact. Passe par contactNote.getAll si tu ne connais que la personne concernée.

Renvoie une note et son contenu, ce qui permet à un workflow de lire ce qui a été écrit avant de décider de la suite.

• Note ID : obligatoire, et c'est la seule entrée de l'opération.

Liste les notes sur l'ensemble des contacts, ou se concentre sur l'historique d'une seule personne dès que tu poses un filtre.

• Return All : coché pour dérouler toutes les pages, décoché pour s'arrêter à Limit.
• Contact ID : ne garde que les notes rattachées à ce contact.
• User Name or ID : ne garde que les notes créées au nom de cet utilisateur.

Modifie une note existante au lieu d'en empiler une seconde à côté. Seuls les champs renseignés sont remplacés.

• Note ID : obligatoire, la note à réécrire.
• Additional Fields : Title, Body, Type, Contact ID pour déplacer la note vers une autre personne, et User Name or ID.

Pose un ou plusieurs tags sur un contact en un appel. Les tags pilotent la segmentation dans Keap, c'est souvent la dernière étape d'un workflow de capture.

• Contact ID : obligatoire, la personne à taguer.
• Tag Names or IDs : obligatoire, une sélection multiple qui permet d'appliquer plusieurs tags d'un coup, ou une expression quand les identifiants sont calculés en amont.

Enlève un tag d'un contact, sans toucher ni à la fiche ni à la définition du tag.

• Contact ID : obligatoire.
• Tag IDs : obligatoire, et ici c'est un champ texte libre, pas le sélecteur utilisé à l'ajout.

Répond à la question que finit par poser tout workflow d'aiguillage : avec quels tags ce contact est-il actuellement marqué ?

• Contact ID : obligatoire, puisque les tags se lisent toujours contact par contact.
• Return All : coché pour obtenir la liste complète, décoché pour s'arrêter à Limit.

Enregistre une commande dans Keap, avec ses lignes et son adresse de livraison, pour que le chiffre d'affaires et le cycle de vie client vivent au même endroit.

• Contact ID, Order Date, Order Title et Order Type : tous obligatoires, le type valant online ou offline.
• Order Items : une collection où chaque ligne porte Product ID, Quantity, Description et un Price facultatif qui prend le pas sur le prix du catalogue.
• Shipping Address et Promo Codes, ces derniers séparés par des virgules pour que la remise correspondante s'applique.

Récupère une commande et son détail, l'appel que tu fais quand un webhook te donne une référence de commande et rien d'autre.

• Order ID : obligatoire, et c'est le seul champ à remplir.

Efface une commande de Keap. À réserver aux cas limites, puisque la commande porte aussi l'historique de chiffre d'affaires.

• Order ID : obligatoire, l'identifiant de la commande à retirer.

Balaie les commandes avec les filtres qui comptent pour le suivi : une fenêtre de dates, le statut de paiement, un client ou un produit.

• Return All : coché pour tout dérouler, décoché pour plafonner à Limit.
• Since et Until : la période sur laquelle chercher.
• Paid : un booléen qui sépare les commandes réglées du reste.
• Contact ID et Product ID : pour se limiter à un client ou à un article.

Inscrit un produit au catalogue Keap pour que les commandes puissent ensuite le référencer par son identifiant.

• Product Name : le seul champ obligatoire.
• Additional Fields : SKU, Product Price, Product Description et Product Short Desc, plus deux booléens, Active pour la visibilité et Subscription Only pour les articles vendus en abonnement.

Sort définitivement un produit du catalogue Keap, qui ne pourra plus être référencé dans une nouvelle ligne de commande.

• Product ID : obligatoire, l'identifiant du catalogue et non le SKU utilisé côté boutique.

Consulte un produit précis et renvoie sa fiche catalogue, prix et description compris. L'opération ne prend qu'un identifiant et ne modifie rien dans le catalogue.

• Product ID : obligatoire, l'identifiant Keap de l'article.

Déroule le catalogue et restitue les produits sous forme d'items, ce qui transforme Keap en liste de référence pour la suite du workflow.

• Return All : coché pour récupérer tout le catalogue, décoché pour s'arrêter à Limit.
• Active : un filtre booléen qui ne garde que les produits encore commercialisés.

Rien n'est envoyé ici : l'opération écrit dans Keap la trace d'un email parti d'ailleurs, pour que l'historique du contact reste complet.

• Sent To Address : l'adresse du destinataire, requise, souvent {{ $json.email }} repris du nœud précédent.
• Sent From Address : l'adresse d'expédition, requise elle aussi.
• Contact ID : dans Additional Fields, l'identifiant numérique du contact Keap auquel la trace se rattache.
• Original Provider : dans Additional Fields, au choix UNKNOWN, INFUSIONSOFT, MICROSOFT ou GOOGLE, à combiner avec Original Provider ID, que Keap génère en UUID sans tirets si tu le laisses vide.

L'opération ressort les emails déjà envoyés depuis Keap, un item par message, prêts à être comptés ou filtrés dans la suite du workflow.

• Return All : coché, n8n enchaîne toutes les pages de l'API Keap ; décoché, Limit fixe le nombre d'emails ramenés.
• Contact ID : dans Filters, restreint la liste aux emails d'un seul contact.
• Email : dans Filters, une adresse du type name@email.com quand tu n'as pas l'identifiant sous la main.
• Since Sent Date et Until Sent Date : la fenêtre de dates ; la date de début doit être renseignée dès que tu remplis la date de fin.

Cette fois, c'est Keap qui expédie, au nom d'un de ses utilisateurs. Le message reste rattaché à cette identité côté Keap.

• User Name or ID : requis, l'utilisateur Infusionsoft pour le compte duquel part l'email ; tu le choisis dans la liste ou tu passes un identifiant par une expression.
• Contact IDs : les destinataires, séparés par des virgules s'il y en a plusieurs.
• Subject : l'objet, à accompagner de HTML Content ou Plain Content dans Additional Fields, tous deux encodés en Base64.
• Attachments : 10 pièces jointes au maximum par copie, 1MB chacune, remplies via File Name et File Data ou lues dans une Property binaire.

Un fichier quitte définitivement la bibliothèque Keap. Le nœud prend son identifiant, renvoie le résultat, et s'arrête là.

• File ID : requis, l'identifiant du fichier à supprimer, en général {{ $json.id }} récupéré à l'étape de listing juste avant.

Pour parcourir la bibliothèque de fichiers Keap depuis un workflow, tout part de cette opération : chaque fichier revient en item séparé, filtres compris.

• Return All : activé, toutes les pages de fichiers sont récupérées ; sinon Limit arrête la liste.
• Name : dans Filters, une recherche par nom où * placé avant ou après le texte déclenche une requête LIKE.
• Type : dans Filters, la catégorie du fichier, de attachment et image jusqu'à webform ou digitalProduct.
• Permission et Viewable : user, company ou both d'un côté, public, private ou both de l'autre.

Un devis signé, une facture PDF générée plus haut dans le workflow : le fichier est déposé dans Keap et rattaché à une fiche.

• Input Binary Field : requis, le nom du champ binaire entrant qui porte le fichier ; Binary File indique au nœud d'y lire les données.
• File Association : requis, company, contact ou user, avec Contact ID pour désigner la fiche visée.
• File Name : requis, extension comprise, Keap conserve le nom tel quel.
• File Data : requis, le contenu encodé en Base64, Is Public réglant la visibilité.