Ressources · Intégration n8n

Intégration Tapfiliate n8nAutomatiser Tapfiliate avec n8n.

Recopier un partenaire à la main dans un tableau de bord d'affiliation, c'est du temps perdu deux fois. L'intégration Tapfiliate n8n est livrée dans n8n et ouvre 12 opérations réparties sur 3 ressources : les affiliés, les métadonnées qu'on leur accroche, et leur place dans un programme.

Tester l'intégration Tapfiliate sur n8nVoir les 12 opérations

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

Pourquoi automatiser

À quoi sert vraiment l'intégration Tapfiliate n8n ?

Tapfiliate héberge tes affiliés, leurs coordonnées et les programmes auxquels ils appartiennent. Le nœud n8n dialogue avec ce compte via l'API Tapfiliate et donne trois prises à un workflow, c'est-à-dire à une suite d'étapes automatisées : la fiche de l'affilié, les métadonnées libres posées dessus, et le lien entre un affilié et un programme. Douze opérations, trois ressources, et aucune écoute d'événement côté Tapfiliate.

Le recrutement de partenaires arrive en premier, parce que c'est là que la saisie s'accumule. Un formulaire de candidature envoie un nom et un email dans le workflow, affiliate.create crée la fiche, puis programAffiliate.add range l'affilié dans le bon programme avec le champ Approved et, si la campagne en utilise un, un Coupon. Un email de bienvenue part dans la foulée avec Gmail, sans que personne n'ouvre le back-office.

Deuxième usage : garder le contexte que Tapfiliate ne stocke pas. Une métadonnée, c'est une clé et une valeur, de quoi noter d'où vient un partenaire ou qui le suit en interne. affiliateMetadata.add l'écrit à l'inscription, affiliateMetadata.update la corrige plus tard, et la fiche du partenaire reste alignée avec son contact dans Pipedrive, là où l'équipe commerciale travaille au quotidien.

Troisième usage, le reporting. Un affiliate.getAll filtré sur Affiliate Group ID ou un programAffiliate.getAll sur un programme précis alimente un onglet Google Sheets que tout le monde consulte. Côté boutique, une commande WooCommerce porte un code de parrainage : le filtre Referral Code retrouve le partenaire correspondant, et programAffiliate.get confirme qu'il appartient bien au programme de la campagne.

Si un point d'entrée de l'API Tapfiliate ne figure pas dans ces 12 opérations, le nœud HTTP Request l'appelle directement et réutilise le même credential grâce à l'authentification prédéfinie. Rien à reconstruire, la clé reste gérée au même endroit.

Deux contraintes cadrent la conception. Tapfiliate n'a pas de nœud trigger dans n8n, autrement dit pas de déclencheur maison : le workflow démarre sur un Schedule Trigger à intervalle fixe, sur un Webhook n8n appelé par un service tiers, ou sur le trigger d'un autre outil. Ensuite, sur les deux opérations de liste, Return All enchaîne les pages de l'API jusqu'au dernier affilié, alors que désactivé il s'arrête à Limit. L'Avis n8n détaille ce que coûtent ces exécutions selon l'hébergement.

Connexion

Comment brancher Tapfiliate sur n8n ?

  1. 01

    Récupérer la clé API dans Tapfiliate

    Le nœud s'authentifie avec une seule clé API, et cette clé se trouve dans ton compte Tapfiliate, pas dans n8n. Ouvre Profile Settings dans l'application Tapfiliate, puis l'entrée API Key. Tapfiliate publie aussi un article d'aide sur l'emplacement de l'account ID et de la clé API, pratique si le menu a bougé depuis ta dernière visite. Garde la valeur sous la main.

  2. 02

    Créer le credential dans n8n

    Dans n8n, ouvre le menu Credentials et ajoute un credential Tapfiliate, c'est-à-dire un jeu d'identifiants enregistré une fois pour toutes. Le nœud ne propose aucun sélecteur d'authentification, donc le formulaire demande le champ API Key et rien de plus. Colle la valeur, enregistre. Tous les workflows de l'instance retrouveront ce credential dans une liste déroulante.

  3. 03

    Choisir une ressource et une opération

    Pose le nœud Tapfiliate sur le canevas. Il te propose le credential enregistré, puis demande la ressource, Affiliate, Affiliate Metadata ou Program Affiliate, et l'opération à l'intérieur. Les champs de programme se remplissent depuis une liste lue dans ton compte : tu choisis le programme par son nom au lieu de chercher son identifiant. Lance le nœud une fois avec une vraie valeur pour voir ce qui revient.

Actions

Ce que le nœud Tapfiliate sait faire

Le nœud Tapfiliate expose 12 opérations sur 3 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 ManyUpdateDeleteAddRemoveApproveDisapprove
Affiliate✓✓✓✓
Affiliate Metadata✓✓✓
Program Affiliate✓✓✓✓✓

Affiliate

4 opérations
01

Create an affiliate

affiliate.create

Ce que tu vois dans n8n

Notes & cas d'usage

Inscrit un nouvel affilié dans le compte Tapfiliate et remet la fiche créée au workflow.

Paramètres clés

  • Email : l'email de l'affilié, au format name@email.com, le plus souvent repris du nœud précédent avec {{ $json.field }}.
  • First Name et Last Name : le prénom et le nom de l'affilié, les deux requis, donc une valeur vide venue du formulaire bloque l'exécution.
  • Additional Fields : Company Name pour les données d'entreprise de l'affilié, et Address, qui se remplit dans son propre sous-formulaire.
Cas d'usage
un partenaire remplit une candidature et sa fiche existe avant que quiconque ouvre la boîte mail.
02

Delete an affiliate

affiliate.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un affilié du compte. Un identifiant, rien d'autre : c'est un nœud de fin de parcours, pas quelque chose qu'on appelle à la légère.

Paramètres clés

  • Affiliate ID : l'identifiant de l'affilié, requis, donc la branche qui précède doit garantir qu'il n'est jamais vide.
Cas d'usage
un partenaire demande à quitter le programme, une étape de validation humaine confirme, et le workflow nettoie la fiche au lieu de la laisser traîner un trimestre de plus.
03

Get an affiliate

affiliate.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un affilié par son identifiant et pose la fiche dans le workflow, ce qu'il faut avant de décider quoi que ce soit à propos de ce partenaire.

Paramètres clés

  • Affiliate ID : l'identifiant de l'affilié, requis. Quand il vient d'une étape antérieure, on le branche par une expression, la petite formule {{ $json.field }} qui va chercher une donnée dans l'item entrant.
Cas d'usage
un ticket support mentionne un identifiant de partenaire, le workflow relit la fiche et aiguille le ticket sur ce que renvoie Tapfiliate.
04

Get many affiliates

affiliate.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les affiliés du compte, un item par affilié, avec six filtres pour réduire l'ensemble avant l'étape suivante.

Paramètres clés

  • Return All : coché, n8n parcourt toutes les pages de l'API ; décoché, il s'arrête à Limit.
  • Filters : Affiliate Group ID récupère les affiliés d'un groupe donné, Parent ID les enfants d'un affilié parent, Referral Code correspond à la valeur de ref= dans un lien de parrainage, auxquels s'ajoutent Email, Click ID et Source ID.
Cas d'usage
l'export mensuel d'un groupe d'affiliés, monté une fois et laissé tourner.

Affiliate Metadata

3 opérations
05

Add metadata to an affiliate

affiliateMetadata.add

Ce que tu vois dans n8n

Notes & cas d'usage

Accroche des métadonnées à un affilié déjà créé. C'est la façon de conserver une information pour laquelle Tapfiliate n'a pas de champ dédié.

Paramètres clés

  • Affiliate ID : l'identifiant de l'affilié, requis.
  • Metadata : les métadonnées à ajouter, saisies dans le sous-formulaire Add Metadata.
Cas d'usage
juste après la création d'un partenaire, le workflow note la campagne qui l'a amené, de quoi regrouper les partenaires par canal d'acquisition plus tard sans tenir un fichier à côté.
06

Remove metadata from an affiliate

affiliateMetadata.remove

Ce que tu vois dans n8n

Notes & cas d'usage

Retire une entrée de métadonnées d'un affilié. L'opération travaille clé par clé, donc le reste de ce que tu as stocké sur ce partenaire n'y touche pas.

Paramètres clés

  • Affiliate ID : l'identifiant de l'affilié, requis.
  • Key : le nom de la clé de métadonnée à retirer.
Cas d'usage
un partenaire sort d'une cohorte de test, et le marqueur qui l'identifiait comme testeur disparaît de sa fiche alors que le reste de son historique est conservé.
07

Update metadata for an affiliate

affiliateMetadata.update

Ce que tu vois dans n8n

Notes & cas d'usage

Pose une nouvelle valeur sur une clé de métadonnée d'un affilié, pour les cas où c'est l'information qui bouge, pas le partenaire.

Paramètres clés

  • Affiliate ID : l'identifiant de l'affilié, requis.
  • Key : le nom de la clé de métadonnée à mettre à jour.
  • Value : la valeur à écrire sur cette clé.
Cas d'usage
le responsable d'un portefeuille de partenaires change, et un workflow réécrit la clé qui porte son nom sur tous les affiliés concernés.

Program Affiliate

5 opérations
08

Add a program affiliate

programAffiliate.add

Ce que tu vois dans n8n

Notes & cas d'usage

Place un affilié existant dans l'un de tes programmes. C'est l'étape qui met réellement un partenaire en activité.

Paramètres clés

  • Program Name or ID : requis. L'identifiant du programme auquel ajouter l'affilié, visible dans l'URL quand tu consultes le programme, ou choisi dans la liste.
  • Affiliate ID : l'identifiant de l'affilié, requis.
  • Additional Fields : Approved, un statut d'approbation facultatif, et Coupon, un coupon facultatif pour cet affilié.
Cas d'usage
le formulaire demande le programme visé, le workflow y range le partenaire sans intervention.
09

Approve a program affiliate

programAffiliate.approve

Ce que tu vois dans n8n

Notes & cas d'usage

Approuve un affilié pour un programme. Utile une fois qu'un humain a regardé la candidature : la décision prise dans une conversation arrive dans Tapfiliate sans que personne se connecte.

Paramètres clés

  • Program Name or ID : choisi dans la liste, ou passé sous forme d'identifiant via une expression. Le nœud ne le marque pas comme requis.
  • Affiliate ID : l'identifiant de l'affilié, également laissé optionnel sur cette opération.
Cas d'usage
un relecteur valide dans un message, et le workflow reporte cette réponse.
10

Disapprove a program affiliate

programAffiliate.disapprove

Ce que tu vois dans n8n

Notes & cas d'usage

L'autre issue de la revue : elle désapprouve un affilié. À brancher en face de la branche d'approbation, pour que les deux réponses possibles soient traitées par le même workflow.

Paramètres clés

  • Program Name or ID : sélectionné dans la liste ou fourni par expression, sans être signalé comme requis.
  • Affiliate ID : l'identifiant de l'affilié, optionnel lui aussi ici.
Cas d'usage
une candidature qui ne passe pas tes règles de vérification se referme toute seule, après que le motif a été écrit en métadonnée.
11

Get a program affiliate

programAffiliate.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un affilié à l'intérieur d'un programme donné. Les deux coordonnées comptent : la même personne peut figurer dans plusieurs programmes, et cette opération répond pour un seul d'entre eux.

Paramètres clés

  • Program Name or ID : requis, pris dans la liste ou fourni par expression.
  • Affiliate ID : l'identifiant de l'affilié, requis.
Cas d'usage
avant qu'un workflow de commande traite une vente comme apportée par un partenaire, il vérifie que l'affilié cité appartient au programme de la campagne.
12

Get many program affiliates

programAffiliate.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les affiliés d'un programme. C'est l'opération derrière tout tableau de suivi construit programme par programme.

Paramètres clés

  • Program Name or ID : requis, donc la réponse porte toujours sur un seul programme.
  • Return All : coché, toutes les pages de résultats remontent ; décoché, Limit plafonne le nombre d'affiliés renvoyés.
  • Filters : Affiliate Group ID, Email, Parent ID pour les enfants d'un affilié parent, et Source ID.
Cas d'usage
la liste hebdomadaire d'un programme, envoyée à l'équipe qui l'anime.
Besoin d'aide

Besoin d'aide pour automatiser Tapfiliate avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Tapfiliate et n8n, les questions qui reviennent

01L'intégration Tapfiliate n8n est-elle gratuite ?
Oui du côté de n8n. Le nœud Tapfiliate est livré avec n8n, il n'y a rien à installer et aucun coût supplémentaire côté n8n, que tu travailles sur n8n Cloud, l'offre hébergée par n8n, ou 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 construire sur une instance locale et déplacer le même workflow sur un serveur ensuite. Ce que coûte ton compte Tapfiliate est une autre question, qui dépend de ton offre chez eux et se vérifie directement auprès de Tapfiliate.
02Quels credentials faut-il pour connecter Tapfiliate ?
Une clé API, et c'est tout. Tapfiliate propose l'authentification par clé API pour ce nœud, et comme le nœud n'a pas de sélecteur d'authentification, le formulaire de credential demande le seul champ API Key. Cette clé se récupère dans Profile Settings de l'application Tapfiliate, à l'entrée API Key, et Tapfiliate maintient un article d'aide qui explique où trouver l'account ID et la clé API. Tu l'enregistres une fois dans le menu Credentials de n8n, et tous les nœuds Tapfiliate de l'instance te la proposent dans une liste. Le même credential sert aussi à un nœud HTTP Request via l'authentification prédéfinie.
03Quelles sont les limites du nœud Tapfiliate ?
Le nœud expose 12 opérations réparties sur 3 ressources, les affiliés, leurs métadonnées et les affiliés d'un programme. Pour un point d'entrée de l'API Tapfiliate qui sort de ce catalogue, on passe par le nœud HTTP Request, qui appelle l'endpoint directement en réutilisant le même credential grâce à l'authentification prédéfinie. La clé reste donc gérée à un seul endroit. L'autre point à anticiper, c'est le volume. Sur les deux opérations de liste, laisser Return All décoché arrête l'exécution à Limit, et le cocher fait enchaîner les pages de l'API jusqu'au bout, ce qui prend plus de temps sur un compte fourni.
04Peut-on réagir en temps réel à un événement Tapfiliate ?
Pas avec un trigger Tapfiliate, puisque cette intégration n'a pas de nœud trigger dans n8n. Un workflow qui la concerne démarre ailleurs : un Schedule Trigger qui se déclenche à intervalle fixe, un Webhook n8n, c'est-à-dire une URL exposée par n8n qu'un service tiers vient appeler, ou le trigger d'un autre outil que tu automatises déjà. En pratique, le recrutement de partenaires part du formulaire ou du CRM qui reçoit la candidature, et le reporting part d'un horaire. Le nœud Tapfiliate fait ensuite la lecture ou l'écriture une fois l'exécution lancée.
05n8n ou Make pour Tapfiliate ?
La réponse tient à l'hébergement, aux données et au modèle de coût, pas à la liste des opérations. Make est une plateforme hébergée par Make, sans option d'auto-hébergement, facturée à l'opération : un workflow qui boucle sur une longue liste d'affiliés voit donc son coût suivre la taille de la liste. n8n tourne sur ton propre serveur ou sur n8n Cloud, avec un workflow identique dans les deux cas, ce qui permet de garder les données de tes partenaires dans une infrastructure que tu maîtrises. Make mise sur le visuel guidé, n8n donne accès aux expressions et au code quand un mapping devient spécifique.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations