Intégration Phantombuster n8nAutomatiser Phantombuster avec n8n.
Un agent qui tourne bien ne sert à rien si personne ne va chercher ce qu'il a produit. L'intégration Phantombuster n8n règle ce point avec un seul nœud : 5 opérations sur une ressource unique, Agent, et aucun déclencheur propre. Un autre point de départ lance le workflow, n8n met l'agent en file et récupère sa sortie.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration Phantombuster n8n ?
L'intégration Phantombuster n8n relie les agents que tu as déjà configurés dans Phantombuster, ces scripts qu'on appelle souvent des phantoms, à un workflow qui continue le travail une fois qu'ils ont fini. Le nœud dialogue avec l'API de Phantombuster et expose 5 opérations sur une seule ressource, Agent : lancer, lire, lister, récupérer la sortie du dernier passage, supprimer.
Premier cas, la collecte qui part toute seule. Un Schedule Trigger, le nœud n8n qui démarre un workflow à intervalle fixe, se déclenche au petit matin, agent.launch met l'agent en file, et un second passage sur agent.getOutput dépose les lignes dans Google Sheets. Plus personne n'ouvre la console Phantombuster pour appuyer sur un bouton.
Deuxième cas, le tri avant le CRM. La sortie d'un agent arrive en vrac : le workflow écarte les lignes sans adresse email, dédoublonne le reste, puis crée les fiches dans Salesforce. Le même passage poste un récapitulatif court dans Slack, histoire que l'équipe commerciale voie le lot arriver au lieu de le réclamer.
Troisième cas, plusieurs workflows qui se partagent le même agent. Max Instance Count ne lance l'agent que si le nombre d'instances déjà en cours reste sous le seuil que tu fixes. Combiné à agent.getAll, qui liste les agents de l'organisation, tu tiens un inventaire à jour sans passer par l'interface.
Le nœud HTTP Request prend le relais dès que l'opération dont tu as besoin ne fait pas partie des 5 listées ici. Il appelle n'importe quel endpoint de l'API Phantombuster en réutilisant le même credential, c'est-à-dire l'identifiant enregistré une fois dans n8n, via l'authentification prédéfinie.
Deux limites à connaître avant de construire. Phantombuster n'a pas de nœud trigger dans n8n, donc aucun workflow ne démarre parce qu'un agent vient de terminer : tu planifies la vérification, ou tu fais appeler un Webhook n8n, une URL qu'un service tiers déclenche, par autre chose dans ton installation. Et le nœud ne couvre que la ressource Agent, ce qui laisse la gestion fine des containers à HTTP Request. Si tu découvres la plateforme, l'Avis n8n dit ce qu'elle fait bien et où ça coince, et la Formation n8n reprend ces mécaniques dans l'ordre.
Comment connecter Phantombuster à n8n ?
- 01
Générer la clé API dans Phantombuster
Ouvre Workspace settings dans ton compte Phantombuster, va dans Third party API keys et clique sur Add API Key. La clé appartient au workspace, pas à une personne : elle donne accès aux agents de ce workspace et à rien d'autre. Copie-la au moment où elle s'affiche, c'est aussi depuis cet écran que tu la révoques si un workflow finit par la promener.
- 02
Enregistrer le credential dans n8n
Dans n8n, ouvre le menu Credentials et crée un credential PhantomBuster. Une seule méthode d'authentification est proposée, la clé API, et un seul champ à remplir : API Key. Une fois enregistré, il devient réutilisable : chaque nœud Phantombuster de chaque workflow le retrouve dans sa liste déroulante, et changer la clé plus tard tient en une modification.
- 03
Choisir l'agent dans le nœud
Pose le nœud Phantombuster dans un workflow, sélectionne le credential, puis la ressource Agent et l'opération voulue. La plupart des opérations affichent une liste déroulante Agent Name or ID que le nœud remplit en interrogeant ton compte. Si l'identifiant vient d'un nœud précédent, bascule le champ en expression, la syntaxe n8n qui lit une valeur de l'item entrant, du type
{{ $json.agentId }}.
Ce que le nœud Phantombuster sait faire
Le nœud Phantombuster expose 5 opérations sur 1 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Agent
5 opérationsDelete an agent
agent.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire un agent de l'organisation à partir de son identifiant. La suppression vaut côté Phantombuster, et l'agent disparaît des listes que le nœud charge pour les autres opérations.
Paramètres clés
- Agent Name or ID : pris dans la liste déroulante que le nœud remplit avec les agents de ton organisation, ou écrit en expression du type
{{ $json.agentId }}quand l'identifiant voyage avec l'item.
Get an agent
agent.getCe que tu vois dans n8n
Notes & cas d'usage
Lit un agent et renvoie ce que Phantombuster en sait, de son nom à sa configuration du moment. Utile juste avant un lancement, pour vérifier que la cible existe encore.
Paramètres clés
- Agent ID : ici un champ texte, pas une liste déroulante, donc la valeur se saisit à la main ou se construit par expression, par exemple
{{ $json.id }}depuis le nœud d'avant.
Get many agents
agent.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les agents de l'organisation du compte connecté. Chaque agent ressort comme un item distinct, ce qui en fait un bon premier nœud quand la suite du workflow boucle dessus.
Paramètres clés
- Return All : activé, n8n enchaîne les pages de l'API et ramène tous les agents de l'organisation.
- Limit : le plafond qui s'applique quand Return All reste désactivé, le workflow ne voit alors que les premiers agents.
Get the output of an agent
agent.getOutputCe que tu vois dans n8n
Notes & cas d'usage
Récupère ce qu'a produit le container le plus récent d'un agent. Un container correspond à une exécution : c'est par là qu'un workflow relit le résultat d'un passage mis en file plus tôt.
Paramètres clés
- Agent Name or ID : l'agent dont tu veux le dernier passage.
- Resolve Data : désactivé, la sortie arrive sous forme de chaîne de caractères ; activé, n8n résout les données et le nœud suivant reçoit des champs exploitables.
- Prev Container ID : renvoie la sortie du container qui suit celui que tu désignes, pour ne pas relire le même passage.
Add an agent to the launch queue
agent.launchCe que tu vois dans n8n
Notes & cas d'usage
Met un agent en file d'attente de lancement. Phantombuster répond avec l'identifiant du container créé, la prise que le nœud suivant utilise pour aller lire la sortie.
Paramètres clés
- Agent Name or ID : l'agent à lancer, choisi dans la liste ou résolu par expression.
- Arguments et Arguments (JSON) : l'argument de l'agent, saisi champ par champ ou en JSON, que son script relit avec buster.argument.
- Bonus Argument : une valeur à usage unique, fusionnée avec l'argument d'origine pour ce seul lancement.
- Max Instance Count : ne lance l'agent que si le nombre d'instances en cours reste sous la valeur indiquée.
Besoin d'aide pour automatiser Phantombuster avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
