powermail para TYPO3

powermail es el sistema de formularios listo para producción en TYPO3

Entre el Form Framework del núcleo TYPO3 y las suites completas de Marketing Automation, en la práctica queda un hueco: las redacciones quieren construir formularios sin código, con lógica condicional, subida de archivos, consentimiento RGPD, reenvío a CRM y exportación PDF limpia. Exactamente para eso está construido powermail. La extensión de in2code es el plugin de formularios más instalado del ecosistema TYPO3 y corre en la gran mayoría de los proyectos TYPO3 medianos y grandes que Gosign gestiona. Desde su primera versión hace más de una década, powermail se ha convertido en la navaja suiza del desarrollo de formularios TYPO3 y sigue siendo una elección válida incluso cuando el Form Framework del núcleo bastaría en teoría.

Escenarios típicos: desde formularios de contacto hasta portales de candidaturas

El escenario más frecuente es trivial pero inevitable: formularios de contacto en sitios corporativos que envían correos a distintos departamentos. powermail lo permite mediante rutas de destinatario condicionales, sin que un desarrollador deba intervenir. Los redactores mantienen los campos en el backend como cualquier contenido de página, incluidos orden, campos obligatorios y validación. Una instalación corporativa típica tiene entre tres y cinco variantes de formulario: consulta general de contacto, contacto de prensa, empleo, soporte y asesoramiento de producto. Cada variante acaba, mediante un filtro de destinatario propio, en la bandeja correcta del departamento.

Claramente más exigentes son los formularios de candidatura multipaso, habituales en instituciones públicas y universidades como la UAM, UCM o la Universidad de Salamanca. Un portal de candidatura pregunta en el paso 1 los datos básicos, en el paso 2 la titulación deseada, en el paso 3 los expedientes mediante upload y en el paso 4 un consentimiento RGPD con enlace a la política de privacidad. powermail renderiza los cuatro pasos desde un único registro de formulario y almacena el progreso entre pasos en una sesión, de modo que el candidato puede retroceder si lo necesita. Las condiciones muestran u ocultan campos en función de respuestas anteriores, lo que en formularios complejos como solicitudes de becas o inscripciones de doctorado ordena un número de combinaciones de campos de tres cifras.

Un tercer escenario que distingue powermail de extensiones más sencillas es la integración con herramientas CRM y Marketing. La arquitectura de Finishers permite enviar los datos en paralelo a HubSpot, Salesforce, Brevo o un webhook propio antes de que salga el correo de confirmación al remitente. En Gosign powermail es por eso también la herramienta estándar para formularios de lead que alimentan directamente el proceso de ventas. En un proyecto enterprise hemos conectado powermail a Salesforce Marketing Cloud y lo hemos reenviado simultáneamente mediante webhook al sistema interno de tickets, de modo que los equipos de Sales y Support pueden acceder a la consulta en paralelo.

Arquitectura técnica: separación de definición de formulario, finishers y plantilla

powermail consta de tres niveles conceptuales: la definición del formulario en el backend, los Finishers que se ejecutan tras el envío, y las plantillas Fluid que se encargan del renderizado. Cada nivel es ampliable sin forkear la extensión. Esa separación clara hace de powermail una herramienta robusta para proyectos TYPO3 de larga vida, en los que los formularios se mantienen y amplían a lo largo de años.

Los formularios se crean como registros en tx_powermail_domain_model_form. Cada formulario contiene Pages (pasos), cada Page contiene campos. Los tipos de campo van de texto, correo, select, radio, subida de archivos hasta contenido HTML y casillas de consentimiento. La lógica condicional se mantiene a través del módulo Conditions: “muestra el campo B solo si el campo A tiene el valor X”.

Los Finishers son la verdadera fuerza de la extensión. El Finisher estándar envía correos, guarda entradas en base de datos y genera exportaciones PDF. Pueden implementarse más Finishers a través del FinisherInterface: envío de webhook, sync CRM, Salesforce, traspaso a SAP. El orden de los Finishers es configurable, y cada Finisher puede abortar el proceso en caso de error.

Las plantillas están como ficheros Fluid en el path EXT y se sobrescriben típicamente mediante SiteSet o paquete propio. Eso significa: basta una única capa global de plantilla para dar un aspecto uniforme a todos los formularios de un sitio. Quien necesita plantillas propias por formulario puede reconfigurar los paths de plantilla mediante TypoScript y mantener un set de plantillas por tipo de formulario.

Problemas frecuentes: spam, RGPD y entregabilidad del correo

El tema dominante de soporte en formularios powermail públicos es el spam. De fábrica la extensión trae campos honeypot, comprobación de timestamp y un reCAPTCHA v3 opcional a través de ext:powermailrecaptcha. Aun así el spam acaba en el backend si la administración no ha activado los mecanismos de verificación. Recomendamos combinar en cada formulario honeypot Y reCAPTCHA y, adicionalmente, usar un Finisher de rate limit basado en IP.

El segundo problema es la conformidad con el RGPD. Los consentimientos en formularios deben quedar documentados de forma revisable: fecha, versión de la política de privacidad, IP y user agent. La AEPD exige esa documentación con especial rigor en auditorías. La extensión ofrece para ello el Consent Storage, que registra los consentimientos por separado y permite exportarlos para auditorías.

En tercer lugar la entregabilidad del correo es un tema constante. Los correos de confirmación acaban en spam porque el remitente no está autenticado. SPF, DKIM y DMARC deben estar correctamente configurados a nivel del servidor de correo, y la configuración de powermail debería fijar un Return-Path y un Reply-To válido. En instalaciones grandes recomendamos adicionalmente un servicio de correo transaccional dedicado como Brevo, Mailgun o Amazon SES, para que la tasa de entrega no se resienta de la reputación general del servidor.

TYPO3 v12 y v13 están totalmente soportados

powermail está disponible de forma inmediata para cada release LTS de TYPO3, porque in2code mantiene la extensión activamente. La serie actual soporta TYPO3 v11, v12 y v13 en paralelo. Al actualizar instalaciones más antiguas, los Breaking Changes afectan sobre todo a clases Finisher propias, que deben adaptarse a la firma de interfaz actual, así como a plantillas Fluid que reaccionan a cambios en los ViewHelpers.

Gosign migra instalaciones powermail típicamente junto con el upgrade del núcleo TYPO3. Antes del salto comprobamos qué Finishers y plantillas propios existen, qué integraciones de terceros están conectadas y si quedan variantes de plugin obsoletas en uso. La migración transcurre casi siempre sin migración de datos, porque la estructura de registro de la definición de formulario se mantiene estable.