Modelos de email
From LimeSurvey Manual
Introdução
Os modelos de email são utilizados para enviar convites personalizados, lembretes, confirmações e emails de registo aos seus participantes (da tabela de participantes no inquérito). Também pode editar as notificações básicas (ou detalhadas) de administrador padrão que são enviadas aos administradores do inquérito.
Modelos de email: Configurações > Menu de inquérito > Modelos de email
Se tiver a permissão de superadministrador (tem acesso às configurações globais da sua instalação do LimeSurvey), pode alterar o Modo predefinido do editor HTML para todos os utilizadores do LimeSurvey. Para mais detalhes, continue a ler a seguinte subsecção da wiki.
Atenção : Se pretende utilizar o editor HTML em popup/na mesma página, não se esqueça de ativar o formato HTML para emails com código! Esta opção encontra-se no menu Configurações do seu inquérito, no separador Configurações de participantes.
Painel de modelos de email
O painel de modelos de email:
Na captura de ecrã acima, é utilizado o modo de edição "Código-fonte HTML". Para o alterar, aceda às suas configurações pessoais da conta.
Para editar os campos de texto, aceda às configurações da sua conta e escolha o modo de edição Editor HTML na mesma página.
Podem ser enviados cinco tipos de emails a utilizadores ou administradores:
Convite
Esta funcionalidade é utilizada para enviar emails em massa a todos os participantes no inquérito na tabela de participantes no inquérito que ainda não receberam um convite para responder ao seu inquérito.
No painel de modelos de email, pode editar a mensagem enviada aos participantes no inquérito. Para verificar quais os campos de substituição de email que podem ser utilizados, continue a ler a seguinte subsecção da wiki. Também pode utilizar o ExpressionScript para personalizar ainda mais o seu modelo de email de convite.
Lembrete
A funcionalidade Lembrete permite aos administradores do inquérito lembrar os participantes da tabela de participantes no inquérito de responderem ao inquérito.
Pode editar o formato padrão do email de lembrete a partir do painel de modelos de email. Para verificar quais os campos de substituição de email que podem ser utilizados, continue a ler a seguinte subsecção da wiki. O ExpressionScript pode ajudá-lo a personalizar o corpo do texto deste modelo de email.
Nota: Só será enviado um lembrete aos participantes na tabela de participantes no inquérito cujo campo "Completo" esteja desativado. Isto significa que o inquirido não respondeu ou não concluiu o inquérito.
Confirmação
Se forem utilizados códigos e um participante preencher o inquérito, será enviado um email de confirmação para o seu endereço de email. Pode desativar esta funcionalidade no painel Configurações de participantes.
Clique no separador Confirmação se pretender editar o modelo de email. Consulte os campos de substituição de email para ver quais podem ser utilizados neste tipo de email. Também pode utilizar o ExpressionScript para personalizar o seu email.
Registo
Se o modo de acesso restrito estiver ativado (existe uma tabela de participantes no inquérito), isto significa que apenas os participantes que tenham uma entrada atribuída e um código único associado podem responder ao respetivo inquérito. Se permitir que os participantes se registem publicamente no seu inquérito, será criada uma nova entrada na tabela de participantes no inquérito assim que o inquirido submeter o seu nome e endereço de email. Um script que é executado em segundo plano enviará automaticamente ao respetivo inquirido um email de registo. Este contém o URL com o código que deve ser acedido pelo utilizador recém-registado.
Clique no separador Registo para editar o formato deste email. Não se esqueça de verificar primeiro quais os campos de substituição de email que podem ser utilizados no corpo do texto. O ExpressionScript permite personalizar ainda mais o corpo do texto que pretende utilizar.
Notificações básicas e detalhadas de administrador
Para receber notificações de administrador, clique no separador Notificações & dados e introduza um endereço de email no campo "Envie notificação básica por email para" e outro (ou o mesmo) no campo "Envie notificação detalhada por email para".
Por predefinição, a única diferença entre os dois está relacionada com o campo de substituição adicional {ANSWERTABLE}, que está incluído no modelo de email de notificação detalhada de administrador. Isto permite que o utilizador que recebe este tipo de emails também verifique as respostas submetidas. Não necessita de aceder à instalação do LimeSurvey.
No entanto, ao utilizar o ExpressionScript e os campos de substituição de email, pode personalizar estes dois modelos de email.
Campos dos modelos de email
Cada modelo de email contém:
- O assunto do email: O título do email/lote de emails que pretende enviar;
- O corpo do email: Uma caixa de texto que contém a mensagem de texto que pretende enviar aos participantes. Pode conter texto, imagens e campos de substituição de email. O ExpressionScript também pode ser utilizado para personalizar ainda mais a mensagem que pretende enviar;
Nota: Se o seu inquérito utilizar idiomas adicionais, é apresentado outro separador acima do separador dos modelos de email. Se clicar em qualquer separador de idioma que não seja o do idioma por omissão, os modelos de email carregarão os textos correspondentes nesse idioma. Aceda a cada modelo de email para começar a editá-lo. Não se esqueça de clicar no botão Gravar, situado na parte superior direita do ecrã, para gravar as alterações.
- Ações de email: Estão disponíveis duas ações:
- Repor este modelo: Depois de clicar, o código HTML é reinicializado. Nenhum texto é eliminado;
- Validar expressões: Verifica a lógica do email - se os campos de substituição estão ou não corretamente utilizados. Recomendamos vivamente que a utilize antes de enviar um lote de emails. Desta forma, pode ver se os campos de substituição estão ou não corretamente definidos. No exemplo abaixo, existe um pequeno erro de digitação - está realçado a vermelho.
Campos de substituição de email
Atenção : Tenha em conta que alguns campos de substituição de email só podem ser utilizados em determinados modelos de email! Leia abaixo para mais detalhes.
Nos modelos de email por omissão, são utilizados diferentes campos de substituição no corpo e/ou no assunto do email. A sua função é ligar o email que pretende enviar a cada participante da sua lista de participantes no inquérito. Os dados da tabela de participantes do inquérito (por exemplo, email, primeiro nome, último nome, código, etc.) são automaticamente obtidos e colocados em emails únicos diferentes antes de serem enviados a cada participante da sua lista de participantes no inquérito.
Abaixo estão os campos de substituição de email que podem ser utilizados no corpo da mensagem dos seus modelos de email de convite e de lembrete. Ao enviar os emails, estes campos de substituição serão substituídos, na pré-visualização do seu email de convite/lembrete, por dados do seu inquérito e da tabela de participantes no inquérito.
| {ADMINEMAIL} | Email do administrador do inquérito |
| {ADMINNAME} | Nome do administrador do inquérito |
| {SURVEYNAME} | Título do seu inquérito |
| {SURVEYDESCRIPTION} | Descrição do seu inquérito |
Os seguintes campos de substituição são permitidos nos modelos de email de convite/lembrete (campos de assunto e/ou de corpo) e serão substituídos ao enviar os emails:
| {EMAIL} | Email do destinatário |
| {FIRSTNAME} | Primeiro nome |
| {LASTNAME} | Último nome |
| {SURVEYURL} | O URL para iniciar o inquérito - se estiver a enviar emails HTML, será apresentado ao participante no inquérito um URL completo |
| @@SURVEYURL@@ | O URL para iniciar o inquérito - esta é a hiperligação simples. Utilize-a se pretender integrar a hiperligação nos seus elementos HTML personalizados (disponível na v1.90 e posteriores) |
| {OPTOUTURL} | O URL para desativar o envio de emails para o respetivo inquérito - será apresentada uma hiperligação completa na versão HTML do modelo de email |
| {OPTINURL} | Se um utilizador estiver na lista negra e quiser participar no respetivo inquérito, tem de clicar no URL de adesão para voltar a receber convites/lembretes do inquérito. |
| {GLOBALOPTOUTURL} | O URL para um inquirido deixar de constar da lista central de participantes deste site - será apresentada uma hiperligação completa na versão HTML do modelo de email |
| {TOKEN} | O código para aceder ao inquérito |
| {USESLEFT} | O número de utilizações em falta do código |
| {VALIDFROM} | A data a partir da qual o código é válido |
| {VALIDUNTIL} | A data até à qual o código é válido |
| {EMAILSTATUS} | Utilizado para ignorar emails no envio de emails. O estado do email por omissão é "OK". |
| {LANGUAGE} | Utilizado para definir o idioma a utilizar nos emails e no URL do inquérito quando se utilizam inquéritos multilingues |
| {SENT} | Data de envio do convite no formato ISO8601 com hora (Y-m-d H:i:s em PHP) |
| {REMINDERSENT } | Data de envio do lembrete no formato ISO8601 com hora (Y-m-d H:i:s em PHP) |
| {REMINDERCOUNT} | Número de lembretes já enviados |
| {COMPLETED } | Data de conclusão do inquérito |
| {TID} | ID interno na tabela de códigos |
| {ATTRIBUTE_1} | Atributo 1 |
| {ATTRIBUTE_2} | Atributo 2 (...e assim sucessivamente para mais campos de atributos) |
Se o seu inquérito não for anónimo, os campos de substituição de email podem ser utilizados para adicionar dados específicos da entrada/do participante ao painel Elementos de texto do inquérito (por exemplo, descrição do inquérito, mensagem de boas-vindas, mensagem final).
| {TOKEN:EMAIL} | Apresenta o email do participante da tabela de participantes do inquérito |
| {TOKEN:FIRSTNAME} | Apresenta o primeiro nome do participante da tabela de participantes do inquérito |
| {TOKEN:LASTNAME} | Apresenta o último nome do participante da tabela de participantes do inquérito |
| {TOKEN} | Apresenta o código do participante da tabela de participantes do inquérito |
| {TOKEN:ATTRIBUTE_1} | Apresenta o "Atributo 1" do participante da tabela de participantes do inquérito |
| {TOKEN:ATTRIBUTE_2} | Apresenta o "Atributo 2" do participante da tabela de participantes do inquérito (e assim sucessivamente para mais campos de atributos) |
Para saber mais sobre atributos, leia a seguinte secção da wiki.Estes campos de substituição de email também podem ser utilizados nos modelos de email de confirmação e de notificação do administrador.
Certos campos de substituição só podem ser utilizados nos modelos de notificação do administrador. Tenha em conta que será enviado um email por resposta para o endereço de email do administrador!
Alguns dos campos de substituição que só podem ser utilizados nos painéis de notificação do administrador são mencionados abaixo:
| {VIEWRESPONSEURL} | Apresenta um URL que o redireciona para a resposta submetida pelo inquirido |
| {EDITRESPONSEURL} | Apresenta um URL que o redireciona para uma página do LimeSurvey a partir da qual pode editar as respostas submetidas pelo respetivo participante no inquérito |
| {STATISTICSURL} | Clique neste URL para aceder às estatísticas do inquérito |
| {ANSWERTABLE} | Se pretender apresentar as respostas submetidas pelo participante no email de notificação do administrador, utilize este campo de substituição. Desta forma, deixa de ser necessário aceder à sua instalação do LimeSurvey para verificar as respostas submetidas pelo respetivo inquirido (como acontece com o campo de substituição {VIEWRESPONSEURL}). |
Sugestões:
- Se o seu inquérito utilizar respostas anonimizadas, os campos de substituição relacionados com códigos não funcionarão no modelo de email de notificação.
- Pode utilizar o ExpressionScript para usar expressões que adaptem um email (New in 1.92 ). Consulte os guias práticos do ExpressionScript para ver um exemplo.
- Consulte também os exemplos sobre a utilização de Informações da tabela de participantes do inquérito.
Exclusão voluntária do participante
Quando utiliza a tag {OPTOUTURL} no seu email de convite/lembrete, os seus participantes podem optar por deixar de participar neste inquérito em particular clicando no URL correspondente no email - para que não lhes envie emails de lembrete. Um participante que opte por sair do seu inquérito terá o estado do email 'OptOut' definido na lista de participantes no inquérito.
URL simples
Os campos de substituição de URL têm o seu URL simples correspondente. Por exemplo, @@SURVEYURL@@: pode utilizar @@OPTOUTURL@@, @@OPTINURL@@ …
Utilizar a função de substituição
Algumas palavras-chave específicas podem ser utilizadas nos seus modelos de email. Por exemplo, certas palavras-chave podem ser utilizadas para substituir o endereço URL do código.
O exemplo abaixo utiliza uma hiperligação simples para o inquérito em vez de um URL longo:
1) Primeiro, aceda ao painel de modelos de email e escolha Convite.
2) Escreva o texto que pretende 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 "other" na caixa de seleção de protocolo.
Agora, quando enviar os emails de convite, a hiperligação para iniciar o inquérito será mais curta.
Anexos de email
Ações sobre ficheiros
Ao clicar em Adicionar ficheiro, será apresentada a seguinte janela, na qual deve escolher o documento da pasta de ficheiros que pretende enviar por email:
Os anexos podem ser adicionados na parte inferior da interface de edição do modelo de email. Tenha em atenção que os anexos de email são carregados por inquérito.
Também pode carregar, no momento, um ficheiro do seu computador para a instalação do LimeSurvey, clicando no botão Submeter e selecionando depois o ficheiro que pretende anexar ao respetivo modelo de email.
Depois de selecionado, faça duplo clique sobre ele e o ficheiro será imediatamente apresentado na tabela Ficheiros, abaixo do botão Adicionar ficheiro:
Para que fique anexado de forma permanente ao respetivo modelo de email, não se esqueça de clicar no botão Gravar, 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.
Podem ser utilizadas todas as funções suportadas pelo ExpressionScript, bem como os atributos dos códigos, se o inquérito utilizar códigos.
Com os modelos de notificação ou de confirmação, também é possível utilizar os códigos das perguntas utilizados no inquérito.
Se pretender eliminar um ficheiro, clique no botão vermelho do caixote do lixo localizado na coluna Ação e grave as alterações.
Atenção :
- Quando um ficheiro não é encontrado no sistema de ficheiros, o email será enviado sem anexo.
- A exportação/importação de um inquérito não exporta/importa os ficheiros carregados anexados. No entanto, as definições dos anexos serão mantidas, bem como as equações de relevância.
Anexo de imagem
Pode anexar uma ou várias imagens se enviar emails em HTML. Para tal, tem de atualizar o URL de origem da imagem, definindo o respetivo caminho para a pasta pública da sua instância do LimeSurvey.
A origem tem de ser relativa à pasta pública no servidor. Se a sua instância do LimeSurvey estiver instalada numa subpasta, a imagem não será apresentada no seu editor HTML.