Mailchimp para TYPO3

A extensão mailchimp leva inscrições com grupos de interesse direto para as listas do Mailchimp

Assim como o koning_mailchimp_signup, a extensão mailchimp é um formulário de inscrição: os visitantes se inscrevem pelo site numa lista específica do Mailchimp. Mas ela vai além da extensão mais antiga, que para no TYPO3 8: os editores escolhem no elemento de conteúdo a lista e, se quiserem, um grupo de interesse, o formulário é um template Fluid livremente adaptável e, desde a versão 3.0.0, uma instalação TYPO3 atende várias contas Mailchimp. A extensão não oferece sincronização de listas inteiras, números de campanha no backend nem templates de newsletter a partir de conteúdos TYPO3; cada inscrição vai direto para a API do Mailchimp, sem necessidade de jobs de sincronização.

O aspecto da LGPD (PT: RGPD) continua central: a cada inscrição, o endereço de e-mail, o nome e o sobrenome, os grupos de interesse escolhidos e, se configurado, até dez campos adicionais vão para o Mailchimp. Sem contrato de processamento de dados com Mailchimp e mecanismo documentado de transferência para os EUA, isso não é permitido em termos de proteção de dados. No Brasil, a LGPD impõe requisitos similares para transferências internacionais.

Cenários típicos de uso são inscrição em newsletter, escolha de temas e várias marcas

O cenário principal é a inscrição em newsletter no site. Os visitantes informam e-mail e nome, a extensão os registra na lista escolhida com o status “pending”, e o Mailchimp envia o e-mail de confirmação do double opt-in. Só com o clique no link de confirmação o endereço fica ativo. Lista, cancelamentos e bounces ficam a cargo do Mailchimp; a extensão não cria tabelas próprias no TYPO3.

Segundo cenário: escolha de temas com grupos de interesse. Quem oferece vários newsletters ou temas cria um grupo de interesse no Mailchimp, e o formulário mostra os temas como checkboxes, botões de opção ou lista de seleção, conforme o tipo do grupo. A inscrição chega à lista com os temas escolhidos, e assim o marketing pode enviar no Mailchimp de forma direcionada a grupos específicos.

Terceiro cenário: várias marcas ou países numa instalação TYPO3. Desde a versão 3.0.0, é possível cadastrar várias API Keys com nome, e os editores escolhem no elemento de conteúdo para qual conta Mailchimp e qual lista cada formulário envia. No módulo de página, a extensão mostra para cada formulário a conta, a lista, o grupo de interesse e o número atual de assinantes. Já as taxas de abertura e de clique só aparecem para quem tem acesso ao dashboard do Mailchimp.

Arquitetura técnica chama a API Mailchimp v3 diretamente no envio do formulário

A extensão comunica via Mailchimp Marketing API v3, acessada por uma biblioteca PHP incluída na extensão. A autenticação ocorre por API Key configurada no Extension Manager TYPO3. Não há tarefa do Scheduler: cada inscrição vai direto para o Mailchimp no envio do formulário.

No envio, a extensão cria o membro na lista escolhida: com double opt-in, no status “pending”; sem ele, direto como “subscribed”. Se o endereço já está na lista, mas não inscrito, ela atualiza o registro; o ID do membro é o hash MD5 do e-mail. Se o endereço já está inscrito, o formulário mostra um aviso.

O formulário é um template Fluid que pode ser sobrescrito no próprio sitepackage. Com a extensão typoscript_rendering, ele é enviado via Ajax, sem recarregar a página. Um endereço de e-mail pode ser pré-preenchido por parâmetro GET ou POST, por exemplo quando outro formulário aponta para a inscrição.

Problemas frequentes são campos obrigatórios, endereços já cadastrados e double opt-in desativado

Problema um: campos obrigatórios. Se campos são marcados como obrigatórios no Mailchimp, a extensão, segundo a documentação, não consegue validá-los no servidor; se falta um desses campos, o formulário mostra apenas um erro genérico. A solução: marcar os mesmos campos como obrigatórios no template Fluid e validá-los antes do envio.

Problema dois: endereços que já estão na lista. Se um endereço já está inscrito, o Mailchimp recusa a segunda inscrição, e o formulário avisa que o endereço já está cadastrado. Já os endereços que cancelaram a inscrição antes são inscritos de novo pela extensão. A solução: formular a mensagem com clareza no arquivo de idioma, para que ninguém pense que a inscrição falhou.

Problema três: desativar o double opt-in. Por padrão, a extensão pede a confirmação por e-mail. Só quem desativou o double opt-in no Mailchimp o desativa também na extensão, com a configuração skipDoubleOptIn; a documentação recomenda usá-lo sempre. Além disso, o double opt-in é o caminho usual para comprovar o consentimento (na UE, nos termos do art. 7(1) do RGPD).

A extensão para no TYPO3 v10, para as versões atuais recomenda-se integração API direta

A extensão mailchimp no TER foi publicada pela última vez em janeiro de 2021 (versão 3.2.0) e suporta o TYPO3 v9 e v10; para versões mais novas do TYPO3 não há release. Como a API Mailchimp v3 é estável e bem documentada, a Gosign recomenda para projetos TYPO3 atuais uma integração API direta sem dependência de extensão. Uma classe de serviço customizada em um pacote TYPO3 próprio que acessa diretamente a API Mailchimp é mais fácil de manter que uma extensão comunitária e pode ser adaptada exatamente aos requisitos do projeto.