Ressources · Intégration n8n

Intégration Autopilot n8nAutomatiser Autopilot avec n8n.

Un contact qui bouge dans Autopilot ne devrait jamais être recopié à la main ailleurs. L'intégration Autopilot n8n donne accès à 11 opérations réparties sur 4 ressources, de la fiche contact à l'appartenance aux listes. Le trigger écoute 7 événements par webhook.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration Autopilot n8n ?

Deux nœuds livrés avec n8n, qui vont dans des sens opposés. Le nœud Autopilot appelle l'API d'Autopilot pour créer, lire, supprimer et classer des contacts, et pour gérer les listes sur lesquelles ils figurent : 11 opérations réparties entre Contact, Contact Journey, Contact List et List. Le trigger, lui, attend. n8n lui donne un webhook, c'est-à-dire une URL qu'Autopilot appelle tout seul, et chaque événement contact arrive dans le workflow en quelques secondes. Un seul credential pour les deux, une clé API générée une fois.

Premier réflexe, la collecte. Après un salon, les badges scannés finissent dans un fichier Google Sheets que personne n'ouvre. n8n lit le fichier ligne à ligne et lance contact.upsert : c'est l'adresse email qui tranche, Autopilot met à jour la fiche si elle existe, la crée sinon, et le champ List Name or ID range la personne sur la bonne liste dans le même appel. Aucun contrôle de doublon à écrire.

Deuxième réflexe, l'écoute. Quand un contact entre dans un segment, contactEnteredSegment se déclenche et le commercial concerné reçoit le détail dans son canal Slack, avec la fiche complète récupérée au passage par contact.get. Le désabonnement mérite le même traitement : contactUnsubscribed propage le statut partout où la personne pourrait encore recevoir un email, y compris côté SendGrid.

Troisième réflexe, l'hygiène des listes. Un prospect signe, le workflow appelle contactList.remove pour le sortir de la liste d'acquisition, puis contactJourney.add pour le faire entrer dans la séquence d'onboarding via le champ Trigger Name or ID. Personne n'a à s'en souvenir, et le client ne reçoit plus la relance qu'il a déjà convertie.

Deux points à connaître avant de construire. Tout ce qui sort des 11 opérations du catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Autopilot en réutilisant exactement le même credential via l'authentification prédéfinie. Et le changement de marque compte : Autopilot est devenu Ortto, les credentials et les nœuds Autopilot ne sont compatibles qu'avec Autopilot, pas avec la nouvelle API Ortto.

Si tu hésites encore à poser ton marketing sur cette plateforme, l'Avis n8n détaille l'hébergement et le modèle de coût, et la Formation n8n reprend la construction de ce type de workflow depuis la page blanche.

Connexion

Comment connecter Autopilot à n8n ?

  1. 01

    Générer la clé API dans Autopilot

    Il te faut d'abord un compte Autopilot. Une fois connecté, ouvre Settings > Autopilot API et génère une API Key. C'est la seule méthode d'authentification acceptée par le credential Autopilot : pas d'écran OAuth, pas de liste de droits à cocher. Copie la clé avant de quitter la page, elle part directement dans n8n à l'étape suivante.

  2. 02

    Créer le credential dans n8n

    Dans n8n, va dans le menu Credentials, ajoute un credential Autopilot et colle l'API Key dans son unique champ. Un credential, c'est un jeu d'identifiants enregistré une fois et réutilisé partout : la même entrée authentifie le nœud Autopilot et le trigger, sur n8n Cloud comme sur une instance auto-hébergée. Le deuxième workflow ne demande plus rien.

  3. 03

    Tester avec une opération de lecture

    Pose un nœud Autopilot sur le canevas et choisis le credential dans sa liste déroulante. Mets la ressource sur List et l'opération sur Get Many, puis exécute le nœud seul : si les listes du compte reviennent, la clé est bonne et le compte répond. Pas besoin d'attendre de tomber sur une erreur d'authentification au milieu d'un workflow de cinq nœuds pour le savoir.

Déclencheurs

Qu'est-ce qui déclenche un workflow Autopilot ?

Autopilot Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Autopilot. Il écoute 7 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Autopilot appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

contact.*7

    Notes de configuration

    01Set Up the Autopilot TriggerLe trigger, c'est le nœud qui démarre un workflow quand quelque chose se passe sur un contact. Il fonctionne par webhook : n8n expose une URL, Autopilot l'appelle, et l'événement arrive en quelques secondes. Rien n'est interrogé à intervalle régulier.

    Le trigger, c'est le nœud qui démarre un workflow quand quelque chose se passe sur un contact. Il fonctionne par webhook : n8n expose une URL, Autopilot l'appelle, et l'événement arrive en quelques secondes. Rien n'est interrogé à intervalle régulier.

    Paramètres clés

    • Event : le seul réglage du nœud. Tu choisis l'un des 7 événements contact, et lui seul réveille le workflow.
    Quand l'utiliser
    dès que le workflow doit réagir à Autopilot au lieu de l'interroger. L'URL du webhook est enregistrée à l'activation du workflow, donc un workflow de production reste actif et les exécutions manuelles servent uniquement aux tests. Pour écouter plusieurs événements, il faut un nœud trigger par événement : le paramètre Event ne propose pas de valeur fourre-tout. Et tant que le workflow n'est pas activé, une exécution manuelle ne reçoit rien, ce qui surprend souvent la première fois.
    02Contact Added and Contact UpdatedCes deux-là suivent la vie de la fiche elle-même. contactAdded part quand un contact apparaît dans Autopilot, quelle qu'en soit l'origine, et contactUpdated quand une fiche existante change.

    Ces deux-là suivent la vie de la fiche elle-même. contactAdded part quand un contact apparaît dans Autopilot, quelle qu'en soit l'origine, et contactUpdated quand une fiche existante change.

    Un détail appartient au nœud, pas au trigger : l'opération contact.upsert expose un champ Notify. Par défaut, Autopilot notifie les endpoints REST enregistrés pour les événements contact_added et contact_updated quand un contact est ajouté ou mis à jour via l'API. Désactive-le quand un workflow écrit dans Autopilot et que cette écriture ne doit pas en réveiller un autre.

    Paramètres clés

    • Event : réglé sur Contact Added ou Contact Updated. La valeur arrive dans le workflow sous la forme contactAdded ou contactUpdated.
    Quand l'utiliser
    pour l'accueil d'un nouveau contact et pour tenir un second outil à jour. Une création peut partir directement dans un tableur ou dans le canal de l'équipe commerciale. Une modification, c'est le bon moment pour relire la fiche et pousser les valeurs fraîches ailleurs.
    03Contact Added To List and Contact Removed From ListL'appartenance aux listes a sa propre paire d'événements. contactAddedToList se déclenche quand un contact rejoint une liste, contactRemovedFromList quand il en sort.

    L'appartenance aux listes a sa propre paire d'événements. contactAddedToList se déclenche quand un contact rejoint une liste, contactRemovedFromList quand il en sort.

    Paramètres clés

    • Event : Contact Added To List ou Contact Removed From List, un nœud trigger pour chacun.
    Quand l'utiliser
    quand c'est la liste qui intéresse le reste de l'entreprise, pas la fiche. Le marketing construit sa liste de lancement dans Autopilot, le workflow recopie chaque arrivée dans l'outil commercial ou dans un document partagé. La sortie est la moitié intéressante de la paire, parce que c'est celle que personne ne pense à annoncer. L'événement désigne la liste qui a bougé, donc le workflow peut brancher dessus au lieu de traiter tous les mouvements de la même façon. Couple-les avec contactList.getAll quand tu as besoin de l'état complet de la liste et pas seulement du contact qui vient de bouger.
    04Contact Entered Segment, Contact Left Segment and Contact UnsubscribedLes trois derniers événements parlent de comportement plutôt que de saisie. contactEnteredSegment et contactLeftSegment partent quand un contact entre dans un segment ou en sort, contactUnsubscribed quand quelqu'un se désabonne.

    Les trois derniers événements parlent de comportement plutôt que de saisie. contactEnteredSegment et contactLeftSegment partent quand un contact entre dans un segment ou en sort, contactUnsubscribed quand quelqu'un se désabonne.

    Paramètres clés

    • Event : Contact Entered Segment, Contact Left Segment ou Contact Unsubscribed.
    Quand l'utiliser
    les événements de segment sont ceux qu'une équipe commerciale attend vraiment, parce qu'entrer dans un segment veut dire que le contact a fait quelque chose. Route-les vers un canal ou une liste de tâches. Le désabonnement mérite son propre workflow : attrape-le, propage le statut vers tous les outils qui pourraient encore écrire à cette personne, et tu évites le cas où quelqu'un se désinscrit d'un côté et continue de recevoir des emails de l'autre. Les entrées et sorties de segment font aussi un bon journal : écris-les dans un tableur, et le marketing voit comment un segment s'est rempli sur un mois.
    Actions

    Que sait faire le nœud Autopilot ?

    Le nœud Autopilot expose 11 opérations sur 4 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

    Matrice ressources × opérations
    RessourceCreateGetGet ManyDeleteAddRemoveExistCreate or Update
    Contact✓✓✓✓
    Contact Journey✓
    Contact List✓✓✓✓
    List✓✓

    Contact

    4 opérations
    01

    Create or Update a contact

    contact.upsert

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Un seul appel couvre les deux cas, c'est le principe de l'upsert : si un contact existe déjà avec cette adresse email, Autopilot le met à jour, sinon il le crée. Un workflow de formulaire n'a donc rien à vérifier en amont.

    Paramètres clés

    • Email : l'adresse email du contact, le plus souvent {{ $json.email }} venue du nœud précédent. Le champ est requis : vide, il bloque l'exécution.
    • Additional Fields : une collection de 26 champs optionnels, dont First Name, Company, List Name or ID pour ranger le contact dès sa création, New Email pour changer l'adresse du contact identifié par Email.
    Cas d'usage
    une inscription au webinaire arrive dans Autopilot avec prénom, société et bonne liste, en un nœud.
    02

    Delete a contact

    contact.delete

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Supprime définitivement le contact d'Autopilot. À placer derrière une validation humaine plutôt que directement après un trigger.

    Paramètres clés

    • Contact ID : accepte l'identifiant ou l'adresse email. Cette souplesse compte, parce qu'une demande de suppression arrive presque toujours sous forme d'adresse tapée par quelqu'un : {{ $json.email }} suffit, sans recherche préalable.
    Cas d'usage
    une demande RGPD tombe dans la boîte partagée, le workflow en extrait l'adresse, supprime la fiche et consigne l'horodatage dans un journal pour garder la trace.
    03

    Get a contact

    contact.get

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Lit une fiche contact et la transmet au nœud suivant. C'est la lecture qu'on pose avant une décision : on récupère d'abord, on branche ensuite sur ce qui revient.

    Paramètres clés

    • Contact ID : identifiant ou adresse email, ce qui permet à un workflow qui ne détient que {{ $json.email }} de récupérer quand même la fiche entière.
    Cas d'usage
    avant d'alerter un commercial, le workflow va chercher le contact pour joindre société et téléphone au message, au lieu d'envoyer une adresse toute seule.
    04

    Get many contacts

    contact.getAll

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Ramène les contacts en lot plutôt qu'un par un. C'est l'opération des exports, des audits et des rapprochements planifiés.

    Paramètres clés

    • Return All : coché, n8n enchaîne les pages de l'API Autopilot jusqu'à ramener toute la base dans le workflow.
    • Limit : actif quand Return All est décoché, il fixe le nombre maximal de contacts renvoyés. Pratique tant que le workflow est en construction et que chaque test n'a pas besoin de tirer la base entière.
    Cas d'usage
    un export mensuel écrit la base dans un tableur pour repérer les fiches sans société ni prénom.

    Contact Journey

    1 opération
    05

    Add a contact journey

    contactJourney.add

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Fait entrer un contact dans un parcours choisi sur le nœud. C'est ainsi qu'un événement extérieur démarre une séquence Autopilot.

    Paramètres clés

    • Trigger Name or ID : l'identifiant de liste dont part le parcours. Choisis-le dans la liste déroulante, ou passe un identifiant par une expression quand la valeur est dynamique.
    • Contact ID : identifiant ou adresse email de la personne à inscrire.
    Cas d'usage
    une opportunité atteint une étape donnée dans le CRM et le workflow y inscrit le contact, donc la séquence démarre sur l'événement commercial au lieu d'attendre un import manuel.

    Contact List

    4 opérations
    06

    Add a contact to a list

    contactList.add

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Range un contact existant sur une liste. Contrairement à l'upsert, rien n'est créé ni modifié sur la fiche elle-même : seule l'appartenance change.

    Paramètres clés

    • List Name or ID : la liste sur laquelle opérer, choisie dans la liste déroulante ou passée en identifiant via une expression.
    • Contact ID : identifiant ou adresse email.
    Cas d'usage
    quelqu'un télécharge un guide et rejoint la liste dédiée à ce guide, pendant que la fiche contact reste exactement comme le commercial l'a laissée.
    07

    Check if a contact list exists

    contactList.exist

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Demande à Autopilot si un contact donné figure sur une liste donnée, et renvoie la réponse au workflow. C'est une lecture : rien ne bouge d'un côté ni de l'autre.

    Paramètres clés

    • List Name or ID : la liste à interroger.
    • Contact ID : le contact à chercher, par identifiant ou par email.
    Cas d'usage
    place-la devant un nœud IF pour que le message de bienvenue ne parte qu'aux personnes absentes de la liste, ce qui évite qu'une relance du workflow envoie deux fois le même email.
    08

    Get many contact lists

    contactList.getAll

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Renvoie les contacts présents sur une liste, la vue à prendre quand le sujet est la liste et pas l'individu.

    Paramètres clés

    • List Name or ID : la liste à lire, depuis la liste déroulante ou via une expression.
    • Return All : coché, n8n parcourt toute la liste ; décoché, Limit plafonne le nombre de contacts ramenés.
    Cas d'usage
    avant un envoi, le workflow récupère la liste cible et la compte, pour éviter de découvrir le jour J que le segment reposait sur un mauvais filtre.
    09

    Remove a contact from a list

    contactList.remove

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Sort un contact d'une liste sans toucher à sa fiche. C'est l'opération de correction : l'appartenance était fausse, elle redevient juste.

    Paramètres clés

    • List Name or ID : la liste que le contact doit quitter.
    • Contact ID : identifiant ou email de la personne à retirer.
    Cas d'usage
    un prospect devient client, le workflow le retire de la liste d'acquisition et il cesse de recevoir la séquence de relance le lendemain de sa signature.

    List

    2 opérations
    10

    Create a list

    list.create

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Crée une liste dans Autopilot depuis le workflow, utile quand les listes suivent un rythme : une par campagne, par événement, par mois.

    Paramètres clés

    • Name : le nom de la liste à créer. Construis-le avec une expression quand il doit porter une date ou un code campagne, comme ça toutes les listes sont nommées pareil sans que personne y pense.
    Cas d'usage
    un workflow planifié ouvre la liste du prochain webinaire et le formulaire d'inscription la remplit aussitôt, sans manipulation dans l'interface.
    11

    Get many lists

    list.getAll

    Ce que tu vois dans n8n

    Notes & cas d'usage

    Renvoie les listes qui existent dans le compte, avec leurs identifiants. C'est l'opération à lancer quand un nœud plus loin a besoin d'un identifiant de liste qu'il ne peut pas écrire en dur.

    Paramètres clés

    • Return All : coché, toutes les listes reviennent ; décoché, Limit fixe le maximum renvoyé.
    Cas d'usage
    le workflow récupère les listes, retrouve la bonne par son nom et injecte son identifiant dans contactList.add, ce qui le rend insensible à un renommage.
    Besoin d'aide

    Besoin d'aide pour automatiser Autopilot avec n8n ?

    L'équipe te répond directement.

    Chaque message est lu par une personne.

    FAQ

    Autopilot et n8n, les questions qui suivent

    01L'intégration Autopilot n8n est-elle gratuite ?
    Oui, côté n8n. Le nœud Autopilot et son trigger sont livrés avec n8n : rien à installer, aucun module à acheter, et c'est vrai sur n8n Cloud comme sur une instance auto-hébergée en Community Edition, sous licence Sustainable Use. Un workflow se comporte de la même façon dans les deux cas, donc tu peux prototyper sur le Cloud et déplacer le tout sur ton propre serveur ensuite. Ce que coûte le compte Autopilot lui-même est une autre question, qui n'est pas traitée ici. Pour démarrer, il te faut un compte Autopilot et une clé API, rien de plus.
    02Quels identifiants faut-il pour connecter Autopilot à n8n ?
    Une clé API, et c'est tout. Le credential Autopilot accepte une seule méthode d'authentification : une API Key que tu génères dans ton compte Autopilot, sous Settings puis Autopilot API. Tu crées le credential une fois dans le menu Credentials de n8n, et les deux nœuds le proposent ensuite dans leur liste déroulante, donc le deuxième workflow ne coûte plus rien à configurer. Attention au nom du produit. Autopilot est devenu Ortto, et les credentials comme les nœuds Autopilot ne sont compatibles qu'avec Autopilot, pas avec la nouvelle API Ortto : la clé doit venir du côté Autopilot.
    03Quelles sont les limites du nœud Autopilot dans n8n ?
    Le nœud couvre 11 opérations sur 4 ressources : Contact, Contact Journey, Contact List et List. Tout ce qui sort de cette liste passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Autopilot en réutilisant le même credential via l'authentification prédéfinie : tu n'es pas bloqué, tu construis l'appel toi-même. Sur les lectures, pense à la pagination. Get many contacts, Get many contact lists et Get many lists exposent tous Return All : décoché, Limit plafonne le résultat ; coché, n8n enchaîne les pages jusqu'à tout ramener.
    04Le trigger Autopilot réagit-il en temps réel ?
    Oui. Le trigger Autopilot fonctionne par webhook, c'est-à-dire une URL exposée par n8n qu'Autopilot appelle dès qu'il se passe quelque chose. n8n enregistre cette URL à l'activation du workflow, et chaque événement arrive en quelques secondes, sans interrogation régulière ni intervalle à régler. Le nœud n'a qu'un réglage, Event, et propose 7 événements contact : Contact Added, Contact Updated, Contact Added To List, Contact Removed From List, Contact Entered Segment, Contact Left Segment et Contact Unsubscribed. Aucune valeur fourre-tout n'est proposée, donc écouter plusieurs événements demande un nœud trigger par événement.
    05n8n ou Make pour Autopilot ?
    Ça dépend de l'endroit où tu veux que les données vivent et de la façon dont tu veux payer. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : un workflow qui synchronise une grosse base de contacts coûte donc plus cher à mesure qu'elle grandit. n8n tourne sur ton serveur via Docker ou npm, ou sur n8n Cloud si tu préfères ne rien administrer, et le workflow est identique dans les deux cas. Si les données contact doivent rester sur une infrastructure que tu maîtrises, la question est tranchée. Si tu veux un éditeur visuel sans rien à maintenir, Make répond bien.