Mailchimp
Proporciona integración con el servicio de envío de correos electrónicos Mailchimp, permitiendo la gestión de audiencias, formularios de suscripción, creación de campañas y seguimiento de eventos de comportamiento desde Drupal.
mailchimp
Install
composer require 'drupal/mailchimp:^3.1'
composer require 'drupal/mailchimp:^2.2'
Overview
El módulo Mailchimp proporciona una integración completa con el servicio de envío de correos electrónicos Mailchimp. Aunque existen herramientas para enviar correos electrónicos desde tu propio servidor, carecen de la sofisticación y facilidad de uso de proveedores de correo electrónico dedicados como Mailchimp.
El módulo principal proporciona configuración básica e integración con API, mientras que las características y funcionalidades del sitio son proporcionadas por un conjunto de submódulos. Estos submódulos permiten formularios de registro anónimo, suscripciones de audiencia basadas en entidades, creación y envío de campañas, y seguimiento de eventos de comportamiento para automatización de marketing.
Las capacidades clave incluyen autenticación OAuth (recomendada) o autenticación por clave API (obsoleta), soporte para audiencias ilimitadas, mapeo de campos de combinación, grupos de interés, integración con Connected Sites, manejo de webhooks para sincronización en tiempo real y procesamiento por lotes basado en cron para operaciones de suscripción.
Features
- Integración API con Mailchimp usando autenticación OAuth (recomendada) o clave API (obsoleta)
- Soporte para audiencias ilimitadas de Mailchimp (listas de correo)
- Formularios de registro anónimo mostrados como bloques o páginas independientes para cualquier combinación de audiencias
- Suscripción de audiencia basada en entidades mediante tipos de campo personalizados, permitiendo que las reglas de suscripción sigan los permisos y controles de la entidad
- Suscripción de usuarios durante el registro añadiendo un campo de suscripción Mailchimp a Users
- Mapeo de valores de campos de entidades de Drupal a campos de combinación de Mailchimp
- Formularios independientes de suscripción y cancelación de suscripción con soporte para campos de combinación y grupos de interés
- Mantenimiento de suscripciones mediante procesamiento por lotes de cron o actualizaciones en tiempo real
- Crear y enviar campañas de Mailchimp directamente desde Drupal usando contenido de entidades
- Seguimiento de eventos de comportamiento para las campañas automatizadas de Mailchimp
- Integración de webhooks para sincronización en tiempo real de cambios de suscripción desde Mailchimp
- Integración con Connected Sites para incrustar JavaScript de Mailchimp y formularios emergentes
- Soporte de casilla de consentimiento GDPR para formularios de registro
- Integración con el módulo ECA (Entity Control Actions) para flujos de trabajo de automatización
- Manejador de Webform para activar eventos de Mailchimp en envíos de formularios
Use Cases
Suscripción a boletín para visitantes del sitio web
Crea formularios de registro anónimos usando el submódulo Mailchimp Signup. Muestra formularios como Blocks en barras laterales o pies de página, o como páginas independientes como /newsletter. Configura merge fields para recopilar información adicional como nombre o preferencias, y habilita grupos de interés para que los suscriptores elijan categorías de contenido. Usa la casilla de consentimiento GDPR para cumplimiento normativo.
Registro de usuarios con suscripción a audiencia
Agrega un Field de Mailchimp Subscription al tipo de Entity User usando el submódulo Mailchimp Audiences. Los usuarios pueden suscribirse durante el registro o gestionar su suscripción desde su perfil. Mapea Fields del perfil de usuario (nombre, ubicación, etc.) a merge fields de Mailchimp para contenido de correo personalizado.
Suscripciones automáticas basadas en roles
Usa la integración con Rules o ECA para suscribir automáticamente a usuarios a audiencias específicas según sus roles. Crea un Field oculto de Mailchimp Subscription en Users y configura reglas de automatización para suscribir miembros cuando se les asignan roles particulares (ej., audiencia de Miembros Premium para el rol premium).
Campañas de correo con contenido de Drupal
Usa el submódulo Mailchimp Campaign para crear campañas de correo que incluyan contenido de Drupal. Importa artículos, productos o cualquier Entity con título en plantillas de campaña usando la función de importación de Entity. Selecciona view modes específicos para controlar cómo aparece el contenido en los correos.
Segmentación por comportamiento para comercio electrónico
Usa el submódulo Mailchimp Events con integración de Webform para rastrear el comportamiento del usuario. Crea eventos como 'completed_purchase' o 'abandoned_cart' que activen secuencias de correo automatizadas en Mailchimp. Pasa detalles del pedido o información del producto como propiedades del evento para correos de seguimiento personalizados.
Sincronización de suscripciones en tiempo real
Configura webhooks para mantener Drupal sincronizado con Mailchimp. Cuando los usuarios se dan de baja o actualizan sus perfiles directamente en Mailchimp (ej., mediante el enlace de preferencias de correo), el webhook actualiza los datos de suscripción en caché en Drupal, asegurando una visualización precisa del estado de suscripción.
Formularios de suscripción a múltiples audiencias
Crea formularios de registro que permitan la suscripción a múltiples audiencias simultáneamente. Útil para organizaciones con diferentes tipos de boletines (ej., Noticias, Eventos, Promociones) donde los visitantes pueden seleccionar qué comunicaciones desean recibir.
Connected Sites con formularios emergentes
Habilita Connected Sites para incrustar el JavaScript de Mailchimp en páginas específicas. Esto permite usar los formularios de suscripción emergentes de Mailchimp que pueden diseñarse en Mailchimp y activarse según el comportamiento del usuario (tiempo en la página, profundidad de desplazamiento, intención de salida).
Tips
- Usa autenticación OAuth en lugar de API keys - la autenticación con API key está obsoleta y OAuth proporciona mejor seguridad
- Configura webhooks para mantener Drupal sincronizado cuando los usuarios modifican sus suscripciones directamente a través de Mailchimp
- Usa procesamiento por lotes para sitios con muchos suscriptores para evitar problemas de tiempo de espera, pero ten en cuenta que los cambios no aparecerán hasta que se ejecute cron
- La función Connected Sites te permite usar los formularios emergentes de Mailchimp sin ninguna configuración de formulario en Drupal
- Al crear campañas, usa el botón 'Preview content' para verificar que los tokens de Entity se rendericen correctamente antes de guardar
- Los grupos de interés proporcionan preferencias de suscriptor más granulares que las etiquetas - usa grupos para opciones orientadas al suscriptor y etiquetas para organización interna
- La configuración de doble opt-in ayuda a mantener la calidad de la lista y puede mejorar la entregabilidad al confirmar direcciones de correo válidas
- Mapea Fields de Entity a merge fields para habilitar la personalización en campañas de Mailchimp usando merge tags como *|FNAME|*
- Para depurar Mailchimp Events, habilita el submódulo mailchimp_events_example para probar manualmente la creación y recuperación de eventos
Technical Details
Admin Pages 9
/admin/config/services/mailchimp
Configura los ajustes globales de Mailchimp, incluyendo el método de autenticación, tiempo de espera de la API, sitios conectados, procesamiento por lotes y configuración de webhooks.
/admin/config/services/mailchimp/oauth
Configura y completa la autenticación OAuth con Mailchimp. Este es el método de autenticación recomendado.
/admin/config/services/mailchimp/lists
Ver y gestionar las audiencias de Mailchimp sincronizadas con tu sitio Drupal. Configura los ajustes de webhook para cada audiencia.
/admin/config/services/mailchimp/list_cache_clear
Limpia los datos de audiencia en caché para actualizar la información desde Mailchimp.
/admin/config/services/mailchimp/fields
Ver todos los campos de suscripción de Mailchimp configurados en los tipos de entidad de tu sitio Drupal. Proporciona funcionalidad de actualización por lotes para variables de combinación.
/admin/config/services/mailchimp/signup
Crea y gestiona formularios de suscripción anónimos para audiencias de Mailchimp. Los formularios pueden mostrarse como bloques o páginas independientes.
/admin/config/services/mailchimp/signup/add
Crea un nuevo formulario de suscripción de Mailchimp con modo de visualización configurable, selección de audiencia, campos de combinación, grupos de interés y configuración GDPR.
/admin/config/services/mailchimp/campaigns
Crea, visualiza, edita, envía y gestiona campañas de correo electrónico de Mailchimp directamente desde Drupal.
/admin/config/services/mailchimp/campaigns/add
Crea una nueva campaña de Mailchimp con selección de audiencia, configuración de plantilla e importación de contenido de entidades Drupal.
Permissions 4
Hooks 7
hook_mailchimp_subscribe_success
Realiza una acción tras suscribirse exitosamente a una audiencia.
hook_mailchimp_unsubscribe_success
Realiza una acción tras cancelar exitosamente la suscripción de una audiencia.
hook_mailchimp_process_webhook
Realiza una acción durante la ejecución de un webhook de Mailchimp. Se invoca cuando Mailchimp envía notificaciones de webhook para eventos como cancelaciones de suscripción o actualizaciones de perfil.
hook_mailchimp_lists_mergevars_alter
Modifica las mergevars antes de enviarlas a Mailchimp durante operaciones de suscripción o actualización.
hook_mailchimp_lists_interest_groups_alter
Modifica los grupos de interés antes de enviarlos a Mailchimp.
hook_mailchimp_campaign_alter
Modifica los destinatarios de la campaña y la plantilla antes de guardar en Mailchimp.
hook_mailchimp_campaign_content_alter
Modifica la plantilla de la campaña y el contenido filtrado antes de enviar.
Troubleshooting 8
Limpia la caché de Drupal y recarga la página. El módulo almacena en caché los datos de Mailchimp para mejorar el rendimiento. También puedes usar el botón 'Refresh Audiences' en la página de configuración o el botón 'Refresh current template' en el formulario de campaña.
Verifica si la campaña ya ha sido enviada. Las campañas enviadas no pueden editarse en Mailchimp ni en Drupal.
Los webhooks de Mailchimp requieren una URL accesible públicamente. El sistema de Mailchimp no puede alcanzar entornos de desarrollo locales. Usa un servicio de túnel como ngrok para exponer tu sitio local para pruebas de webhooks.
Habilita las ventanas emergentes para tu sitio en tu navegador. El flujo de autenticación OAuth abre una nueva ventana para el inicio de sesión de Mailchimp. Si está bloqueada, puedes ver un estado de autenticación incompleto.
Si el procesamiento por lotes está habilitado, los cambios de suscripción se encolan para procesamiento por cron. Los cambios aparecerán después de la siguiente ejecución de cron. Para actualizaciones inmediatas, deshabilita el procesamiento por lotes en la configuración o ejecuta cron manualmente.
Asegúrate de haber creado al menos una audiencia en tu cuenta de Mailchimp. Limpia la caché de audiencias usando la página 'Reset Mailchimp Audience Cache'. También verifica que cada audiencia de Mailchimp solo puede asignarse a un Field de suscripción - si una audiencia ya está en uso, no aparecerá como opción para otros Fields.
Verifica que los Fields de Entity estén correctamente mapeados a los merge fields de Mailchimp en la configuración del Field de suscripción. Los Fields multivalor solo sincronizan su primer valor. Los merge fields requeridos deben mapearse a Fields de Entity requeridos o calculados.
Solo las plantillas HTML personalizadas con áreas de contenido editables correctamente definidas son completamente compatibles. Las plantillas de arrastrar y soltar no pueden editarse desde Drupal. Crea una plantilla HTML personalizada en Mailchimp con regiones mc:edit.
Security Notes 6
- El permiso 'administer mailchimp' otorga acceso a las credenciales de API y solo debe darse a administradores de confianza
- Los endpoints de webhook usan validación basada en hash - mantén tu hash de webhook secreto y cámbialo si se ve comprometido
- Los tokens OAuth se almacenan en el sistema de estado de Drupal - asegura controles de acceso adecuados a la base de datos y la API de estado
- Las API keys (si se usan) nunca deben exponerse en logs o mensajes de error - el módulo las oculta en la interfaz
- La funcionalidad de casilla de consentimiento GDPR ayuda con el cumplimiento normativo, pero las organizaciones deben asegurar que sus prácticas generales de privacidad cumplan los requisitos
- El JavaScript de Connected Sites se ejecuta en rutas especificadas - ten en cuenta qué páginas incluyen scripts externos por seguridad y rendimiento