Mailchimp

Descripción

Este modulo proporciona una integración completa con Mailchimp Marketing API v3.0. Las operaciones se organizan en las siguientes categorías:

Audiencias/Listas: Listar, crear, obtener, actualizar y eliminar audiencias.
Suscriptores/Miembros: Listar, anadir, obtener, actualizar, anadir/actualizar (upsert), archivar y eliminar permanentemente suscriptores. Soporta merge fields (FNAME, LNAME, campos personalizados) y tags.
Tags: Listar tags de una lista, anadir y quitar tags de un miembro, obtener tags de un miembro.
Campanas: Listar, crear, obtener, actualizar, eliminar, enviar, programar, desprogramar, pausar, reanudar, replicar y enviar email de prueba. Gestionar contenido de campanas.
Templates: Listar, obtener, crear, actualizar y eliminar plantillas.
Segmentos: Listar, crear, obtener, actualizar, eliminar segmentos. Anadir y quitar miembros de segmentos.
Merge Fields: Listar, crear, actualizar y eliminar campos personalizados.
Informes: Obtener informe de campana, detalles de clics, aperturas, desuscripciones y rebotes.
Automatizaciones: Listar, obtener, pausar, iniciar automatizaciones y agregar suscriptores.
Cuenta: Obtener info de cuenta y ping de conectividad.
Batch: Suscripción masiva de miembros con opción de actualizar existentes.

La API key de Mailchimp contiene el datacenter (formato: xxxxx-dc), que se extrae automáticamente para construir la URL base.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales de Mailchimp
operation	select	Si	Operación a realizar (getLists, addMember, sendCampaign, etc.)

Parámetros comunes según operación:

Parámetro	Tipo	Requerido	Descripción
listId	text	Según operación	ID de la audiencia/lista
email	text	Según operación	Email del suscriptor
firstName	text	No	Nombre (merge field FNAME)
lastName	text	No	Apellido (merge field LNAME)
status	text	No	Estado: subscribed, unsubscribed, cleaned, pending
tags	text	No	Tags separados por coma
mergeFields	text	No	Campos adicionales en JSON
campaignId	text	Según operación	ID de la campana
subjectLine	text	Según operación	Línea de asunto de campana
fromName	text	Según operación	Nombre del remitente
replyTo	text	Según operación	Email de respuesta
count	text	No	Cantidad de resultados (default: 100)
offset	text	No	Desplazamiento para paginación

Credenciales

Requiere credenciales de tipo Mailchimp con:

apiKey: API Key de Mailchimp (formato: xxxxx-usXX donde usXX es el datacenter)
La autenticación se realiza mediante Basic Auth con la API key

Salida

{
  "lists": [
    {
      "id": "abc123def4",
      "name": "Mi Audiencia Principal",
      "stats": { "member_count": 1500 }
    }
  ]
}

Ejemplo de Uso

Caso básico - Añadir suscriptor

{
  "credentials_id": "mi-mailchimp",
  "operation": "addMember",
  "listId": "abc123def4",
  "email": "nuevo@cliente.com",
  "firstName": "Juan",
  "lastName": "Garcia",
  "status": "subscribed",
  "tags": "cliente-nuevo,web"
}

API Utilizada

Mailchimp Marketing API v3.0 (https://{dc}.api.mailchimp.com/3.0)

Notas

El email del suscriptor se hashea con MD5 internamente (requisito de Mailchimp API)
La operación addOrUpdateMember (upsert) es ideal para evitar errores con suscriptores existentes
Al crear campanas, se puede especificar un segmento con segmentId
Los merge fields personalizados se pasan como JSON en el campo mergeFields
La operación batchSubscribe permite suscripción masiva pasando un array JSON de miembros
Los errores de la API se capturan y se reportan con el detalle de Mailchimp

Nodos Relacionados

Mailchimp List Audiences (sub-nodo)
Otros sub-nodos por cada operación disponible