Saltearse al contenido
Nappai Documentation

ActiveCampaign Contacts

Este componente funciona como un puente inteligente entre tu cuenta de ActiveCampaign y el sistema de automatización Nappai. Su propósito principal es ayudarte a gestionar tus contactos de forma eficiente: desde registrar nuevos clientes hasta organizarlos en listas específicas o eliminar registros antiguos.

¿Cómo funciona?

Cuando utilizas este componente, estás hablando directamente con la plataforma de ActiveCampaign para realizar tareas administrativas.

  1. Conexión Segura: El componente usa las credenciales que configuras para conectar de forma segura con tu cuenta de ActiveCampaign.
  2. Selección de Acción: Puedes elegir qué quieres hacer (por ejemplo, crear un contacto nuevo o buscar uno existente) mediante el campo “Operation”.
  3. Entrega de Datos: Ingresa la información necesaria (como el correo electrónico o el nombre) y el componente se encarga de enviarla a ActiveCampaign.
  4. Resultado: Una vez procesado, el componente te devuelve un resultado indicando si la acción tuvo éxito y proporcionando datos clave (como el ID único del contacto) para que puedas usarlos en los siguientes pasos de tu automatización.

Conexión y Credenciales

Para que este componente funcione, es necesario configurar previamente una credencial en el panel de Nappai. Sin esto, no podrá comunicarse con tu cuenta de ActiveCampaign.

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo ActiveCampaign y guarda los campos requeridos (Claves de API, URLs, etc.). Para obtener estos datos, ve a la configuración de ActiveCampaign en el menú Settings > Developer.
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Los siguientes campos están disponibles para configurar este componente. Estos nombres se mantienen en inglés para asegurar la correcta conexión con la plataforma:

  • Operation: Permite seleccionar la acción principal que deseas realizar (por ejemplo, crear, actualizar, buscar o eliminar). Este campo es fundamental para definir qué hará el componente.
  • Search By: Campo para definir por qué atributo quieres buscar un contacto (por ejemplo, por email o ID).
  • Get By: Específica cómo recuperar un usuario (por ID único o una lista completa).
  • Email: La dirección de correo electrónico del contacto. Es un dato esencial para identificar a una persona.
  • First Name: El nombre del contacto.
  • Last Name: El apellido del contacto.
  • Phone: El número de teléfono del contacto.
  • Contact ID: El identificador único numérico que ActiveCampaign asigna a cada contacto. Útil para modificar registros específicos.
  • User ID: El identificador del usuario dentro del sistema de ActiveCampaign.
  • Tag ID: El identificador de una etiqueta. Permite asociar o modificar etiquetas específicas del contacto.
  • List ID: El identificador de una lista de contactos. Sirve para añadir o quitar contactos de listas específicas.
  • Limit: Define el número máximo de usuarios o contactos que se deben devolver en una búsqueda.
  • Custom Fields: Permite ingresar valores para campos personalizados que hayas configurado en tu cuenta de ActiveCampaign. Debe estructurarse como un objeto de datos con los IDs de los campos y sus valores.

Salidas

Este componente produce los siguientes resultados que puedes usar en pasos posteriores de tu flujo:

  • Contact Data: Contiene la información completa del contacto resultante de la operación (JSON), incluyendo detalles como su ID, nombre, email y estado.

Ejemplo de Respuesta JSON

Cuando la operación se ejecuta correctamente, el componente devuelve una estructura de datos similar a esta: json { “id”: 12345678, “email”: “cliente@ejemplo.com”, “first_name”: “Juan”, “last_name”: “Pérez”, “phone”: “+55 123 456 789”, “tags”: [101, 102], “lists”: [201], “status”: “active” }

Conectividad

Este componente es una pieza central para la gestión de datos de clientes. Sus salidas (como el Contact ID o Contact Data) suelen conectarse a:

  • Nodos de Email Marketing: Para enviar correos personalizados al contacto recién creado.
  • Bases de Datos: Para sincronizar la información obtenida con otros sistemas.
  • Herramientas de Análisis: Para registrar el estado del contacto en tableros de reportes.

Es lógico conectar este componente después de la captura de datos (como formularios web) y antes de acciones de comunicación.

Ejemplo de Uso

Escenario: Tienes un formulario en tu sitio web y quieres guardar los datos del visitante en ActiveCampaign para luego enviarle un boletín.

  1. Usa el componente ActiveCampaign Contacts.
  2. En el campo Operation, selecciona la opción para Crear un contacto.
  3. En el campo Email, mapea la salida del formulario web (ej. email_usuario).
  4. En First Name y Last Name, mapea los nombres del usuario.
  5. Al finalizar, el componente devuelve el Contact ID, el cual puedes usar en el siguiente paso para añadir ese contacto a una lista de boletines específica.

Consejos y Mejores Prácticas

  • Datos Completos: Asegúrate de ingresar al menos el correo electrónico; es el campo más importante para evitar duplicados.
  • IDs Exactos: Cuando trabajes con etiquetas o listas, utiliza los IDs numéricos oficiales para garantizar que la asociación se realice correctamente.
  • Límites de Búsqueda: Si vas a recuperar muchos contactos, usa el campo Limit para controlar el volumen y evitar sobrecargar tu flujo de automatización.
  • Campos Personalizados: Usa el campo Custom Fields solo si necesitas gestionar atributos que no son estándar (como “Fecha de Nacimiento” o “País”), asegurándote de usar los IDs correctos de esos campos.

Consideraciones de Seguridad

  • Manejo de Credenciales: Nunca compartas tus Claves de API ni tokens generados en ActiveCampaign con personas no autorizadas. Configúralas siempre dentro de la sección segura de credenciales de Nappai.
  • Validación de Datos: ActiveCampaign es estricto con el formato de los correos electrónicos. Asegúrate de que los datos de entrada sean válidos para evitar errores en la automatización.
  • Privacidad: Al crear o actualizar contactos, recuerda cumplir con las normativas locales de protección de datos (como GDPR), asegurando que tienes el consentimiento del usuario para almacenar su información.