Saltearse al contenido
Nappai Documentation

ActiveCampaign Accounts

Bienvenido a la guía del componente ActiveCampaign Accounts. Diseñado para trabajar dentro de Nappai, este módulo te permite administrar fácilmente las empresas u organizaciones que tienes registradas en ActiveCampaign. Ya no necesitas escribir código ni navegar por múltiples paneles: aquí podrás crear, consultar, actualizar o eliminar cuentas de manera visual y segura.

¿Cómo funciona?

Este componente actúa como un puente inteligente entre tu tablero de automatización en Nappai y ActiveCampaign. Cuando lo ejecutas, se encarga automáticamente de hablar con los servidores de ActiveCampaign, organizar la información que le proporcionas y devolverte un resultado claro.

Piensa en él como un asistente administrativo: tú le indicas qué cuenta quieres gestionar, le das los detalles básicos (nombre, correo, sitio web, etc.) y él se encarga de validar los datos, enviarlos en el formato correcto y confirmarte si la acción se realizó sin problemas. Además, está marcado como una versión en desarrollo activo, lo que significa que es ideal para probar flujos, prototipar automatizaciones o trabajar en entornos de prueba antes de llevarlos a producción.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

  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 (URL de la API y Clave de API).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

💡 Nota: No necesitas configurar claves o tokens manualmente dentro de este componente. Solo asegúrate de que la credencial ya esté lista en Nappai y selecciónala desde el menú desplegable.

Entradas

Los siguientes campos están disponibles para configurar este componente. Puedes completar solo los necesarios según la acción que desees realizar:

  • Operation: Selecciona qué acción deseas realizar con la cuenta (por ejemplo, crear una nueva, buscar una existente, modificarla o eliminarla).
  • Get By: Define el criterio para recuperar los datos: puedes buscar por identificador único o solicitar una lista completa de cuentas.
  • Account ID: El código único que identifica a una cuenta específica dentro de ActiveCampaign. Es necesario si quieres consultar, actualizar o eliminar una cuenta ya existente.
  • Account Name: El nombre comercial de la empresa u organización que deseas registrar o modificar.
  • Account URL: La dirección web oficial de la empresa o cuenta.
  • Limit: Número máximo de cuentas que quieres recuperar en una sola consulta. Útil cuando trabajas con grandes volúmenes de datos.
  • Contact ID: El identificador único de un contacto que deseas vincular o asociar a esta cuenta dentro del ecosistema de automatización.

Salidas

Una vez que ejecutas el componente, recibirás información estructurada lista para ser usada en los siguientes pasos de tu flujo. La salida principal es:

  • Data: Contiene toda la información organizada de la cuenta gestionada. Aquí recibirás los detalles completos (ID, nombre, estado, enlaces, etc.) que podrás arrastrar o conectar a otros módulos para enviar correos, generar reportes o actualizar contactos.

Ejemplo de Respuesta JSONjson

{ “id”: 58492, “name”: “Marketing Digital S.A.”, “email”: “contacto@marketingdigital.com”, “status”: “active”, “url”: “https://www.marketingdigital.com”, “limit_applied”: 10, “linked_contact_id”: 3001, “success”: true, “message”: “Cuenta recuperada y vinculada exitosamente” } Cuando trabajes con las salidas en el siguiente nodo, simplemente busca la variable Data y úsala para personalizar tus automatizaciones.

Conectividad

Aunque este componente no viene con puertos de conexión predefinidos, funciona mejor cuando se integra lógicamente dentro de un flujo de automatización:

  • Entrada típica: Se suele conectar después de un activador o nodo de importación de datos (por ejemplo, cuando se registra un nuevo cliente en un formulario web o se sincroniza una hoja de cálculo).
  • Salida típica: Sus resultados suelen alimentar nodos de envío de campañas, actualización de contactos, generación de reportes o validación de datos.
  • Lógica recomendada: Colócalo en la etapa de “gestión de datos” de tu flujo, justo antes de aplicar acciones de comunicación o marketing, para asegurar que la información esté limpia y actualizada.

Ejemplo de Uso

Imagina que trabajas en una agencia de marketing y recibes un nuevo cliente. Quieres que el sistema registre automáticamente a esa empresa en ActiveCampaign y la vincule al contacto principal de la agencia.

  1. Arrastras este componente después de un nodo que captura los datos del cliente.
  2. En Operation seleccionas Create o Update según corresponda.
  3. En Account Name y Account URL ingresas o vinculas los datos de la empresa.
  4. En Contact ID arrastras el identificador del contacto principal.
  5. Al ejecutarlo, el sistema devuelve Data con la cuenta confirmada, lista para ser usada en campañas de email marketing o seguimiento automático.

Consejos y Mejores Prácticas

  • Mantén los IDs actualizados: Si una cuenta deja de existir en ActiveCampaign, el sistema retornará un mensaje claro que puedes usar para pausar automatizaciones antiguas.
  • Usa el campo Limit con moderación: Si solo necesitas una cuenta específica, déjalo vacío o en un valor bajo para mantener el flujo rápido y eficiente.
  • Prueba primero en entornos de prueba: Dado que el componente está en fase de desarrollo activo, utiliza cuentas de prueba antes de aplicar cambios a datos reales de clientes.
  • Valida antes de vincular: Asegúrate de que el Contact ID corresponda a un contacto existente para evitar errores de asociación.

Consideraciones de Seguridad

  • Almacena tus credenciales en un espacio seguro de Nappai y nunca compartas las claves de API en canales públicos o chats de equipo.
  • Revisa periódicamente los accesos y limita las claves a solo lo necesario para tu automatización.
  • Este componente trabaja con datos sensibles de organización; asegúrate de que tu cuenta de Nappai cuente con permisos adecuados y seguimiento de auditoría activado.
  • Si detectas comportamientos inesperados o mensajes de error recurrentes, registra el caso en la documentación oficial y evalúa pausar el flujo hasta su estabilización.