Saltearse al contenido
Nappai Documentation

ActiveCampaign Campaigns

Este componente te permite interactuar con tu cuenta de ActiveCampaign para recuperar información sobre tus campañas de email marketing. Es especialmente útil si necesitas verificar el estado de una campaña, revisar listas de correos o integrar datos de marketing en otros flujos de automatización dentro de Nappai.

¿Cómo funciona?

Internamente, este componente se conecta a la API de ActiveCampaign para leer datos. Dependiendo de cómo configures el flujo, puedes:

  1. Obtener una lista completa de todas las campañas de tu cuenta.
  2. Buscar los detalles específicos de una única campaña si conoces su identificador (ID).

El sistema gestiona la autenticación y la recuperación de datos, y luego te entrega la información en un formato fácil de usar para los siguientes pasos de tu automatizació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.

Importante: Para obtener tus credenciales, inicia sesión en tu cuenta de ActiveCampaign, ve al menú Settings > Developer y copia la URL de tu API y la API Key correspondiente.

Entradas

Los siguientes campos están disponibles para configurar este componente.

  • Operation: Permite seleccionar el tipo de operación principal.
  • Get By: Determina si deseas recuperar una campaña específica por su ID o obtener la lista completa de campañas.
  • Campaign ID: El identificador único de la campaña de la que deseas obtener información (usado cuando seleccionas una campaña específica).
  • Limit: Número máximo de campañas a devolver en la lista. Útil para optimizar el rendimiento si tienes muchas campañas.
  • Status Filter: Filtra las campañas por su estado (por ejemplo, “activo” o “borrador”). Este filtro solo tiene efecto cuando seleccionas obtener la lista completa de campañas.

Salidas

Este componente devuelve la información solicitada en el siguiente campo:

  • Data: Contiene la información de las campañas recuperadas. Puede ser una lista con múltiples campañas o un objeto detallado con la información de una sola campaña.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se estructura la respuesta que recibirás en el campo Data. Esto te ayudará a saber qué datos puedes usar en los siguientes nodos de tu flujo. json [ { “id”: 12345678, “name”: “Newsletter Mensual de Marketing”, “status”: “active”, “type”: “regular”, “list_id”: 123, “from_name”: “Tu Equipo de Ventas”, “from_email”: “ventas@tuempresa.com”, “subject”: “Ofertas especiales este fin de semana”, “created_at”: “2023-10-15 14:30:00”, “updated_at”: “2023-10-15 14:30:00” }, { “id”: 12345679, “name”: “Bienvenida a Nuevos Clientes”, “status”: “active”, “type”: “trigger”, “created_at”: “2023-09-01 10:00:00” } ]

Conectividad

Este componente actúa como una fuente de datos. Lógicamente, sus salidas suelen conectarse a:

  • Filtros: Para seleccionar solo las campañas que cumplen ciertos criterios (ej. estado “activo”).
  • Acciones de Email: Para usar los detalles de una campaña específica en un envío posterior.
  • Base de Datos: Para almacenar el historial de tus campañas.
  • Visualizadores: Para mostrar el estado de tus campañas en un dashboard o reporte.

Ejemplo de Uso

Imagina que eres un responsable de marketing y quieres crear un reporte semanal sobre tus campañas activas.

  1. Obtener Campañas: Usa este componente y configura Get By para obtener la lista de todas tus campañas.
  2. Filtrar: Conecta este componente a un nodo de “Filtro” y selecciona solo aquellas cuyo status sea “active”.
  3. Procesar: Envía la lista filtrada a un nodo de “Generar PDF” o “Enviar Email” con los detalles de esas campañas.

Consejos y Mejores Prácticas

  • Uso de Límites: Si tienes muchas campañas en tu cuenta, utiliza el campo Limit para evitar sobrecargar el sistema o ralentizar tu flujo.
  • Filtros Eficientes: Usa Status Filter solo cuando necesites ver campañas de un estado particular para reducir el volumen de datos procesados.
  • Modo Experimental: Este componente se encuentra en una fase de desarrollo experimental (beta). Se recomienda probarlo en un entorno de prueba antes de usarlo en procesos críticos de producción, ya que su comportamiento o estructura de datos podría sufrir cambios.

Consideraciones de Seguridad

  • Asegúrate de mantener tu API Key en la sección de Credenciales de Nappai segura y de acceso restringido.
  • Al utilizar Campaign ID, verifica que el identificador pertenezca a una campaña autorizada para evitar errores de acceso o permisos.