Variáveis dos e-mails: referência e exemplos
01Para que serve uma variável? #sec_aaa796f4
Uma variável reserva no modelo o lugar de uma informação que só será conhecida no momento do envio: recurso em questão, nome do revisor, prazo ou motivo de uma decisão. O REVIEWIT substitui esta etiqueta pelo valor fornecido pelo evento de negócio.
<title>Votre avis est attendu sur {ResourceName}</title>
<p>La réponse est attendue avant le {DueDate}.</p>O conteúdo de <title> torna-se o assunto do e-mail. As variáveis funcionam também no pré-cabeçalho, no corpo e nos atributos HTML.
02As cinco regras de sintaxe #sec_f4ae7b0c
- Utilize um único par de chaves: {ResourceName}.
- Respeite o uso de maiúsculas e minúsculas: {ResourceName} e {resourcename} são diferentes.
- Não invente uma variável a partir do seu rótulo em francês.
- Utilize apenas as variáveis garantidas para o evento selecionado.
- Envie um teste e verifique se nenhuma cadeia {Variable} permanece visível.
Os valores são codificados antes da sua inserção: um nome contendo < ou & não pode modificar a estrutura HTML. Uma variável ausente não é, no entanto, removida: ela permanece legível como está na mensagem.
03Recurso e campanha #sec_920795bd
| Variável | Significado | Exemplo | Ponto de atenção |
|---|---|---|---|
| {ResourceName} | Nome ou referência do recurso | Espaço Finanças ou #123 | Não presuma que é sempre um nome legível |
| {ResourceType} | Tipo funcional do recurso | SharePoint | Apresente-o como uma categoria |
| {Solution} | Solução fonte | Microsoft 365 | Pode diferir do tipo de recurso |
| {CampaignId} | Identificador técnico da campanha | 1842 | Não é um título |
| {CampaignTitle} | Título legível da campanha | Revisão trimestral dos acessos | A privilegiar quando disponível |
| {SizeFormatted} | Tamanho já formatado | 2,4 GB | Não faça conversão no HTML |
04Pessoas e responsabilidades #sec_a976ada6
| Variável | Significado | Exemplo |
|---|---|---|
| {OwnerName} | Proprietário ou responsável em questão | Camille Martin |
| {ReviewerName} | Revisor na origem da decisão | Alex Bernard |
| {DelegatorName} | Pessoa que delega | Samira Diallo |
| {EscalatedByName} | Pessoa que desencadeia a escalada | Morgan Petit |
| {ReassignedByName} | Pessoa que reatribui o pedido | Noah Robert |
| {RequesterName} | Autor de um pedido de supressão | Lina Moreau |
| {RequestedByName} | Autor de um pedido de parecer | Hugo Simon |
| {AnsweredByName} | Autor da resposta | Inès Laurent |
| {RedirectedByName} | Autor da redirecionamento | Louis Michel |
| {NewRecipientName} | Novo destinatário de uma consulta | Émilie Garcia |
| {CancelledByName} | Autor de um cancelamento | Adam Roux |
| {RevokedBy} | Pessoa ou serviço que revoga o acesso | Equipe Segurança |
| {DecidedBy} | Pessoa que toma a decisão | Nora Fournier |
05Datas e prazos #sec_0071f336
| Variável | Significado | Exemplo |
|---|---|---|
| {DueDate} | Prazo da revisão | 2026-09-15 |
| {AnswerDueDate} | Prazo de resposta a uma contestação | 15/09/2026 |
| {DaysToAnswer} | Número de dias concedidos | 7 |
| {WithdrawnDate} | Data de retirada da contestação | 31/08/2026 |
| {CancelledDate} | Data de cancelamento do pedido | 31/08/2026 |
| {ProcessedDate} | Data de processamento da supressão | 01/09/2026 |
Os formatos podem diferir de acordo com o evento. O valor já chega formatado: não tente transformá-lo no HTML.
06Decisões e textos livres #sec_4d708521
| Variável | Significado | Exemplo |
|---|---|---|
| {Decision} | Decisão tomada após escalada | Acesso retirado |
| {NewDecision} | Decisão aplicada após contestação | Conforme |
| {Reason} | Motivo inserido por uma pessoa | O papel não é mais necessário |
| {Argument} | Argumento de uma contestação | Este acesso permanece necessário para o encerramento |
| {Question} | Pergunta dirigida ao consultado | Este acesso ainda é necessário? |
| {Answer} | Resposta fornecida ao requerente | Sim, até o final do projeto |
| {Comment} | Comentário associado a um pedido | Supressão validada com o negócio |
| {ResolutionNote} | Nota resumindo a resolução | Justificação aceita após controle |
Os textos livres devem ser apresentados em uma citação ou bloco isolado. Não os insira no meio de uma frase: sua pontuação e conteúdo são imprevisíveis.
07Variáveis seguras para eventos de revisão #sec_26ebb516
| Evento | Variáveis garantidas |
|---|---|
| ReviewsAssigned | {ResourceName} {CampaignId} {DueDate} |
| ReviewReminder | {ResourceName} {CampaignId} {DueDate} |
| ReviewsExpired | {ResourceName} {CampaignId} {DueDate} |
| EscalationNotice | {ResourceName} {CampaignId} {DueDate} |
| EscalationReceived | {ResourceName} apenas |
| DelegationReceived | {ResourceName} {DelegatorName} {Reason} |
| RequestReassigned | {ResourceName} {ReassignedByName} {Reason} |
EscalationReceived tem vários caminhos. {EscalatedByName}, {Reason}, {CampaignId} e {DueDate} só estão presentes em alguns casos: o modelo padrão não deve depender deles.
08Variáveis seguras para contestações #sec_168763f9
| Evento | Variáveis garantidas |
|---|---|
| ChallengeRaised | {ResourceName} {ResourceType} {Solution} {OwnerName} {Argument} {AnswerDueDate} {DaysToAnswer} |
| ChallengeAccepted | {ReviewerName} {NewDecision} {ResolutionNote} |
| ChallengeDeclined | {ReviewerName} {ResolutionNote} |
| ChallengeWithdrawn | {OwnerName} {WithdrawnDate} |
| EscalatedDecisionNotice | {ResourceName} {DecidedBy} {Decision} {CampaignTitle} {Reason} |
09Variáveis seguras para eliminações e acessos #sec_f74356e3
| Evento | Variáveis garantidas |
|---|---|
| DeletionRequested | {ResourceName} {ResourceType} {Solution} {RequesterName} {Reason} {Comment} {SizeFormatted} |
| DeletionCancelled | {ResourceName} {CancelledByName} {CancelledDate} |
| DeletionProcessed | {ResourceName} {ProcessedDate} |
| AccessRevokedNotice | {ResourceName} {RevokedBy} {Reason} {CampaignTitle} |
10Variáveis seguras para consultas #sec_ae8e18fe
| Evento | Variáveis garantidas |
|---|---|
| AdviceRequestedNotice | {ResourceName} {RequestedByName} {Question} |
| AdviceReceivedNotice | {ResourceName} {AnsweredByName} {Answer} |
| AdviceRedirectedNotice | {ResourceName} {RedirectedByName} {NewRecipientName} |
11Eventos adormecidos #sec_f453ddcd
Os seguintes eventos estão presentes no catálogo, mas ainda não são emitidos automaticamente:
- PendingReviewsDigest ;
- ChallengeReminder ;
- DecisionAmended ;
- DeletionRejected ;
- ExceptionExpiring ;
- GracePeriodEntered.
Seu modelo pode ser preparado e visualizado. Não deve ser interpretado como prova de que uma comunicação automática já está ativa.
12Duas variáveis indisponíveis #sec_ad0f2f57
{DeepLink} e {SettingsLink} existem em alguns modelos históricos, mas nenhum valor é atualmente fornecido para eles. Não crie um botão ou link que dependa deles.
Algumas relanças manuais históricas também usam {{ReviewerName}}. Esta sintaxe de chaves duplas não é a das notificações automáticas. O editor deve sinalizá-la e pedir que você volte para {ReviewerName}.
13O controlo antes da publicação #sec_b3e3a4da
Um modelo está pronto quando :
- o seu evento está selecionado ;
- cada variável está garantida para este evento ;
- nenhuma chave dupla está presente ;
- os textos livres estão isolados em blocos adequados ;
- o assunto e o corpo foram pré-visualizados ;
- um teste real não deixa aparecer nenhuma variável não resolvida.
O editor do Subscription Manager aplica esta referência no momento de redigir: a paleta propõe as variáveis autorizadas, fornece um exemplo e as insere na posição do cursor. As variáveis desconhecidas ou indisponíveis bloqueiam o registo; as variáveis contextuais acionam um aviso.