INTEGRACIÓN TAPFILIATE n8n: AUTOMATIZAR TAPFILIATE CON N8N

Esta acción recupera múltiples afiliados asociados a un programa de afiliación específico en Tapfiliate. Es particularmente útil para construir vistas consolidadas de afiliados por programa, alimentar reportes dinámicos o sincronizar información con sistemas externos.

Parámetros clave:

• Program Name or ID: Campo de texto para especificar el programa objetivo por su nombre o identificador único. Este parámetro permite filtrar afiliados pertenecientes a un programa específico.
• Return All: Interruptor on/off opcional. Cuando se activa, recupera todos los afiliados del programa sin límite, anulando el parámetro "Limit".
• Limit: Campo numérico opcional (valor por defecto: 100). Define el número máximo de afiliados a recuperar si "Return All" está desactivado.
• Filters: Sección opcional que permite añadir criterios de filtrado adicionales (clic en "Add Field" para especificar propiedades y valores).

Casos de uso típicos:

• Recuperar todos los afiliados activos de un programa específico para sincronizarlos con tu CRM
• Alimentar un dashboard con la lista de afiliados por programa en Google Sheets o Notion
• Construir una vista filtrada de afiliados según criterios personalizados (metadata, estado de aprobación, etc.)

Cuándo usarlo: Cuando necesitas obtener listas de afiliados a nivel de programa para análisis, sincronización o acciones en lote. Combina con "Filters" para extracciones precisas.

Esta acción recupera información detallada sobre un afiliado específico dentro de un programa de afiliación. Permite obtener datos completos de un afiliado cuando conoces su ID.

Parámetros clave:

• Program Name or ID: Campo de texto para identificar el programa al que pertenece el afiliado (nombre o ID único).
• Affiliate ID: Campo de texto requerido para especificar el identificador único del afiliado a recuperar.

Casos de uso: Recuperar datos de un afiliado específico para verificación, actualización o sincronización con otra aplicación. Por ejemplo, obtener información completa de un afiliado antes de aprobar su adhesión o sincronizar su perfil con tu CRM.

Cuándo usarlo: Cuando necesitas datos precisos de un afiliado conocido dentro de un programa específico. Útil en workflows que procesan afiliados individualmente.

Esta acción rechaza o desaprueba un afiliado previamente asociado a un programa de afiliación. Permite revocar el acceso de un afiliado a un programa sin eliminarlo completamente del sistema.

Parámetros clave:

• Program Name or ID: Campo de texto requerido para identificar el programa del cual desaprobar al afiliado.
• Affiliate ID: Campo de texto requerido para especificar el identificador único del afiliado a desaprobar.

Casos de uso: Desaprobar automáticamente afiliados que no cumplen criterios de calidad detectados en otros sistemas, revocar acceso a afiliados inactivos, o gestionar aprobaciones condicionales basadas en validaciones externas.

Cuándo usarlo: En workflows de moderación o compliance, cuando una condición externa (resultado de verificación, comportamiento detectado) justifica revocar el acceso de un afiliado a un programa específico.

Esta acción aprueba un afiliado para un programa de afiliación específico, autorizándolo a generar comisiones y acceder a recursos del programa.

Parámetros clave:

• Program Name or ID: Campo de texto requerido para identificar el programa al cual aprobar al afiliado.
• Affiliate ID: Campo de texto requerido para especificar el identificador único del afiliado a aprobar.

Casos de uso: Aprobar automáticamente afiliados cuando completan un proceso de verificación externo (validación de email, documentación subida, criterios de CRM cumplidos). Por ejemplo, aprobar un afiliado en cuanto su perfil LinkedIn es validado o su empresa es verificada en tu CRM.

Cuándo usarlo: En workflows de onboarding automatizado, cuando condiciones predefinidas se cumplen y justifican una aprobación inmediata sin revisión manual.

Esta acción añade un afiliado existente a un programa de afiliación específico. Útil para gestionar la adhesión de afiliados a múltiples programas.

Parámetros clave:

• Program Name or ID: Campo de texto para identificar el programa al cual añadir el afiliado (nombre o ID único).
• Affiliate ID: Campo de texto requerido para especificar el identificador único del afiliado a añadir.
• Additional Fields: Sección opcional para añadir propiedades o datos personalizados asociados a la adhesión del afiliado al programa.

Casos de uso: Añadir automáticamente un afiliado a un nuevo programa cuando cumple criterios específicos (nivel de ventas alcanzado, categoría de cliente modificada, etc.). Por ejemplo, promover un afiliado a un programa premium cuando supera un umbral de comisiones.

Cuándo usarlo: En workflows de segmentación o promoción, cuando quieres gestionar dinámicamente la participación de afiliados en múltiples programas según su rendimiento o características.

Esta acción actualiza un metadato específico asociado a un afiliado. Los metadatos son pares clave-valor personalizados que permiten almacenar información adicional sobre afiliados.

Parámetros clave:

• Affiliate ID: Campo de texto requerido para identificar el afiliado objetivo.
• Key: Campo de texto requerido para especificar el nombre del metadato a actualizar.
• Value: Campo de texto requerido para proporcionar el nuevo valor del metadato.

Casos de uso: Actualizar dinámicamente información personalizada de afiliados según comportamientos detectados: nivel de actividad, categoría de vendedor, score de calidad, tags de segmentación, etc. Por ejemplo, actualizar el metadato "tier" a "premium" cuando un afiliado alcanza 10 ventas.

Cuándo usarlo: Cuando necesitas enriquecer o mantener actualizada información adicional sobre afiliados que no corresponde a campos estándar de Tapfiliate. Combina con triggers de otras aplicaciones para sincronización reactiva.

Esta acción elimina un metadato específico asociado a un afiliado, suprimiendo completamente el par clave-valor de su perfil.

Parámetros clave:

• Affiliate ID: Campo de texto requerido para identificar el afiliado del cual eliminar el metadato.
• Key: Campo de texto requerido para especificar el nombre del metadato a eliminar.

Casos de uso: Limpiar metadatos obsoletos, eliminar tags temporales después de un proceso específico, o gestionar ciclos de vida de información personalizada. Por ejemplo, eliminar el metadato "onboarding_status" una vez completado el proceso de integración.

Cuándo usarlo: En workflows de limpieza de datos o gestión de ciclo de vida de información personalizada, cuando un metadato ya no es relevante o debe ser eliminado por políticas de privacidad.

Esta acción añade un nuevo metadato a un afiliado, creando un par clave-valor personalizado para almacenar información adicional.

Parámetros clave:

• Affiliate ID: Campo de texto requerido para identificar el afiliado al cual añadir el metadato.
• Metadata: Sección para definir pares clave-valor personalizados. Clic en "Add Metadata" revela campos para especificar el nombre (key) y el valor del metadato. Este parámetro es opcional pero fundamental para añadir datos personalizados.

Casos de uso: Enriquecer perfiles de afiliados con información proveniente de otras fuentes: origen de adquisición, preferencias de comunicación, categoría de industria, identificadores externos (ID de CRM, Slack User ID), etc.

Cuándo usarlo: Al crear o importar afiliados desde sistemas externos, cuando necesitas almacenar información adicional no contemplada en los campos estándar de Tapfiliate. Perfecto para sincronización bidireccional con CRMs o bases de datos.

Esta acción recupera múltiples afiliados de tu cuenta Tapfiliate según criterios opcionales de filtrado. Es la acción más versátil para obtener listas de afiliados.

Parámetros clave:

• Return All: Interruptor on/off opcional. Cuando se activa, recupera todos los afiliados disponibles sin límite.
• Limit: Campo numérico opcional (valor por defecto: 100). Define el número máximo de afiliados a recuperar si "Return All" está desactivado.
• Filters: Sección opcional para especificar criterios de filtrado (propiedades y valores). Permite extracciones precisas según estado de aprobación, metadatos, programa, etc.

Casos de uso: Sincronizar periódicamente tu base completa de afiliados con un CRM o una base de datos, alimentar reportes dinámicos, construir listas segmentadas para campañas de email marketing con Mailchimp, o analizar tu población de afiliados en herramientas de BI.

Cuándo usarlo: Cuando necesitas extraer listas de afiliados sin restricción a un programa específico. Combina con "Filters" para extracciones precisas y "Limit" para controlar el volumen de datos recuperados.

Esta acción recupera información detallada sobre un afiliado específico utilizando su ID único. Es la forma más directa de obtener el perfil completo de un afiliado.

Parámetros clave:

• Affiliate ID: Campo de texto opcional para especificar el identificador único del afiliado a recuperar. Si se deja vacío, el comportamiento puede variar según la configuración.

Casos de uso: Obtener datos completos de un afiliado antes de ejecutar acciones condicionales (aprobar, actualizar, añadir a programa), verificar información de afiliado después de una creación, o sincronizar un perfil específico con sistemas externos.

Cuándo usarlo: Cuando tienes el ID de un afiliado específico y necesitas recuperar su información completa para procesamiento o verificación en tu workflow.

Esta acción elimina permanentemente un afiliado de tu cuenta Tapfiliate. Utilízala con precaución, ya que la operación es irreversible.

Parámetros clave:

• Affiliate ID: Campo de texto requerido para especificar el identificador único del afiliado a eliminar. Acepta valor "Fixed" (ID directamente introducido) o "Expression" (ID recuperado dinámicamente desde pasos anteriores del workflow).

Casos de uso: Eliminar automáticamente afiliados inactivos después de un período definido, limpiar cuentas de prueba o duplicados, o gestionar políticas de retención de datos según normativas de privacidad (RGPD, CCPA).

Cuándo usarlo: En workflows de limpieza periódica o de gestión de ciclo de vida de afiliados, cuando criterios objetivos justifican la eliminación definitiva de un afiliado. Combina con una acción "Get Affiliate" previa para verificar condiciones antes de eliminar.

Esta acción crea un nuevo afiliado en tu cuenta Tapfiliate, proporcionando su email y, opcionalmente, información adicional.

Parámetros clave:

• Email: Campo de texto requerido para especificar la dirección email del nuevo afiliado (placeholder: "name@email.com").
• First Name: Campo de texto opcional para proporcionar el nombre del afiliado.
• Last Name: Campo de texto opcional para proporcionar el apellido del afiliado.
• Additional Fields: Sección opcional que permite añadir propiedades personalizadas al afiliado. Clic en "Add Field" revela campos para definir pares clave-valor adicionales no cubiertos por los campos estándar.

Casos de uso: Crear automáticamente un afiliado en Tapfiliate cuando se registra en un formulario externo (Typeform, Google Forms), cuando un cliente específico es marcado como potencial afiliado en tu CRM, o cuando se valida una candidatura en Airtable.

Cuándo usarlo: En workflows de onboarding o adquisición de afiliados, cuando quieres automatizar completamente el proceso de creación desde sistemas externos hacia Tapfiliate. Combina con "Add Affiliate Metadata" para enriquecer inmediatamente el perfil con información personalizada.