Mailchimp

Descripcion

Este modulo proporciona una integracion completa con Mailchimp Marketing API v3.0. Las operaciones se organizan en las siguientes categorias:

• 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: Suscripcion masiva de miembros con opcion de actualizar existentes.

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

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Mailchimp
operation	select	Si	Operacion a realizar (getLists, addMember, sendCampaign, etc.)

Parametros comunes segun operacion:

Parametro	Tipo	Requerido	Descripcion
listId	text	Segun operacion	ID de la audiencia/lista
email	text	Segun operacion	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	Segun operacion	ID de la campana
subjectLine	text	Segun operacion	Linea de asunto de campana
fromName	text	Segun operacion	Nombre del remitente
replyTo	text	Segun operacion	Email de respuesta
count	text	No	Cantidad de resultados (default: 100)
offset	text	No	Desplazamiento para paginacion

Credenciales

Requiere credenciales de tipo Mailchimp con:

• apiKey: API Key de Mailchimp (formato: xxxxx-usXX donde usXX es el datacenter)
• La autenticacion 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 basico - Anadir 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 operacion 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 operacion batchSubscribe permite suscripcion 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 operacion disponible