LimeSurvey para TYPO3

LimeSurvey é a resposta compatível com a LGPD para pesquisas corporativas que não podem acabar no Google Forms

Quem conduz pesquisas profissionais no Brasil, pesquisas com colaboradores, pesquisa de mercado, estudos de avaliação, levantamentos científicos, e precisa ao mesmo tempo de conformidade com a LGPD, soberania de dados plena e uma trilha de auditoria limpa, acaba quase inevitavelmente passando pelo LimeSurvey. O software open source roda no servidor próprio, armazena dados de resposta exclusivamente no próprio banco e oferece todos os tipos de questão que pesquisa séria exige. Para operadores TYPO3, a pergunta não é se usam LimeSurvey, mas como o integram em seu site existente.

O público-alvo são tipicamente universidades, instituições de pesquisa, administrações públicas, hospitais, conglomerados com representações sindicais e ONGs com pesquisa em público-alvo sensível. Um exemplo: uma universidade brasileira com 18.000 estudantes realiza a cada semestre uma avaliação docente e quer retornar os resultados no próprio site TYPO3 sem que os estudantes precisem trocar de sistema.

Cenários típicos de uso

Um primeiro cenário é a participação sem emendas na página TYPO3. Em vez de mandar os estudantes a um domínio LimeSurvey separado, o questionário é exibido diretamente na página do site. As respostas fluem via API ao LimeSurvey, os estudantes veem a navegação familiar do site. Isso reduz significativamente a taxa de abandono.

Um segundo cenário é a identificação de participantes via SSO. Uma rede hospitalar brasileira com 8.000 colaboradores realiza uma pesquisa interna. Os participantes fazem login no intranet TYPO3, clicam no link da pesquisa e chegam ao LimeSurvey sem precisar autenticar novamente. A ponte SSO garante que cada colaborador participe só uma vez e que os dados pessoais do TYPO3 não cheguem às respostas da pesquisa.

Um terceiro cenário é a exibição de resultados diretamente no site. Uma administração municipal realiza uma pesquisa aos cidadãos sobre um projeto urbanístico e quer mostrar os estados parciais diariamente como gráfico de barras na página do projeto. Um sync job puxa os agregados anonimizados via API e os renderiza em um content element TYPO3, sem que dados brutos toquem a instalação TYPO3.

Um quarto cenário é o estudo longitudinal em pesquisa. Um projeto de pesquisa sobre carga de trabalho na enfermagem entrevista a mesma coorte quatro vezes por ano ao longo de dois anos. A página TYPO3 serve como ponto de informação e entrada, o LimeSurvey mantém os levantamentos, e a integração garante que cada participante alcance suas pesquisas subsequentes via link personalizado, sem que os pesquisadores mantenham dados de contato no LimeSurvey.

Arquitetura técnica

O LimeSurvey disponibiliza dois acessos de API: a clássica interface RemoteControl2 baseada em JSON-RPC e a mais nova API REST em versões atuais. Para integrações TYPO3, o RemoteControl2 continua sendo a âncora de estabilidade, porque está disponível em instalações LimeSurvey mais antigas e cobre autenticação completa, gerenciamento de participantes e consultas de resposta.

A integração TYPO3 roda em regra como uma extensão própria. Uma service layer encapsula as chamadas da API, um plugin entrega content elements para incorporar pesquisas e uma middleware implementa a lógica de SSO. Para a incorporação existem duas variantes: a pesquisa é chamada via token assinado e embutida via iFrame, ou as perguntas são lidas via API e renderizadas diretamente como template Fluid. A segunda variante oferece a melhor experiência de uso, mas exige mais esforço de desenvolvimento.

A ponte SSO se baseia em um token assinado que o TYPO3 gera e o LimeSurvey valida. No LimeSurvey é configurado um plugin que lê tokens do URL e cria o participante como token anônimo na tabela de participantes da pesquisa. É importante que o token seja limitado no tempo e válido apenas uma vez por participante.

Problemas frequentes e soluções

O primeiro problema é o tratamento de sessão entre TYPO3 e LimeSurvey. Os dois sistemas têm sessões próprias, e quando a abordagem iFrame é escolhida, surgem problemas com cookies de terceiros em navegadores modernos. A solução é operar o LimeSurvey em um subdomínio da instalação TYPO3, para que os cookies sejam aceitos como first party, ou usar a variante API com renderização no servidor.

O segundo problema é a crise de performance na exibição de resultados. Quem consulta a API por agregados a cada carregamento de página sobrecarrega o servidor LimeSurvey. A solução é um sync job que grava agregados em intervalos regulares (por exemplo a cada hora) em uma tabela TYPO3 e renderiza o content element a partir dessa tabela de cache.

O terceiro problema é o tratamento de dados pessoais conforme a LGPD. Em pesquisas com colaboradores, o empregador geralmente não pode identificar quem deu qual resposta. A solução é um conceito de separação limpo: o TYPO3 só disponibiliza tokens anonimizados, o LimeSurvey grava respostas sem referência, e a agregação só usa indicadores que não permitem conclusões sobre indivíduos.

Um quarto problema são deficiências de apresentação mobile no modo iFrame. Pesquisas LimeSurvey são responsivas, mas em um iFrame TYPO3 surgem barras de rolagem duplas e botões cortados em telas pequenas. A solução é mudar em uso móvel para renderização no servidor ou ajustar o iFrame dinamicamente ao conteúdo, para que o container de layout da página assuma a altura total.

Migração e compatibilidade de versões

Integrações LimeSurvey rodam em TYPO3 v11, v12 e v13. O desafio maior está no lado LimeSurvey: entre LimeSurvey 3.x, 5.x e 6.x, detalhes de API e métodos de autenticação mudaram. Quem leva uma integração existente para uma nova versão do LimeSurvey deve verificar as chamadas de API contra a documentação da versão correspondente e, idealmente, rodar um teste de integração automatizado contra uma instância de staging.

A Gosign implementa integrações LimeSurvey para universidades, hospitais e operadores públicos. O cliente API é gerado com apoio de IA a partir da documentação do RemoteControl2, a ponte SSO é adaptada individualmente à gestão de identidade existente, e a implementação acontece ao longo de uma documentação clara de conformidade com a LGPD que poupa trabalho do encarregado de proteção de dados.