Sistema de rastreamento de retorno de e-mails
From LimeSurvey Manual
Introdução
O sistema de rastreamento de retorno de e-mails é capaz de localizar e marcar os e-mails que não foram entregues aos destinatários (participantes do inquérito). O sistema se baseia no "relatório de falha de notificação de entrega de e-mail". Por isso, ele precisa de um endereço de e-mail para o qual os e-mails possam ser enviados, a fim de rastrear os retornos. Além do endereço da conta, também são necessárias as credenciais da conta, bem como os detalhes de conexão.
Requisitos
O módulo php5-imap deve estar instalado no seu servidor. Você pode verificar isso no botão Mostrar PHPInfo, encontrado na página de definições globais da sua instalação do LimeSurvey, na guia Visão geral:
Em seguida, procure por uma seção imap (use Ctrl+F para uma busca rápida). Se uma seção imap for exibida, está tudo certo:
Se você não tem o php5-imap instalado e possui acesso root ao servidor, pode instalá-lo seguindo o procedimento específico da sua distribuição. Por exemplo, consulte esta hiperligação se você usa Debian. Lembre-se de reiniciar o servidor web depois de instalá-lo (por exemplo, execute "apache/usr/sbin/apache2ctl restart" no terminal).
Como funciona
A ideia básica por trás do desenvolvimento do sistema foi reduzir o trabalho manual e os possíveis erros humanos que poderiam surgir ao editar manualmente cada campo.
A ideia básica por trás deste sistema é que, ao enviar o e-mail, o sistema de rastreamento de retorno de e-mails adiciona automaticamente um survey-id e um token-id ao cabeçalho do e-mail, sem que o administrador perceba.
Esses cabeçalhos (também conhecidos como cabeçalhos personalizados) são adicionados a cada convite por e-mail enviado pelo LimeSurvey aos participantes do inquérito.
Quando o e-mail retorna, o cabeçalho original é recebido junto com o cabeçalho de notificação de entrega. Em seguida, o sistema verifica se há novos e-mails e analisa aqueles que possuem esses cabeçalhos personalizados. Ele muda para vermelho a cor de fonte dos endereços de e-mail incorretos na tabela de participantes do questionário.
Configurando o sistema
O sistema pode funcionar de forma global (para todos os inquéritos) ou local (apenas para um inquérito específico); assim, as configurações podem ser salvas de acordo. As configurações globais de retorno podem ser salvas em Definições globais -> Configurações de retorno. As seguintes opções serão exibidas:
- E-mail padrão de retorno do site: Este é o endereço de e-mail para o qual os e-mails devolvidos serão enviados. Para um processamento mais rápido dos e-mails devolvidos, recomendamos o uso de um endereço de e-mail utilizado apenas para o sistema de rastreamento de retorno de e-mails do LimeSurvey.
- Tipo de servidor: Se definido como "Desligado", nenhuma função de processamento de retorno estará disponível. Escolha "POP" ou "IMAP" para usar o sistema de rastreamento de retorno de e-mails do LimeSurvey.
- Tipo de servidor & porta: Nome do servidor e (se necessário) a porta, separados por dois-pontos. O número da porta normalmente não é necessário, a menos que o provedor de e-mail use uma porta fora do padrão.
- Usuário: O nome de usuário da conta POP/IMAP.
- Senha: A senha da conta POP/IMAP.
- Tipo da criptografia: Se for usada criptografia, defina aqui a correta (SSL ou TLS).
Se você quiser aplicar as configurações de retorno apenas a um único inquérito, acesse o inquérito desejado -> vá ao menu da pesquisa e clique na guia Participantes do questionário -> na barra de ferramentas principal da página, clique na opção Convites e lembretes -> clique em Configurações de retorno. A seguinte página será carregada:
A opção adicional é representada por Configurações de retorno usadas. Aqui, você pode escolher se usará:
- nenhuma configuração de retorno;
- as configurações de retorno locais. Se esta for escolhida, você precisará preencher os demais campos das configurações de retorno locais;
- as configurações de retorno globais. Neste caso, serão usadas as configurações de retorno da sua instalação do LimeSurvey.
Nota: O LimeSurvey iniciará a conexão SMTP a partir do endereço IP da sua instalação do LimeSurvey. Basta executar um ping na URL da instalação do LimeSurvey para descobrir qual é. Caso o seu servidor SMTP esteja bloqueado, você precisará adicionar esse endereço IP como exceção na configuração do SMTP/firewall.
Usando o servidor de e-mail do LimeSurvey Cloud
Se você estiver usando o servidor de e-mail do LimeSurvey Cloud, todos os seus e-mails terão o endereço de remetente "noreply@limesurvey.org". No entanto, esses e-mails terão um cabeçalho Reply-to com o seu endereço de e-mail. Assim, caso alguém tente responder, poderá escrever diretamente para você.
Os retornos são processados automaticamente se você estiver usando o servidor do LimeSurvey Cloud. Você não precisa configurar nada e nem precisa iniciar o processamento de retornos; basta manter as configurações padrão intactas. Tudo acontece magicamente em segundo plano. Observe que pode levar de 10 a 15 minutos até que um e-mail devolvido seja processado e a entrada correspondente seja marcada.
Por favor, não abuse do LimeSurvey Cloud para enviar spam, ou teremos que bloquear a sua conta. Certifique-se de que você tem o consentimento das pessoas para quem deseja enviar convites.
Iniciando o processamento de retornos
Antes de iniciar o processamento de retornos, não se esqueça de enviar primeiro os convites por e-mail aos participantes do seu inquérito.
Na versão 3.0+, depois que o sistema de rastreamento de retorno de e-mails estiver configurado, você pode iniciar o processamento de retornos acessando a página inicial do inquérito -> clique na aba Participantes do questionário no menu da pesquisa -> clique em Invitations & reminders (localizado na barra de ferramentas) -> Iniciar processamento de retornos.
Após selecionar esta opção, um indicador de progresso será exibido durante o processo, seguido de um resumo final do status do processamento.
Os convites enviados por e-mail começarão a ser examinados. Os resultados da verificação serão exibidos na tabela de participantes do questionário (talvez seja necessário atualizar a página manualmente). Todas as entradas cujos convites foram devolvidos terão seus endereços de e-mail marcados em fonte vermelha. Além disso, o Status do e-mail delas é alterado de "OK" para "bounced".
Iniciando o processamento de retornos na v2.5
Na versão 2.50+, depois que o sistema de processamento de retornos estiver configurado, você pode iniciar o processamento de retornos a partir da página inicial do inquérito: Invitations & reminders -> Iniciar processamento de retornos.
Após selecionar esta opção, um indicador de progresso será exibido durante o processo, seguido de um resumo final do status do processamento.
Os convites enviados por e-mail começarão a ser examinados. Os resultados da verificação serão exibidos na tabela de participantes do questionário (talvez seja necessário atualizar a página manualmente). Todas as entradas cujos convites foram devolvidos terão seus endereços de e-mail marcados em fonte vermelha. Além disso, o Status do e-mail delas é alterado de "OK" para "bounced".
Atenção : Algumas versões da v2.50+ não exibem corretamente esta opção de menu, e o problema foi corrigido na build 160714, lançada em 14 de julho de 2016.
Exemplo
Para entender melhor como o sistema de rastreamento de retorno de e-mails do LimeSurvey funciona, confira o exemplo abaixo:
1. Adicione seus respondentes à tabela de participantes do inquérito. Certifique-se de que cada um deles tenha um código e um endereço de e-mail atribuídos.
2. Selecione os respondentes para os quais deseja enviar o convite do inquérito:
Clique no botão Participante(s) selecionado(s)... e escolha a opção Enviar convite por e-mail.
3. Aguarde alguns instantes para garantir que os e-mails tenham sido enviados aos respondentes do inquérito.
4. Agora você pode usar o sistema de rastreamento de retorno de e-mails do LimeSurvey. Clique em Invitations & reminders e preencha os campos de configurações de retorno de e-mail com os detalhes de conexão e de conta do seu e-mail pessoal:
Você também pode deixar os campos vazios. O processamento de retornos continuará funcionando, mas você não receberá nenhum e-mail relacionado ao processamento de retornos. No entanto, o status do e-mail das entradas da tabela de participantes do questionário será atualizado.
Como você pode observar abaixo, usamos o sistema de rastreamento de retorno de e-mails com o auxílio de uma conta gratuita do Gmail. Para saber mais sobre as configurações de conexão do Gmail, acesse esta hiperligação. Além disso, não se esqueça de ativar o IMAP/POP nas configurações da sua conta do Gmail.
O Gmail pode tratar a conexão com a sua conta do LimeSurvey como insegura. Para permitir que o LimeSurvey se conecte à sua conta do Gmail, você precisará permitir que aplicativos menos seguros usem a sua conta.
Preencha os campos. Selecione as configurações desejadas de servidor e criptografia. Depois de concluir, clique no botão Salvar, localizado na parte superior direita da tela.
5. Agora, você pode clicar no botão Iniciar processamento de retornos:
O sistema de rastreamento de retorno de e-mails começará a procurar o ID do inquérito, o ID do código e a notificação de entrega anexados ao cabeçalho de cada e-mail devolvido. Se esses cabeçalhos personalizados existirem, o sistema mudará para vermelho a cor de fonte dos endereços de e-mail incorretos na tabela de participantes do inquérito. Além disso, o status do e-mail das respectivas entradas será alterado de OK para bounced.
