Sorteios no TYPO3: em conformidade com a LGPD, acelerado com IA

Sorteios online no TYPO3 raramente falham na técnica, quase sempre no direito

Programar um sorteio leva 3 a 5 dias: formulário, validação, sorteio, e-mail ao ganhador. Torná-lo juridicamente seguro leva mais tempo, porque os requisitos jurídicos superam o esforço técnico. Termos de participação, consentimento separado de marketing, proibição de vinculação, exclusão automática de dados após término do sorteio, verificação de idade, exclusão de funcionários - estes não são extras opcionais, mas obrigações legais. No Brasil, a LGPD e o Código de Defesa do Consumidor impõem requisitos específicos. Um sorteio TYPO3 sem essas salvaguardas arrisca notificações e multas.

TYPO3 não oferece extensão padrão para sorteios. A solução é sempre um desenvolvimento customizado que mapeia exatamente os requisitos do sorteio concreto. A Gosign desenvolve tais módulos como extensões TYPO3 baseadas em Extbase com camada completa de compliance LGPD.

Cenários típicos de uso

Campanhas de marketing com sorteio de produtos. Um fabricante de bens de consumo sorteia 10 produtos entre todos os participantes que preenchem um formulário. O sorteio roda 4 semanas, depois os ganhadores são determinados por gerador de números aleatórios e notificados por e-mail. Os requisitos técnicos: formulário com campos obrigatórios (nome, e-mail, idade), participação única por e-mail (double opt-in), checkbox para termos de participação (não pré-selecionada), checkbox separada para consentimento de newsletter (opcional, não vinculada à participação), exclusão automática de dados 30 dias após o término.

Sorteios vinculados a redes sociais. Participantes são direcionados do Instagram ou Facebook para o site TYPO3, onde preenchem o formulário. A plataforma de mídia social não pode servir como mecanismo de participação (os termos das plataformas proíbem isso), apenas como fonte de tráfego. A página TYPO3 é a página oficial de participação. Em um cliente com 50.000 seguidores no Instagram, três sorteios em um ano geraram 12.000 contatos qualificados, dos quais 4.800 com opt-in de newsletter.

Sorteios recorrentes de advento ou mensais. Um calendário de advento com 24 portas, cada uma com um prêmio próprio. Tecnicamente mais desafiador: 24 sorteios em uma extensão, ativação temporizada, sorteio separado por dia, tracking de participação total (nenhum prêmio duplo). Em uma empresa de varejo, o calendário de advento aumentou o tráfego de dezembro em 300% em relação ao mês do ano anterior.

Arquitetura técnica

Um módulo de sorteio TYPO3 consiste em cinco componentes:

Formulário de participação. Controller Extbase com template Fluid. Os campos do formulário são configuráveis: campos obrigatórios (nome, e-mail), campos opcionais (telefone, endereço), checkboxes (termos de participação, consentimento de marketing). O formulário usa proteção CSRF do TYPO3 (FormToken) e valida server-side. Validação client-side é complementar, mas não suficiente sozinha.

Verificação de duplicatas. Cada e-mail pode participar apenas uma vez. A verificação ocorre no nível do banco de dados (unique constraint em e-mail + ID do sorteio). Adicionalmente: double opt-in por e-mail de confirmação. Somente após clicar no link de confirmação a participação vale.

Sorteio. Uma tarefa Scheduler ou trigger manual no backend seleciona os ganhadores por gerador de números aleatórios criptográfico (random_int() em PHP, não rand() ou mt_rand()). O sorteio é protocolado no banco de dados: timestamp, seed, IDs dos ganhadores. Em caso de consultas regulatórias, o sorteio pode ser rastreado.

Notificação de ganhadores. E-mail automático aos ganhadores com parabéns e próximos passos (p.ex. inserção de endereço para envio). E-mail automático aos não-ganhadores (opcional, recomendado para fidelização). Todos os e-mails via Mail API do TYPO3 com templates Fluid.

Ciclo de vida dos dados. Exclusão automática de todos os dados de participantes após período configurável (padrão: 30 dias após término do sorteio). Uma tarefa Scheduler verifica diariamente se sorteios expiraram e exclui os registros associados. Dados de ganhadores (nome, endereço) são tratados separadamente, pois precisam ser armazenados por mais tempo para envio e documentação fiscal.

Problemas frequentes e soluções

Participações de bots falsificam os resultados. Sem proteção, bots registram milhares de participações falsas. Solução: campo honeypot, rate limiting (máximo 3 submissões por IP por minuto) e double opt-in como tripla segurança. O double opt-in é a proteção mais eficaz: bots podem preencher formulários, mas não clicar em e-mails de confirmação.

Violação da proibição de vinculação. A participação no sorteio não pode ser vinculada a um consentimento de marketing. Se a checkbox de newsletter é campo obrigatório, há uma violação. Solução: sempre implementar consentimento de marketing como checkbox opcional e não pré-selecionada. No validador do formulário, verificar que a participação funciona também sem checkbox de marketing.

Performance sob alta carga simultânea. Um sorteio viral com 10.000 participações em uma hora sobrecarrega o servidor. Solução: configurar o form submit como página uncached (USER_INT), mas cachear a própria página do sorteio (USER). Para carga extrema: usar um processo worker separado para as escritas no banco e processar o formulário via queue.

Migração e compatibilidade de versões

Módulos de sorteio são desenvolvimentos customizados e não têm um caminho de migração padrão. Em upgrades TYPO3, as APIs Extbase devem ser adaptadas: v9-v10 (middleware stack), v10-v11 (alterações Extbase), v11-v12 (refactoring TCA, módulos backend). O esforço por upgrade major é de 1 a 2 dias para um módulo de sorteio típico.

Para sorteios recorrentes, vale investir em uma extensão genérica configurada via módulo backend: nome do sorteio, período, prêmios, campos de formulário, templates de e-mail. Esse investimento único (5 a 8 dias de desenvolvimento) economiza 80% do esforço em cada sorteio subsequente. A Gosign desenvolve tais módulos como extensões TYPO3 reutilizáveis e assume quando necessário o rascunho dos termos de participação - a aprovação jurídica fica com o cliente.