Campaign

Bienvenido al componente Campaign en Nappai. Este nodo actúa como una puerta de enlace directa hacia tu cuenta de Mailchimp, permitiéndote consultar, organizar y visualizar información sobre tus campañas de correo electrónico.

Es la herramienta ideal si necesitas recuperar datos sobre campañas existentes (como su estado, tipo de envío o estadísticas) para usarlos en otros procesos de automatización dentro de Nappai.

¿Cómo funciona?

Internamente, este componente se conecta a la API oficial de Mailchimp. Cuando lo utilizas, no tienes que preocuparte por la programación compleja de las solicitudes; en su lugar, proporcionas los criterios de búsqueda (como el ID de una campaña específica o un rango de fechas) y el componente se encarga de hablar con los servidores de Mailchimp y traer la información de vuelta a tu dashboard.

Imagina que es como hacer una búsqueda avanzada en el sistema de correo de Mailchimp, pero en lugar de ver los resultados en una pantalla, los “pasas” directamente a otros nodos o automatizaciones en Nappai para su uso.

Conexión y Credenciales

Este componente requiere que hayas configurado previamente tu cuenta de Mailchimp en Nappai para poder interactuar con el servicio externo:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial del tipo Mailchimp API y guarda los campos requeridos (específicamente tu API Key, la cual puedes encontrar en la configuración de tu cuenta de Mailchimp).
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. Cada campo te ayuda a refinar la búsqueda de campañas en tu cuenta de Mailchimp:

Operation: El tipo de acción principal a realizar. En este componente, las operaciones se gestionan a través de la lógica de conexión y credenciales, enfocándose en la recuperación de datos.
- Visible en: Todas las operaciones
Max Results: Define el número máximo de campañas o registros que deseas recuperar en una sola ejecución. Es útil si solo necesitas ver los datos más recientes o limitar la carga de trabajo.
- Visible en: Todas las operaciones
Campaign ID: El identificador único de una campaña específica en Mailchimp. Si proporcionas un ID, el componente ignorará cualquier otro filtro y te devolverá únicamente la información de esa campaña concreta. Si lo dejas vacío, se devolverán todas las campañas disponibles (sujeto a otros filtros).
- Visible en: Todas las operaciones
Aply Filters: Un interruptor para activar o desactivar el uso de filtros adicionales. Si está activado, el componente considerará los criterios especificados en los campos siguientes (como Estado, Tipo, Fechas) para restringir la búsqueda.
- Visible en: Todas las operaciones
Filter By: Permite seleccionar en qué categoría específica deseas filtrar tus campañas (por ejemplo, por estado, tipo, o fechas de creación). Puedes seleccionar múltiples opciones para afinar más la búsqueda.
- Visible en: Todas las operaciones
Status: Filtra las campañas según su estado actual (por ejemplo: “Sent”, “Saving”, “Paused”). Solo afecta a la búsqueda si el filtro está activado.
- Visible en: Todas las operaciones
Type: Filtra las campañas según su tipo de envío (por ejemplo: “Regular”, “Automated”, “RSS”).
- Visible en: Todas las operaciones
Before Create Time: Especifica una fecha y hora límite para filtrar campañas creadas antes de ese momento. Útil para encontrar campañas antiguas.
- Visible en: Todas las operaciones
After Create Time: Especifica una fecha y hora límite para filtrar campañas creadas después de ese momento. Ideal para encontrar campañas recientes.
- Visible en: Todas las operaciones
Before Send Time: Restringe la respuesta a campañas que se enviaron antes de la fecha y hora establecida.
- Visible en: Todas las operaciones
After Send Time: Restringe la respuesta a campañas que se enviaron después de la fecha y hora establecida.
- Visible en: Todas las operaciones
Report Type: El tipo de informe o reporte que deseas recuperar para las campañas seleccionadas (si la API lo permite).
- Visible en: Todas las operaciones

Salidas

Al ejecutar este componente, el principal resultado que obtendrás es:

Data: Este campo contendrá la información completa y estructurada sobre las campañas solicitadas. Dependiendo de los filtros y el ID utilizado, podrás obtener desde una lista breve hasta detalles completos de una campaña específica. Esta salida es una variable de tipo “Any”, lo que significa que puedes conectarla a otros componentes para leer valores específicos, comparar datos o incluso transformar la información.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo estructurado de cómo se ve el objeto Data cuando se recuperan detalles de una campaña exitosamente. Este formato te ayudará a entender qué datos están disponibles para conectar en los siguientes pasos de tu flujo: json { “status”: “success”, “campaigns”: [ { “id”: “abc123456”, “name”: “Newsletter Mensual Octubre”, “type”: “regular”, “status”: “sent”, “send_time”: “2023-10-01T09:00:00+00:00”, “lists”: [ { “id”: “list001”, “name”: “Suscriptores Principales” } ], “settings”: { “from_name”: “Mi Empresa”, “from_email”: “contacto@miempresa.com”, “subject”: “Ofertas de Octubre” }, “performance”: { “emails_sent”: 150, “open_rate”: “25.5%”, “click_rate”: “3.2%” } } ], “total_results”: 1 }

Conectividad

Aunque no hay datos estadísticos predefinidos de conexiones externas, lógicamente este componente se conecta mejor con nodos que procesan o visualizan datos. Por ejemplo:

Con nodos de “Análisis de Datos” o “Formatear Texto”: Para limpiar o extraer estadísticas específicas (como la tasa de apertura) de la salida Data y calcular métricas personalizadas.
Con nodos de “Base de Datos” o “CRM”: Para guardar el historial de campañas en tu propio sistema de gestión si Mailchimp no almacena los datos de forma permanente o accesible para otros procesos.
Con nodos de “Lógica” (If/Else): Para tomar decisiones basadas en el estado de la campaña (ej. “Si el estado es ‘Sent’, entonces enviar un mensaje de confirmación”).

Ejemplo de Uso

Imagina que quieres verificar el rendimiento de tu última campaña de ventas antes de generar un reporte mensual.

Añades el componente Campaign.
En el campo After Create Time, indicas la fecha de hace 7 días para asegurar que solo ves campañas recientes.
En Status, seleccionas “Sent” para ignorar borradores.
El componente devuelve la lista de campañas enviadas en los últimos 7 días.
Conectas el nodo siguiente para leer el campo open_rate de cada campaña y calcular el promedio general en tu dashboard.

Consejos y Mejores Prácticas

Usa el ID cuando sea posible: Si ya conoces el ID de una campaña específica, úsalo en el campo Campaign ID. Esto evita que el sistema analice todas tus campañas y hace la automatización mucho más rápida y precisa.
Limita los resultados: Si solo necesitas verificar una campaña reciente, usa Max Results con un número bajo (ej. 1 o 10) para evitar cargar información innecesaria en el flujo.
Combina filtros: Usa Aply Filters junto con Status y Type para obtener una vista muy específica de tu correo marketing (ej. “Solo campañas automatizadas enviadas en el último mes”).

Consideraciones de Seguridad

Este componente utiliza una API Key para acceder a tu cuenta de Mailchimp. Asegúrate de:

Nunca compartir tu API Key públicamente.
Configurar la credencial en la sección segura de Credenciales de Nappai, no escribirla manualmente en los campos de entrada si evitas hacerlo, ya que el campo de conexión maneja la seguridad de la clave.
Revocar las claves antiguas si ya no las usas para mantener tu cuenta segura.