powermail para TYPO3

powermail é o sistema de formulários pronto para produção do TYPO3

Entre o Form Framework do core TYPO3 e as ferramentas completas de marketing automation existe, na prática, uma lacuna: equipes editoriais querem construir formulários sem código, com lógica condicional, upload de arquivos, consentimento LGPD (PT: RGPD), encaminhamento a CRM e exportação PDF limpa. É exatamente para isso que o powermail foi construído. A extensão da in2code é o plugin de formulário mais instalado no ecossistema TYPO3 e roda na maior parte dos projetos TYPO3 médios e grandes que a Gosign atende. Desde a primeira versão, há mais de uma década, o powermail se consolidou como o canivete suíço do desenvolvimento de formulários TYPO3 e continua sendo uma escolha válida mesmo quando o Form Framework do core teoricamente seria suficiente.

Cenários típicos vão de formulários de contato a portais de candidatura

O cenário mais frequente é trivial mas inevitável: formulários de contato em sites corporativos que enviam emails a diferentes departamentos. O powermail permite isso via rotas de destinatário condicionais, sem intervenção de desenvolvedores. Redatores mantêm os campos no backend como um conteúdo de página, incluindo ordem, campos obrigatórios e validação. Uma instalação corporativa típica tem três a cinco variantes de formulário: solicitação geral, contato de imprensa, carreira, suporte e consultoria de produto. Cada variante chega à inbox certa via filtro de destinatário próprio.

Muito mais exigentes são formulários de candidatura em várias etapas, como em instituições públicas e universidades brasileiras. Um portal de candidatura pergunta no passo 1 os dados cadastrais, no passo 2 o curso desejado, no passo 3 históricos escolares via upload e no passo 4 um consentimento LGPD com link para a política de privacidade. O powermail renderiza os quatro passos a partir de um único registro de formulário e guarda o progresso entre os passos em uma sessão, de modo que o candidato possa voltar se precisar. Condições exibem ou ocultam campos conforme respostas anteriores, o que em formulários complexos como pedidos de bolsa ou inscrições em pós-graduação torna uma quantidade de três dígitos de combinações de campo manejável.

Um terceiro cenário que distingue o powermail de extensões mais simples é a integração com CRM e ferramentas de marketing. A arquitetura de finishers permite enviar dados em paralelo a HubSpot, Salesforce, Brevo ou a um webhook próprio antes do email de confirmação ser enviado. Na Gosign, o powermail é também a ferramenta padrão para formulários de leads que alimentam diretamente o processo de vendas. Em um projeto enterprise, conectamos o powermail ao Salesforce Marketing Cloud e simultaneamente encaminhamos via webhook ao sistema interno de tickets, de forma que times de vendas e suporte acessem o contato em paralelo.

Arquitetura técnica separa definição de formulário, finishers e template

O powermail é formado por três camadas conceituais: a definição do formulário no backend, os finishers executados após o envio e os templates Fluid responsáveis pela renderização. Cada camada é extensível sem fazer fork. Essa separação clara faz do powermail uma ferramenta robusta para projetos TYPO3 de longa vida, nos quais formulários são mantidos e estendidos por anos.

Formulários são criados como registros em tx_powermail_domain_model_form. Cada formulário contém pages (passos), cada page contém fields. Os tipos de campo vão de texto, email, select, radio, file upload até html content e checkboxes de consentimento. A lógica condicional é mantida via módulo Conditions: “Mostrar campo B apenas se campo A tiver valor X”.

Finishers são a real força da extensão. O finisher padrão envia emails, grava entradas no banco e gera exportações PDF. Outros finishers podem ser implementados via FinisherInterface: envio por webhook, sincronização CRM, Salesforce, entrega a SAP. A ordem dos finishers é configurável, e cada finisher pode abortar o processo em caso de erro.

Templates ficam como arquivos Fluid no caminho EXT e costumam ser sobrescritos via SiteSet ou site package próprio. Isso significa: um único template overlay global basta para dar design uniforme a todos os formulários de um site. Quem precisa de templates próprios por formulário pode reconfigurar os caminhos de template via TypoScript e manter um conjunto por tipo de formulário.

Problemas frequentes envolvem spam, LGPD e entrega de email

O tema dominante de suporte em formulários powermail públicos é spam. Out of the box, a extensão traz campos honeypot, verificação de timestamp e um ReCaptcha v3 opcional via ext:powermailrecaptcha. Ainda assim, spam chega ao backend quando a administração não ativa os mecanismos de verificação. Recomendamos combinar em todo formulário honeypot E ReCaptcha, adicionando um finisher de rate limit por IP.

O segundo problema é conformidade com a LGPD. Consentimentos de formulário precisam ser documentados de forma auditável: data, versão da política de privacidade, IP e user-agent. A extensão oferece o Consent Storage, que registra consentimentos separadamente e os torna exportáveis para auditorias.

Em terceiro lugar, entregabilidade de email é tema constante. Emails de confirmação caem em spam porque o remetente não está autenticado. SPF, DKIM e DMARC precisam estar corretamente configurados no nível do servidor de email, e a configuração powermail deve definir um Return-Path e um Reply-To válido. Em instalações grandes, recomendamos adicionalmente um serviço dedicado de email transacional como Brevo, Mailgun ou Amazon SES, para que a taxa de entrega não sofra com a reputação geral do servidor.

TYPO3 v12 e v13 são totalmente suportados

O powermail fica disponível rapidamente em cada release TYPO3 LTS, porque a in2code mantém a extensão ativamente. A série atual suporta TYPO3 v11, v12 e v13 em paralelo. No upgrade de instalações antigas, os breaking changes afetam sobretudo classes finisher próprias, que precisam ser adaptadas à assinatura de interface atual, e templates Fluid que reagem a mudanças de ViewHelper.

A Gosign migra instalações powermail tipicamente junto com o upgrade do core TYPO3. Antes do salto, verificamos quais finishers e templates próprios existem, quais integrações de terceiros estão conectadas e se variantes antigas de plugin ainda estão em uso. A migração costuma acontecer sem migração de dados, porque a estrutura de registro da definição de formulário permanece estável.