Modelos de e-mail
From LimeSurvey Manual
Introdução
Os modelos de e-mail são usados para enviar convites personalizados, lembretes, confirmações e e-mails de registro aos seus participantes (da tabela de participantes do questionário). Você também pode editar as notificações básicas (ou detalhadas) padrão do administrador, que são enviadas aos administradores do questionário.
Modelos de e-mail: Configurações > Menu da pesquisa > Modelos de e-mail
Se você tem a permissão de superadministrador (ou seja, tem acesso às definições globais da sua instalação do LimeSurvey), pode alterar o modo de edição HTML padrão para todos os usuários do LimeSurvey. Para mais detalhes, continue lendo a seguinte subseção da wiki.
Atenção : Se você quiser usar o editor HTML popup/InLine, não se esqueça de ativar o formato HTML para e-mails com código! Essa opção fica no menu Configurações do seu questionário, na aba Configurações de participantes.
Painel de modelos de e-mail
O painel de modelos de e-mail:
Na captura de tela acima, é usado o modo de edição "Código HTML". Para alterá-lo, acesse as configurações da sua conta pessoal.
Para editar os campos de texto, acesse as configurações da sua conta e escolha o modo de edição Editor HTML InLine.
Cinco tipos de e-mail podem ser enviados a usuários ou administradores:
Convites
Esta funcionalidade é usada para enviar e-mails em massa a todos os participantes do questionário na tabela de participantes do questionário que ainda não receberam um convite para responder ao seu questionário.
No painel de modelos de e-mail, você pode editar a mensagem enviada aos participantes do questionário. Para verificar quais campos de substituição de e-mail podem ser usados, continue lendo a seguinte subseção da wiki. Você também pode usar o ExpressionScript para personalizar ainda mais o seu modelo de convite por e-mail.
Lembrete
A funcionalidade Lembrete permite que os administradores do questionário lembrem os participantes da tabela de participantes do questionário de responder ao questionário.
Você pode editar o formato padrão do e-mail lembrete no painel de modelos de e-mail. Para verificar quais campos de substituição de e-mail podem ser usados, continue lendo a seguinte subseção da wiki. O ExpressionScript pode ajudar você a personalizar o corpo do texto deste modelo de e-mail.
Nota: Um lembrete será enviado somente aos participantes da tabela de participantes do questionário em que o campo "Completo" estiver desativado. Isso significa que o respondente não iniciou ou não concluiu o questionário.
Confirmação
Se códigos são usados e um participante preenche o questionário, um e-mail de confirmação será enviado ao seu endereço de e-mail. Você pode desativar esta funcionalidade no painel Configurações de participantes.
Clique na aba Confirmação se quiser editar o modelo de e-mail. Consulte os campos de substituição de e-mail para ver quais podem ser usados neste tipo de e-mail. Você também pode usar o ExpressionScript para personalizar o seu e-mail.
Inscrição
Se o modo de acesso fechado estiver ativado (existe uma tabela de participantes do questionário), isso significa que somente os participantes que têm uma entrada alocada e um código exclusivo associado a ela podem responder ao respectivo questionário. Se você permitir que os participantes se registrem publicamente no seu questionário, uma nova entrada será criada na tabela de participantes do questionário assim que o respondente enviar seu nome e endereço de e-mail. Um script executado em segundo plano enviará automaticamente ao respondente um e-mail de registro. Ele contém a URL com o código que deve ser acessada pelo usuário recém-registrado.
Clique na aba Inscrição para editar o formato deste e-mail. Não se esqueça de verificar primeiro quais campos de substituição de e-mail podem ser usados no corpo do texto. O ExpressionScript pode oferecer mais personalização ao texto do corpo que você deseja usar.
Notificações básicas e detalhadas do administrador
Para receber notificações do administrador, clique na aba Notificações e dados e digite um endereço de e-mail no campo "Enviar e-mail de notificação básica do administrador para" e outro (ou o mesmo) no campo "Enviar e-mail de notificação detalhada do administrador para".
Por padrão, a única diferença entre os dois é o campo de substituição extra {ANSWERTABLE}, incluído no modelo de e-mail de notificação detalhada do administrador. Isso permite que o usuário que recebe esse tipo de e-mail também verifique as respostas enviadas, sem precisar acessar a instalação do LimeSurvey.
No entanto, usando o ExpressionScript e os campos de substituição de e-mail, você pode personalizar esses dois modelos de e-mail.
Campos dos modelos de e-mail
Cada modelo de e-mail contém:
- O assunto do e-mail: O título do e-mail/lote de e-mails que você deseja enviar;
- O corpo do e-mail: Uma caixa de texto que contém a mensagem que você deseja enviar aos participantes. Ela pode conter texto, imagens e campos de substituição de e-mail. O ExpressionScript também pode ser usado para personalizar ainda mais a mensagem que você deseja enviar;
Nota: Outra aba é exibida acima da aba dos modelos de e-mail se o seu questionário usa idiomas adicionais. Se você clicar em qualquer aba de idioma diferente da aba do idioma padrão, os modelos de e-mail carregarão os textos correspondentes no respectivo idioma. Acesse cada modelo de e-mail para começar a editá-los. Não se esqueça de clicar no botão Salvar, localizado na parte superior direita da tela, para salvar suas alterações.
- Ações de e-mail: Duas ações estão disponíveis:
- Reiniciar este template: Ao clicar, o código HTML é reinicializado. Nenhum texto é excluído;
- Validar expressões: Verifica a lógica do e-mail - se os campos de substituição estão sendo usados corretamente ou não. Recomendamos fortemente usá-la antes de enviar um lote de e-mails. Dessa forma, você pode ver se os campos de substituição estão definidos corretamente ou não. No exemplo abaixo, existe um pequeno erro de digitação - ele está destacado em vermelho.
Campos de substituição de e-mail
Atenção : Observe que alguns campos de substituição de e-mail só podem ser usados em determinados modelos de e-mail! Leia abaixo para mais detalhes.
Nos modelos de e-mail padrão, diferentes campos de substituição de e-mail são usados no corpo e/ou no assunto do e-mail. A função deles é conectar o e-mail que você deseja enviar a cada participante da sua lista de participantes do questionário. Os dados da tabela de participantes do questionário (por exemplo, e-mail, nome, sobrenome, código etc.) são obtidos automaticamente e colocados em e-mails únicos e diferentes antes de serem enviados a cada participante da sua lista de participantes do questionário.
Abaixo estão os campos de substituição de e-mail que podem ser usados no corpo da mensagem dos modelos de e-mail de convite e de lembrete. Ao enviar os e-mails, esses campos de substituição serão substituídos, na pré-visualização do seu e-mail de convite/lembrete, por dados do seu questionário e da tabela de participantes do questionário.
| {ADMINEMAIL} | E-mail do administrador do questionário |
| {ADMINNAME} | Nome do administrador do questionário |
| {SURVEYNAME} | Título do seu questionário |
| {SURVEYDESCRIPTION} | Descrição do seu questionário |
Os seguintes campos de substituição são permitidos nos modelos de e-mail de convite/lembrete (campos de assunto e/ou de corpo) e serão substituídos no envio dos e-mails:
| {EMAIL} | E-mail do destinatário |
| {FIRSTNAME} | Nome |
| {LASTNAME} | Sobrenome |
| {SURVEYURL} | A URL para iniciar o questionário - se você estiver enviando e-mails em HTML, uma URL completa será exibida ao participante do questionário |
| @@SURVEYURL@@ | A URL para iniciar o questionário - este é o link simples. Use-o se quiser integrar o link em seus elementos HTML personalizados (disponível na v1.90 e posteriores) |
| {OPTOUTURL} | A URL para desativar o envio de e-mails para o respectivo questionário - um link completo será exibido na versão HTML do modelo de e-mail |
| {OPTINURL} | Se um usuário está na lista de bloqueio e deseja participar do respectivo questionário, ele precisa clicar na URL de adesão para voltar a receber convites/lembretes do questionário. |
| {GLOBALOPTOUTURL} | A URL para um respondente sair da lista central de participantes deste site - um link completo será exibido na versão HTML do modelo de e-mail |
| {TOKEN} | O código para acessar o questionário |
| {USESLEFT} | O número de usos restantes do código |
| {VALIDFROM} | A data a partir da qual o código é válido |
| {VALIDUNTIL} | A data até a qual o código é válido |
| {EMAILSTATUS} | Usado para ignorar e-mails no envio. O status de e-mail padrão é "OK". |
| {LANGUAGE} | Usado para definir o idioma a ser usado nos e-mails e na URL do questionário ao utilizar questionários multilíngues |
| {SENT} | Data de envio do convite no formato ISO8601 com hora (Y-m-d H:i:s no PHP) |
| {REMINDERSENT } | Data de envio do lembrete no formato ISO8601 com hora (Y-m-d H:i:s no PHP) |
| {REMINDERCOUNT} | Número de lembretes já enviados |
| {COMPLETED } | Data de conclusão do questionário |
| {TID} | ID interno na tabela de códigos |
| {ATTRIBUTE_1} | Atributo 1 |
| {ATTRIBUTE_2} | Atributo 2 (...e assim por diante para mais campos de atributo) |
Se o seu questionário não for anônimo, os campos de substituição de e-mail podem ser usados para adicionar dados específicos do registro/participante ao painel de Elementos textuais do questionário (por exemplo, descrição do questionário, mensagem de boas-vindas, mensagem final).
| {TOKEN:EMAIL} | Exibe o e-mail do participante da tabela de participantes do questionário |
| {TOKEN:FIRSTNAME} | Exibe o primeiro nome do participante da tabela de participantes do questionário |
| {TOKEN:LASTNAME} | Exibe o último nome do participante da tabela de participantes do questionário |
| {TOKEN} | Exibe o código do participante da tabela de participantes do questionário |
| {TOKEN:ATTRIBUTE_1} | Exibe o "Atributo 1" do participante da tabela de participantes do questionário |
| {TOKEN:ATTRIBUTE_2} | Exibe o "Atributo 2" do participante da tabela de participantes do questionário (e assim por diante para mais campos de atributo) |
Para saber mais sobre atributos, leia a seguinte seção da wiki.Esses campos de substituição de e-mail também podem ser usados nos modelos de e-mail de confirmação e de notificação ao administrador.
Certos campos de substituição só podem ser usados nos modelos de notificação ao administrador. Observe que um e-mail por resposta será enviado ao endereço de e-mail do administrador!
Alguns dos campos de substituição que só podem ser usados nos painéis de notificação ao administrador são mencionados abaixo:
| {VIEWRESPONSEURL} | Exibe uma URL que redireciona você para a resposta enviada pelo respondente |
| {EDITRESPONSEURL} | Exibe uma URL que redireciona você para uma página do LimeSurvey na qual é possível editar as respostas enviadas pelo respectivo participante do questionário |
| {STATISTICSURL} | Clique nesta URL para acessar as estatísticas do questionário |
| {ANSWERTABLE} | Se você deseja exibir as respostas enviadas pelo participante no e-mail de notificação ao administrador, use este campo de substituição de e-mail. Dessa forma, você não precisa mais acessar a sua instalação do LimeSurvey para verificar as respostas enviadas pelo respectivo respondente (como faz o campo de substituição {VIEWRESPONSEURL}). |
Dicas:
- Se o seu questionário usa respostas anônimas, os campos de substituição relacionados a códigos não funcionarão no modelo de e-mail de notificação.
- Você pode usar o ExpressionScript para utilizar expressões e personalizar um e-mail (New in 1.92 ). Veja os tutoriais do ExpressionScript para um exemplo.
- Dê uma olhada também nos exemplos de uso de Informações da tabela de participantes do questionário.
Cancelamento de participação do participante
Quando você usa a tag {OPTOUTURL} no seu e-mail de convite/lembrete, seus participantes podem optar por sair deste questionário específico clicando na URL correspondente no e-mail - para que você não envie a eles e-mails de lembrete. Um participante que optar por sair do seu questionário terá o status de e-mail 'OptOut' definido na lista de participantes do questionário.
URL simples
Os campos de substituição de URL têm a sua URL simples correspondente. Por exemplo, @@SURVEYURL@@: você pode usar @@OPTOUTURL@@, @@OPTINURL@@ …
Usando a função de substituição
Algumas palavras-chave específicas podem ser usadas nos seus modelos de e-mail. Por exemplo, certas palavras-chave podem ser usadas para substituir o endereço da URL com o código.
O exemplo abaixo usa um link simples para o questionário em vez de uma URL longa:
1) Primeiro, acesse o painel de modelos de e-mail e escolha Convites.
2) Escreva o texto que você deseja que apareça como hiperligação para iniciar o inquérito.
3) Em seguida, selecione esse texto.
4) Adicione o campo de substituição para a hiperligação simples @@SURVEYURL@@ e escolha "outro" na caixa de seleção de protocolo.
Agora, ao enviar seus e-mails de convite, a hiperligação para iniciar o inquérito será mais curta.
Anexos de e-mail
Ações de arquivo
Ao clicar em Adicionar arquivo, a janela a seguir será exibida, solicitando que você escolha o documento, da pasta de arquivos, que deseja enviar por e-mail:
Os anexos podem ser adicionados na parte inferior da interface de edição do tema de e-mail. Observe que os anexos de e-mail são carregados por inquérito.
Você também pode carregar, na hora, um arquivo da sua área de trabalho para a sua instalação do LimeSurvey clicando no botão Importar e, em seguida, selecionando o arquivo que deseja anexar ao respectivo tema de email.
Depois de selecionado, clique duas vezes nele e o arquivo será exibido imediatamente na tabela Arquivos, abaixo do botão Adicionar arquivo:
Para que ele fique anexado de forma permanente ao respectivo tema de e-mail, não se esqueça de clicar no botão Salvar, localizado na parte superior direita da janela.
Para determinar se um anexo deve ser enviado individualmente, é possível adicionar uma equação de relevância a cada anexo.
Todas as funções compatíveis com o ExpressionScript podem ser usadas, assim como os atributos de código, caso o inquérito use códigos.
Com os temas de notificação ou confirmação, também é possível usar os códigos de pergunta utilizados no inquérito.
Se você quiser excluir um arquivo, clique no botão vermelho de lixeira localizado na coluna Ação e salve as alterações.
Atenção :
- Quando um arquivo não é encontrado no sistema de arquivos, o e-mail será enviado sem anexo.
- A exportação/importação de um inquérito não exporta/importa os arquivos carregados anexados. No entanto, as configurações dos anexos serão mantidas, assim como as equações de relevância.
Anexo de imagem
Você pode anexar uma ou mais imagens se enviar e-mails em HTML. Para isso, é necessário atualizar a URL de origem da imagem, definindo seu caminho para o diretório público da sua instância do LimeSurvey.
A origem deve ser relativa ao seu diretório público no servidor. Se a sua instância do LimeSurvey estiver instalada em um subdiretório, a imagem não será exibida no seu editor HTML.