registeraddress para TYPO3

Cadastro de newsletter sem serviços externos economiza custos e mantém os dados sob controle próprio

Mailchimp, Brevo, Rapidmail: a cada cadastro de newsletter, as organizações pagam por assinante e por e-mail enviado. Com 10.000 assinantes, isso chega a 100 a 300 euros por mês, só para administrar os endereços. O registeraddress oferece uma alternativa: cadastro de newsletter diretamente no TYPO3, pela consagrada tabela tt_address. Gestão de assinantes, Double-Opt-In, link de descadastro e documentação do consentimento em conformidade com a LGPD (PT: RGPD) rodam inteiramente no CMS, sem que um serviço externo tenha acesso aos dados dos assinantes.

Para associações, pequenas editoras e instituições públicas com restrições orçamentárias, essa é uma arquitetura válida, sobretudo quando o envio da newsletter passa por um serviço de SMTP relay barato, como o Amazon SES (0,10 dólar por 1.000 e-mails), ou pelo próprio servidor de e-mail.

Cenários típicos de uso abrangem newsletters de associações, listas de intranet e inscrições em eventos

O cenário mais frequente é a clássica newsletter de associação. Um clube esportivo com 2.000 associados oferece um formulário de cadastro no seu site TYPO3. Os visitantes informam o endereço de e-mail, recebem um e-mail de Double-Opt-In, confirmam e passam a constar da tabela tt_address. O clube envia mensalmente uma newsletter pela extensão direct_mail ou por um serviço de envio externo que importa os endereços da tt_address. O registeraddress cuida exclusivamente do cadastro e do descadastro, não do envio em si.

Um segundo cenário são as listas de distribuição na intranet das empresas. Os colaboradores se inscrevem em newsletters informativas internas, como “Unidade São Paulo - cardápio do refeitório” ou “Janelas de manutenção de TI”. Como os dados não podem sair da rede corporativa, um serviço de newsletter externo está descartado. O registeraddress administra as inscrições localmente, no banco de dados do TYPO3.

Terceiro cenário: inscrições em eventos com confirmação por e-mail. Uma biblioteca oferece eventos e usa o registeraddress como formulário de inscrição leve. O e-mail de confirmação enviado após o Double-Opt-In traz data, horário e local do evento. Não é uma solução completa de gestão de eventos, mas basta para instituições com cinco a dez eventos por mês.

A arquitetura técnica se apoia na tt_address e no fluxo de Double-Opt-In

O registeraddress é implementado como plugin Extbase e usa a tabela tt_address como banco de dados. Cada cadastro passa por um processo em três etapas: preenchimento do formulário, e-mail de Double-Opt-In com link de confirmação e ativação do registro após o clique no link. O link de confirmação contém um token assinado criptograficamente, que expira após um prazo configurável (padrão: 48 horas).

A extensão registra um plugin de frontend configurado via TypoScript: campos obrigatórios, campos opcionais (nome, empresa, forma de tratamento), texto de confirmação e templates de e-mail para o Double-Opt-In e a mensagem de boas-vindas. Os templates Fluid podem ser sobrescritos via SiteSet, para que o formulário se encaixe no design do site.

Para a conformidade com a LGPD, o registeraddress armazena o momento do consentimento, o endereço IP, o user agent e a versão da política de privacidade vinculada no formulário. Diante de uma solicitação da ANPD, é possível comprovar quando e em que condições o assinante consentiu.

Os descadastros passam por um link no rodapé da newsletter, que desativa (não exclui) o registro na tt_address, de modo que o histórico de consentimento é preservado. A eliminação definitiva conforme o art. 18, VI, da LGPD (eliminação dos dados tratados com consentimento) pode ser feita por um formulário de exclusão separado ou manualmente no backend.

Problemas frequentes envolvem e-mails de Double-Opt-In no spam e versões antigas da tt_address

O problema dominante é a entregabilidade do e-mail de Double-Opt-In. Se o e-mail de confirmação cai na pasta de spam, o assinante nunca conclui o cadastro. As causas estão quase sempre no servidor: falta de registro SPF, ausência de assinatura DKIM, ausência de política DMARC. O registeraddress em si não consegue melhorar a entregabilidade, porque esse é um tema do servidor de e-mail. Recomendamos verificar a autenticação de e-mail com o mail-tester.com antes de lançar um formulário de newsletter.

Segundo problema: incompatibilidade com versões antigas da tt_address. O registeraddress depende de determinados campos da tabela tt_address. Quando a tt_address publica uma atualização major e renomeia ou remove campos, o registeraddress deixa de gravar os registros corretamente. A solução: atualizar sempre tt_address e registeraddress em conjunto e, depois da atualização, testar todo o processo de cadastro.

Terceiro tema: cadastros feitos por bots. Sem mecanismo de proteção, bots preenchem o formulário com endereços falsos e geram milhares de e-mails de Double-Opt-In, que sobrecarregam o servidor de e-mail e prejudicam a reputação do remetente. O registeraddress suporta campos honeypot e pode ser combinado com sr_freecap ou hcaptcha para barrar bots.

O TYPO3 v12 é suportado; a compatibilidade com o v13 exige alinhamento com a tt_address

O registeraddress roda de forma estável no TYPO3 v11 e v12, desde que a tt_address esteja instalada numa versão compatível. No TYPO3 v13, a compatibilidade depende tanto do registeraddress quanto da tt_address, já que as duas extensões são mantidas de forma independente. A Gosign verifica, nos upgrades de TYPO3, toda a cadeia da newsletter (cadastro, gestão de endereços, envio) quanto à compatibilidade e recomenda, se necessário, migrar para um serviço de newsletter externo com integração via API quando a solução nativa do TYPO3 deixar de ser mantida.