Mailchimp para TYPO3

La extensión mailchimp lleva las suscripciones, con sus grupos de intereses, directamente a listas de Mailchimp

Como koning_mailchimp_signup, la extensión mailchimp es un formulario de suscripción: los visitantes se inscriben en la web en una lista concreta de Mailchimp. Pero llega más lejos que la extensión anterior, que termina en TYPO3 8: los redactores eligen en el elemento de contenido la lista y, si lo desean, un grupo de intereses; el formulario es una plantilla Fluid que se adapta libremente, y desde la versión 3.0.0 una sola instalación TYPO3 da servicio a varias cuentas de Mailchimp. La extensión no ofrece conciliación de listas completas, cifras de campañas en el backend ni plantillas de newsletter a partir de contenidos TYPO3; cada suscripción va directamente a la API de Mailchimp, sin necesidad de tareas de sincronización.

Aun así, el aspecto del RGPD sigue siendo central: con cada suscripción se envían a Mailchimp la dirección de correo, el nombre y los apellidos, los grupos de intereses elegidos y, si se desea, hasta diez campos adicionales. Sin contrato de encargado del tratamiento con Mailchimp y mecanismo de transferencia a EE.UU. documentado, esto no es conforme con la normativa de protección de datos española y europea.

Los escenarios típicos son la suscripción a la newsletter, la elección de temas y varias marcas

El escenario principal es la suscripción a la newsletter en la web. Los visitantes introducen su dirección de correo y su nombre, la extensión los da de alta en la lista elegida con el estado “pending” y Mailchimp envía el correo de confirmación del Double-Opt-In. La dirección solo queda activa al hacer clic en el enlace de confirmación. La lista, las bajas y los rebotes los gestiona Mailchimp; la extensión no crea tablas propias en TYPO3.

Segundo escenario: elección de temas mediante grupos de intereses. Quien ofrece varias newsletters o temas crea en Mailchimp un grupo de intereses, y el formulario muestra los temas como casillas de verificación, botones de opción o lista desplegable, según el tipo de grupo. La suscripción llega a la lista con los temas elegidos, de modo que marketing puede hacer envíos específicos a grupos concretos desde Mailchimp.

Tercer escenario: varias marcas o países en una instalación TYPO3. Desde la versión 3.0.0 se pueden guardar varias API Keys con su nombre, y los redactores eligen en el elemento de contenido a qué cuenta de Mailchimp y a qué lista va cada formulario. En el módulo de página, la extensión muestra para cada formulario la cuenta, la lista, el grupo de intereses y el número actual de suscriptores; las tasas de apertura y de clic, en cambio, solo las ve quien tiene acceso al dashboard de Mailchimp.

La arquitectura técnica llama a la API v3 de Mailchimp directamente al enviar el formulario

La extensión se comunica a través de la Mailchimp Marketing API v3, mediante una librería PHP incluida. La autenticación se realiza mediante una API Key configurada en el Extension Manager de TYPO3. No hay tarea Scheduler: cada suscripción va directamente a Mailchimp al enviar el formulario.

Al enviar el formulario, la extensión da de alta al miembro en la lista elegida: con Double-Opt-In en el estado “pending” y, sin él, directamente como “subscribed”. Si la dirección ya figura en la lista pero no está suscrita, actualiza la entrada; el ID de miembro es el hash MD5 de la dirección de correo. Si la dirección ya está suscrita, el formulario muestra un aviso.

El formulario es una plantilla Fluid que se puede sobrescribir en el sitepackage propio. Con la extensión typoscript_rendering se envía por Ajax, sin recargar la página. La dirección de correo se puede rellenar de antemano mediante un parámetro GET o POST, por ejemplo cuando otro formulario remite a la suscripción.

Los campos adicionales los integra un desarrollador mediante un hook: el formulario admite hasta diez campos adicionales, y el hook define su correspondencia con los campos de Mailchimp. La extensión no tiene módulo backend propio ni indicadores de campañas.

Los problemas habituales son los campos obligatorios, las direcciones ya existentes y el Double-Opt-In desactivado

Problema uno: campos obligatorios. Si en Mailchimp se marcan campos como obligatorios, la extensión, según su documentación, no puede comprobarlo en el servidor; si falta uno de esos campos, el formulario solo muestra un error genérico. La solución: marcar los mismos campos como obligatorios en la plantilla Fluid y comprobarlos antes del envío.

Problema dos: direcciones que ya están en la lista. Si una dirección ya está suscrita, Mailchimp rechaza la segunda suscripción y el formulario indica que la dirección ya está registrada. Las direcciones que se dieron de baja antes, en cambio, la extensión las vuelve a dar de alta. La solución: formular el mensaje de forma comprensible en el archivo de idioma, para que nadie crea que la suscripción ha fallado.

Problema tres: desactivar el Double-Opt-In. Por defecto, la extensión solicita la confirmación por correo electrónico. Solo quien ha desactivado el Double-Opt-In en Mailchimp lo desactiva también en la extensión con el ajuste skipDoubleOptIn; la documentación aconseja usarlo siempre. En la UE es además la vía habitual para acreditar el consentimiento conforme al art. 7.1 RGPD.

Un cuarto problema afecta a los servidores detrás de un proxy. La extensión solo llega a la API de Mailchimp si el proxy y el puerto están indicados en la configuración de la extensión; además hay una opción para forzar la conexión por IPv4. Si faltan estos ajustes, ninguna suscripción llega a Mailchimp, y TYPO3 tampoco guarda las direcciones.

La extensión termina en TYPO3 v10, para las versiones actuales se recomienda una integración directa con la API

La extensión mailchimp del TER se publicó por última vez en enero de 2021 (versión 3.2.0) y soporta TYPO3 v9 y v10; para versiones más recientes de TYPO3 no hay release. Dado que la API v3 de Mailchimp es estable y está bien documentada, Gosign recomienda para proyectos TYPO3 actuales una integración directa con la API sin dependencia de extensión. Una clase Service personalizada en un paquete TYPO3 propio que llame directamente a la API de Mailchimp tiene menor mantenimiento que una extensión de la comunidad.

Las empresas que quieran permanecer a largo plazo con Mailchimp deberían además evaluar la función Webhook de Mailchimp: en lugar de consultar datos periódicamente, Mailchimp envía eventos (suscripción, baja, rebote) activamente a un endpoint TYPO3. Esto reduce la latencia de minutos a segundos y elimina la carga de consultas API periódicas.