Integración Tapfiliate n8nAutomatiza Tapfiliate con n8n.
Dar de alta a cada socio a mano en un panel de afiliados es trabajo que nadie debería seguir haciendo. La integración Tapfiliate n8n viene dentro de n8n y abre 12 operaciones repartidas en 3 recursos: los afiliados, los metadatos que cuelgan de ellos y su situación dentro de un programa.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué cubre la integración Tapfiliate n8n?
Tapfiliate guarda a tus afiliados, sus datos y los programas a los que pertenecen. El nodo de n8n habla con esa cuenta a través de la API de Tapfiliate y le da tres agarraderas a un workflow, es decir, a una secuencia de pasos automatizados: la ficha del afiliado, los metadatos libres que le añades y la relación entre un afiliado y un programa. Doce operaciones, tres recursos, y ninguna escucha de eventos del lado de Tapfiliate.
El alta de socios es el primer terreno, porque ahí se acumula el tecleo. Un formulario de solicitud deja un nombre y un correo en el workflow, affiliate.create crea la ficha y programAffiliate.add coloca al afiliado en el programa que toca, con el campo Approved y un Coupon cuando la campaña usa uno. Un mensaje en Slack cierra el círculo y el responsable de partners se entera al momento.
El segundo terreno es conservar el contexto que Tapfiliate no guarda por su cuenta. Un metadato es una clave y un valor, suficiente para anotar de dónde llega un socio o quién lo lleva dentro del equipo. affiliateMetadata.add lo escribe en el alta, affiliateMetadata.update lo corrige después, y esa misma información viaja a la ficha del contacto en Salesforce, donde comercial trabaja cada día.
El tercero es el seguimiento. Un affiliate.getAll filtrado por Affiliate Group ID, o un programAffiliate.getAll sobre un programa concreto, alimenta una hoja de Google Sheets que consulta todo el mundo. Y en la parte de ventas, un pago en Stripe llega con un código de referido: el filtro Referral Code localiza al socio y programAffiliate.get comprueba que de verdad pertenece al programa de esa campaña.
Cuando un endpoint de la API de Tapfiliate no está entre estas 12 operaciones, el nodo HTTP Request lo llama directamente y reutiliza el mismo credential mediante la autenticación predefinida. No hay que rehacer nada y la clave se sigue gestionando en un único sitio.
Dos condiciones marcan el diseño. Tapfiliate no tiene nodo trigger en n8n, o sea, ningún disparador propio: el workflow arranca con un Schedule Trigger a intervalo fijo, con un Webhook de n8n al que llama un servicio externo, o con el trigger de otra herramienta. Y en las dos operaciones de listado, Return All va encadenando las páginas de la API hasta el último afiliado, mientras que si lo dejas desactivado se detiene en Limit. La Reseña n8n entra en detalle sobre el coste de esas ejecuciones según dónde alojes la instancia.
¿Cómo se conecta Tapfiliate con n8n?
- 01
Copia la clave API desde Tapfiliate
El nodo se autentica con una sola clave API, y esa clave vive en tu cuenta de Tapfiliate, no en n8n. Entra en Profile Settings dentro de la aplicación de Tapfiliate y busca la entrada API Key. Tapfiliate publica además un artículo de soporte sobre dónde encontrar el account ID y la clave API, útil si el menú ha cambiado desde la última vez. Deja el valor a mano para el paso siguiente.
- 02
Crea el credential en n8n
En n8n, abre el menú Credentials y añade un credential de Tapfiliate, o sea, unas credenciales guardadas una sola vez. El nodo no ofrece selector de autenticación, así que el formulario pide el campo API Key y nada más. Pega el valor y guarda. A partir de ahí, cualquier workflow de la instancia encuentra ese credential en un desplegable y tú no vuelves a tocar la clave.
- 03
Elige recurso y operación
Arrastra el nodo Tapfiliate al lienzo. Te propone el credential que acabas de guardar, después pide el recurso, Affiliate, Affiliate Metadata o Program Affiliate, y la operación dentro de él. Los campos de programa se rellenan con una lista leída de tu cuenta: eliges el programa por su nombre en vez de buscar su identificador. Ejecuta el nodo una vez con un valor real para ver qué forma tiene la respuesta.
Lo que sabe hacer el nodo Tapfiliate
El nodo Tapfiliate expone 12 operaciones en 3 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get | Get Many | Update | Delete | Add | Remove | Approve | Disapprove |
|---|---|---|---|---|---|---|---|---|---|
| Affiliate | ✓ | ✓ | ✓ | ✓ | |||||
| Affiliate Metadata | ✓ | ✓ | ✓ | ||||||
| Program Affiliate | ✓ | ✓ | ✓ | ✓ | ✓ |
Affiliate
4 operacionesCreate an affiliate
affiliate.createLo que ves en n8n
Notas y casos de uso
Da de alta un afiliado nuevo en la cuenta de Tapfiliate y devuelve la ficha creada al workflow.
Parámetros clave
- Email: el correo del afiliado, con la forma
name@email.com, normalmente traído del nodo anterior con{{ $json.field }}. - First Name y Last Name: el nombre y el apellido del afiliado, ambos obligatorios, así que un valor vacío del formulario detiene el nodo.
- Additional Fields: Company Name para los datos de empresa del afiliado y Address, que se completa en su propio subformulario.
Delete an affiliate
affiliate.deleteLo que ves en n8n
Notas y casos de uso
Elimina un afiliado de la cuenta. Un identificador y ya está, por eso encaja al final de una salida ordenada y no como paso intermedio.
Parámetros clave
- Affiliate ID: el identificador del afiliado, obligatorio, de modo que la rama anterior tiene que garantizar que nunca llega vacío.
Get an affiliate
affiliate.getLo que ves en n8n
Notas y casos de uso
Lee un afiliado por su identificador y deja la ficha dentro del workflow, que es lo que hace falta antes de decidir nada sobre ese socio.
Parámetros clave
- Affiliate ID: el identificador del afiliado, obligatorio. Si viene de un paso anterior se conecta con una expresión, esa fórmula corta
{{ $json.field }}que recoge un dato del item entrante.
Get many affiliates
affiliate.getAllLo que ves en n8n
Notas y casos de uso
Lista los afiliados de la cuenta, un item por afiliado, con seis filtros para acotar el conjunto antes de pasar al siguiente paso.
Parámetros clave
- Return All: activado, n8n recorre todas las páginas de la API; desactivado, se queda en Limit.
- Filters: Affiliate Group ID recupera los afiliados de un grupo concreto, Parent ID los hijos de un afiliado padre, Referral Code corresponde al valor de ref= en un enlace de referido, y además tienes Email, Click ID y Source ID.
Affiliate Metadata
3 operacionesAdd metadata to an affiliate
affiliateMetadata.addLo que ves en n8n
Notas y casos de uso
Añade metadatos a un afiliado que ya existe. Es la vía para guardar información que Tapfiliate no tiene en un campo propio.
Parámetros clave
- Affiliate ID: el identificador del afiliado, obligatorio.
- Metadata: los metadatos que quieres añadir, escritos en el subformulario Add Metadata.
Remove metadata from an affiliate
affiliateMetadata.removeLo que ves en n8n
Notas y casos de uso
Quita una entrada de metadatos de un afiliado. Trabaja clave por clave, así que el resto de lo que hayas guardado sobre ese socio se queda intacto.
Parámetros clave
- Affiliate ID: el identificador del afiliado, obligatorio.
- Key: el nombre de la clave de metadato que se retira.
Update metadata for an affiliate
affiliateMetadata.updateLo que ves en n8n
Notas y casos de uso
Escribe un valor nuevo en una clave de metadato de un afiliado, para cuando lo que cambia es el dato y no el socio.
Parámetros clave
- Affiliate ID: el identificador del afiliado, obligatorio.
- Key: el nombre de la clave de metadato que se actualiza.
- Value: el valor que se fija en esa clave.
Program Affiliate
5 operacionesAdd a program affiliate
programAffiliate.addLo que ves en n8n
Notas y casos de uso
Mete a un afiliado que ya existe dentro de uno de tus programas. Este es el paso que pone de verdad al socio en marcha.
Parámetros clave
- Program Name or ID: obligatorio. El identificador del programa al que se añade el afiliado, visible en la URL cuando consultas el programa, o elegido en la lista.
- Affiliate ID: el identificador del afiliado, obligatorio.
- Additional Fields: Approved, un estado de aprobación opcional, y Coupon, un cupón opcional para ese afiliado.
Approve a program affiliate
programAffiliate.approveLo que ves en n8n
Notas y casos de uso
Aprueba a un afiliado para un programa. Sirve cuando una persona ya ha revisado la solicitud: la decisión tomada en una conversación llega a Tapfiliate sin que nadie entre en el panel.
Parámetros clave
- Program Name or ID: se elige en la lista o se pasa como identificador mediante una expresión. El nodo no lo marca como obligatorio.
- Affiliate ID: el identificador del afiliado, también opcional en esta operación.
Disapprove a program affiliate
programAffiliate.disapproveLo que ves en n8n
Notas y casos de uso
La otra salida de la revisión: desaprueba a un afiliado. Colócala enfrente de la rama de aprobación para que las dos respuestas posibles queden resueltas en el mismo workflow.
Parámetros clave
- Program Name or ID: seleccionado en la lista o aportado por expresión, sin aparecer marcado como obligatorio.
- Affiliate ID: el identificador del afiliado, aquí también opcional.
Get a program affiliate
programAffiliate.getLo que ves en n8n
Notas y casos de uso
Lee un afiliado dentro de un programa concreto. Las dos coordenadas importan: la misma persona puede estar en varios programas y esta operación responde por uno solo.
Parámetros clave
- Program Name or ID: obligatorio, tomado de la lista o aportado con una expresión.
- Affiliate ID: el identificador del afiliado, obligatorio.
Get many program affiliates
programAffiliate.getAllLo que ves en n8n
Notas y casos de uso
Detrás de cualquier cuadro de seguimiento hecho programa a programa está esta operación, que devuelve los afiliados de uno solo de ellos.
Parámetros clave
- Program Name or ID: obligatorio, de manera que la respuesta siempre se refiere a un único programa.
- Return All: activado, vuelven todas las páginas de resultados; desactivado, Limit pone el tope de afiliados devueltos.
- Filters: Affiliate Group ID, Email, Parent ID para los hijos de un afiliado padre y Source ID.
¿Necesitas ayuda para automatizar Tapfiliate con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
