Conteúdos regulamentos e mensagens de e-mail

É a aba Conteúdos da campanha. Ela guarda duas coisas diferentes: os documentos legais que o participante lê no hotsite — os regulamentos e a política de privacidade, anexados em PDF — e as duas mensagens de e-mail que a apuração das posições envia ao participante, a de aprovação e a de reprovação.

Os documentos

A tela anexa o PDF e não edita o texto dos documentos. Cada modalidade tem autorização e regulamento próprios, e por isso são três regulamentos independentes, todos opcionais:

• Regulamento de sorteio (PDF): para campanha com a modalidade Sorteio.
• Regulamento de vale-brinde (PDF): vale-brinde é o nome comercial da posição premiada.
• Regulamento de pontos (PDF): para campanha com a modalidade Pontos.

Além deles há a política de privacidade (PDF). A orientação da própria tela é anexar apenas o que a campanha usar. Cada arquivo vai em PDF, com até 30 MB, e ganha um nome gerado no envio. O hotsite serve esses documentos nas páginas de regulamento e de política de privacidade.

O regulamento de pontos só aparece quando a campanha tem a modalidade Pontos. Os de sorteio e vale-brinde aparecem sempre. Tirar a modalidade Pontos esconde o campo, mas não apaga o documento já anexado. Se a leitura das modalidades falhar, o campo aparece, para não esconder um documento que já está lá.

Salvar a aba não apaga texto de regulamento cadastrado por outro caminho: a tela preserva esse texto mesmo sem exibi-lo.

As mensagens de e-mail

Cada mensagem tem dois modos: guiado e HTML. Há um seletor por mensagem.

No modo guiado, o operador preenche blocos: mostrar logo, endereço do logo, cor principal, título (obrigatório), texto, mostrar destaque e rodapé. Os textos são texto puro — HTML digitado ali sai escrito, e as quebras de linha são mantidas. Título, texto e rodapé aceitam variáveis.

O destaque é diferente nas duas mensagens. Na aprovação é o cartão do prêmio, com imagem, nome e valor, e pode ser desligado — ele também desaparece sozinho na posição sem prêmio. Na reprovação é o cartão do motivo, e não se desliga: aparece sempre que houver motivo.

Cor e logo em branco usam os da aba Hotsite no envio. A tela mostra os valores do hotsite como referência ao lado dos campos.

No modo HTML a tela não exige HTML: o operador escreve o texto normalmente, as quebras de linha são mantidas, e quem quiser formatar pode usar HTML. O e-mail sai sempre como HTML. Uma diferença importante: no modo HTML não há linha automática com o prêmio — ele só aparece onde o texto usar as variáveis de prêmio e de valor. Quem decide onde é quem configura.

Uma forma por mensagem é gravada: salvar grava a do modo escolhido e descarta a outra. Alternar o seletor não apaga nada enquanto não se salva — ao salvar, se a forma do outro modo tem conteúdo que se perderia, um modal lista o que será descartado e pede confirmação. Converter HTML para guiado não traduz nada: os blocos começam com o conteúdo padrão, e a tela avisa.

Há o botão de editar como HTML, que gera o HTML dos blocos atuais e troca para o modo HTML sem gravar. Antes, um modal diz o que muda: a cor fica fixa no HTML; na aprovação, o cartão do prêmio deixa de desaparecer sozinho, e a posição sem prêmio passa a receber o texto genérico; o texto HTML já escrito é substituído.

Campanha nova nasce com as duas mensagens no modo guiado, com o conteúdo padrão. As campanhas que já existiam ficaram no modo HTML, sem mudar o e-mail que enviam. Sem mensagem configurada, o e-mail usa um texto genérico que não cita o prêmio.

As variáveis

A lista de variáveis de cada mensagem vem do servidor, com a frase que explica cada uma, e fica visível ao lado da mensagem na tela. Cada variável é um botão que a insere na posição do cursor do último campo de texto focado. Se a lista não carregar, a tela continua editável, só sem ela.

Nem esta base de conhecimento nem a tela mantêm cópia dessa lista: para saber quais variáveis existem, consulte a própria tela.

O que vale saber sobre a substituição:

As variáveis de prêmio e de valor são o nome e o valor do prêmio do catálogo vinculado à posição. A variável de data é o dia da posição.

Todo valor é codificado antes de entrar no texto. O nome vem do cadastro do participante e não é confiável.

Variável que não é daquela mensagem fica no texto como está, sem erro. A variável de motivo escrita na aprovação, por exemplo, não é substituída e aparece literalmente.

Posição sem prêmio vinculado, ou prêmio sem valor: se a mensagem de aprovação usa a variável de prêmio ou de valor e a posição não tem prêmio, ou usa a de valor e o prêmio não tem valor, aquela mensagem não é usada — sai um texto genérico dizendo que a participação foi aprovada, para não enviar uma frase quebrada. Mensagem que não usa essas variáveis é enviada normalmente.

Reprovação sem a variável de motivo recebe o motivo em um parágrafo ao final, para os textos já salvos continuarem mostrando o motivo. No modo guiado isso não acontece, porque o motivo já está no destaque.

Há duas variáveis de imagem: a imagem do prêmio (só na aprovação) e o logo da campanha, que é o campo de logo da aba Hotsite. Elas se usam dentro de uma tag de imagem. Só vale endereço absoluto; qualquer outra coisa conta como vazia, e a tag de imagem inteira que usa a variável vazia é removida, para não sair imagem quebrada. Falta de imagem não aciona o texto genérico. No modo guiado as imagens têm bloco próprio, então a tela não oferece essas duas nos campos de texto.

A imagem só aparece para o participante se o endereço for público. Em ambiente de desenvolvimento os arquivos ficam em endereço local, que não abre fora da máquina: o e-mail chega com a imagem quebrada. A descrição das duas variáveis na tela diz isso.

A pré-visualização

Cada mensagem tem o botão de pré-visualizar, que abre um modal com o assunto e o corpo renderizado, e a frase de que é exemplo com dados fictícios.

A prévia é montada pelo mesmo caminho do envio — as mesmas variáveis, a mesma codificação, as mesmas reservas. Ela usa o texto que está na tela, não o salvo, e não grava nada nem envia e-mail.

Os dados fictícios são fixos. São reais o nome da campanha, o logo e a imagem do prêmio — a do primeiro prêmio ativo de posição premiada da campanha, com imagem válida. Um prêmio de sorteio mostraria na prévia um prêmio que nenhuma posição pode pagar, e por isso ele não entra.

Uma consequência a conhecer: imagem hospedada fora das origens liberadas pela política de segurança do painel não aparece na prévia, embora possa aparecer no e-mail enviado.

Se a mensagem de aprovação não vai informar o prêmio — no HTML, sem a variável de prêmio ou vazia; no guiado, com o destaque desligado e sem a variável em nenhum campo — a tela mostra um aviso que não bloqueia o salvamento.

Permissões

O formulário, a pré-visualização e o botão de salvar seguem a permissão de editar conteúdo.

Se houver alteração não salva e o operador clicar em cancelar, a tela pede confirmação antes de descartar.

A aba Conteúdos é onde o cliente coloca o que o participante lê e o que ele recebe por e-mail. Cinco orientações:

Os regulamentos são separados por modalidade: sorteio, vale-brinde e pontos. Vale-brinde é o nome comercial da posição premiada. Se a campanha usa mais de uma mecânica, é um anexo para cada. O de pontos só aparece na campanha que tem a modalidade Pontos.

O modo guiado é o caminho recomendado: o cliente preenche título, texto e rodapé, e o sistema monta o e-mail. O modo HTML existe para quem quer controle total do visual, e nele nada é automático — o prêmio só aparece se o cliente escrever a variável.

Antes de a fila de apuração começar a andar, vale pré-visualizar as duas mensagens. A prévia usa o mesmo motor do envio, com dados fictícios.

Se a campanha tem posições sem prêmio e a mensagem de aprovação cita o prêmio, aquelas aprovações vão receber um texto genérico em vez da mensagem do cliente. Isso evita enviar uma frase quebrada.

Se o cliente usar imagem no e-mail, o endereço dela precisa ser público. Imagem hospedada em lugar que não abre pela internet chega quebrada ao participante.

• Falha: o campo do regulamento de pontos não aparece na aba Conteúdos.
• Possivel causa: a campanha não tem a modalidade Pontos. Esse anexo só aparece nela.
• Como orientar: confira as modalidades no formulário da campanha. Se a campanha usa pontos, marque a modalidade e volte à aba Conteúdos.
• Quando escalar: se a modalidade Pontos estiver marcada e o campo continuar ausente, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o cliente quer editar o texto do regulamento pela aba e não encontra o campo.
• Possivel causa: a tela anexa o PDF e não edita o texto dos documentos.
• Como orientar: oriente a gerar o PDF do regulamento atualizado e anexá-lo de novo no campo correspondente.
• Quando escalar: não é falha.

• Falha: o participante recebeu um e-mail genérico que não é o texto configurado.
• Possivel causa: a mensagem de aprovação usa a variável de prêmio ou de valor, e aquela posição não tem prêmio vinculado ou o prêmio está sem valor. Nesses casos o texto genérico substitui a mensagem.
• Como orientar: confira se a posição tem prêmio vinculado e se o prêmio tem valor. Alternativa: escrever uma mensagem que não dependa dessas variáveis.
• Quando escalar: se a posição tiver prêmio com valor e o texto genérico continuar saindo, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o e-mail chegou sem o nome do prêmio no modo HTML.
• Possivel causa: no modo HTML não há linha automática com o prêmio. Ele só aparece onde o texto usa as variáveis de prêmio e de valor.
• Como orientar: insira as variáveis pela lista ao lado da mensagem, na posição do texto onde o prêmio deve aparecer.
• Quando escalar: não é falha.

• Falha: a imagem do prêmio chegou quebrada no e-mail.
• Possivel causa: o endereço da imagem não é público. Em ambiente de desenvolvimento os arquivos ficam em endereço local, que não abre fora da máquina.
• Como orientar: confira o endereço da imagem do prêmio e do logo. Em produção o endereço precisa ser acessível pela internet.
• Quando escalar: se o endereço for público, abrir no navegador e a imagem continuar quebrada no e-mail, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a imagem não aparece na pré-visualização, mas o cliente garante que o endereço funciona.
• Possivel causa: a política de segurança do painel não libera a origem daquela imagem na prévia. Ela pode aparecer no e-mail enviado.
• Como orientar: explique que a prévia é mais restritiva que o e-mail nesse ponto. Confira o endereço abrindo direto no navegador.
• Quando escalar: se a imagem estiver hospedada nos arquivos da própria plataforma e não aparecer na prévia, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o cliente trocou de modo e perdeu o texto que tinha escrito.
• Possivel causa: só a forma do modo salvo é gravada. Ao salvar, a tela lista o que será descartado e pede confirmação; e converter HTML para guiado não traduz o conteúdo.
• Como orientar: oriente a ler o modal de confirmação antes de salvar. Se o texto HTML era o bom, o caminho é não salvar e voltar ao modo HTML.
• Quando escalar: se o conteúdo tiver sido descartado sem a confirmação aparecer, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a lista de variáveis não aparece ao lado da mensagem.
• Possivel causa: a lista vem do servidor e aquela leitura falhou. A tela continua editável sem ela.
• Como orientar: recarregue a tela. Se a lista não voltar, o operador ainda pode salvar o texto, mas sem o aviso sobre o prêmio.
• Quando escalar: se a lista não carregar de forma recorrente, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a variável de motivo escrita na mensagem de aprovação aparece literalmente no e-mail.
• Possivel causa: variável que não é daquela mensagem fica no texto como está, sem erro. O motivo é variável da reprovação.
• Como orientar: remova a variável do texto da aprovação. Use somente as variáveis listadas para aquela mensagem.
• Quando escalar: não é falha.