Suporte
Documentação

Personalizando notificações e lembretes

Mensagens de e-mail e SMS geradas como parte do processo de cadastro e agendamento podem ser personalizadas ou substituídas pelas suas próprias mensagens. Mensagens de lembrete e de acompanhamento também podem ser personalizadas de maneira semelhante. Quase todas as mensagens podem conter os chamados “autotextos”, que são “palavras mágicas” substituídas automaticamente por algum valor dinâmico quando a mensagem é gerada.

Esta página trata de mensagens enviadas às pessoas, como e-mails de confirmação, lembretes, e-mails de cadastro e lembretes por SMS. Se você quiser alterar o texto exibido diretamente nas páginas de reserva, consulte Personalizando mensagens na tela.
Neste artigo, você verá:

As mensagens mostradas na tela durante o processo de agendamento também podem ser personalizadas usando uma sintaxe um pouco diferente. Veja a seção sobre Personalizando mensagens na tela para mais detalhes.

Notificações e lembretes personalizados por e-mail

Diferentes tipos de e-mail são enviados durante o processo de cadastro e agendamento. Em Configurar > Processo você pode escolher confirmar compromissos por e-mail e/ou enviar aos usuários um lembrete algum tempo antes do compromisso. Para personalizar confirmações, lembretes e acompanhamentos de reservas, vá para Configurar > Layout. Por padrão, o e-mail de confirmação contém as seguintes informações:

Use esta página para o conteúdo das mensagens. A decisão de enviar ou não uma confirmação, lembrete ou acompanhamento é configurada em Configurar > Processo.
Prezado(a) Nome,

Esta mensagem confirma que sua reserva* foi criada.

Detalhes da nova reserva*:

 … detalhes do compromisso…

Você pode acessar a agenda em:
https://www.supersaas.com/schedule/account_name/schedule_name?day=…

Por favor, não responda a esta mensagem. Ela foi gerada automaticamente e respostas não serão lidas.
* O termo “reserva” pode ser alterado em Configurar > Processo

E-mails de cadastro

Enquanto e-mails de confirmação e lembrete estão relacionados a compromissos específicos, e-mails de cadastro são enviados quando um usuário se registra. Quando o cadastro está habilitado, você pode escolher se ele precisa ser confirmado por e-mail na página Controle de acesso. Para personalizar o texto do e-mail de cadastro, vá para Configurações de layout. Por padrão, um e-mail de cadastro contém o seguinte:

Prezado(a) Nome,

Você se cadastrou para usar a agenda online de (nome da agenda)

Nome de login: (nome de login)


Obrigado por se cadastrar. Você pode visualizar e alterar suas informações clicando em ‘Suas configurações’ depois de fazer login. Recomendamos que você guarde uma cópia deste e-mail para referência.
* Se você tiver habilitado a verificação de usuário, este e-mail conterá um link

Ver e-mails enviados

Todo e-mail enviado a partir da sua conta fica armazenado no banco de dados por uma hora. Os e-mails podem ser visualizados na sua conta pela lista de e-mails enviados recentemente. Lá, você pode verificar quais mensagens foram enviadas na última hora, para quem foram enviadas e se contêm o conteúdo esperado.

O servidor de e-mail ignorará automaticamente qualquer mensagem enviada para um endereço que termine em @test.com, mas ela ainda aparecerá na lista de e-mails enviados recentemente. Você pode usar isso para testar vários e-mails sem precisar enviar mensagens para uma conta real.

Mensagens dinâmicas usando autotextos

Autotextos são “palavras mágicas” substituídas automaticamente por um valor dinâmico quando a mensagem é gerada. Isso permite, por exemplo, tratar usuários pelo nome ou tornar a mensagem dependente do idioma. Uma palavra de autotexto é simplesmente uma palavra precedida por $, por exemplo $name. Na tabela abaixo, você encontra as sequências de autotexto que podem ser usadas em mensagens de e-mail.


Sequências de autotexto para uso em mensagens de e-mail e lembretes por SMS
A palavra…… será substituída por
$nameO nome da pessoa para quem o e-mail é endereçado, se estiver disponível
$dearEscreve “Prezado(a) $name,”, a menos que $name não seja conhecido
$loginO nome de login do criador, vazio se for administrador ou se não estiver logado
$subjectO restante desta linha será usado como assunto do e-mail e pode conter outras palavras mágicas
$urlUm link que aponta para a agenda na data da reserva
$modurlUm link que contém um token permitindo modificar esta reserva sem fazer login
$actionDescreve que ação acionou este e-mail. Exemplo: “Sua reserva foi $action” → “Sua reserva foi criada”
$detailsLista os detalhes da reserva, útil se eles tiverem sido removidos pelo comando $replace abaixo
$replaceRemove todo o texto gerado pelo sistema; apenas o seu texto será mostrado
$nourlRemove apenas a URL do texto pré-gerado pelo sistema
$idO ID do objeto, útil para localizá-lo rapidamente na interface de supervisão
$slot_idO ID do horário ao qual este objeto pertence (somente Agenda de Capacidade)
$form_idO ID do formulário, se este objeto tiver um formulário anexado
$start
$finish
A hora de início e término desta reserva.
Use $start_time ou $finish_time para mostrar apenas o horário
$created
$updated
A data de criação desta reserva e a hora em que ela foi alterada ou excluída pela última vez
$whenMostra início e término, adicionando informações de fuso horário conforme a configuração
$previous_startSe o compromisso foi atualizado, mostra o horário de início anterior à atualização
$lengthA duração do compromisso exibida no formato H:MM ou DD:HH:MM
$icalA reserva será anexada à notificação como um arquivo iCalendar
$meeting_urlMostra o link para a reunião no Google Meet ou Zoom, se houver
$doorcodeMostra um código de 6 dígitos, compatível com a linha de fechaduras eletrônicas Nuki
$formSe um formulário estiver conectado a este objeto, ele será anexado como um arquivo HTML
$pricePreço do compromisso. Para compromissos recorrentes, é o preço do primeiro
$creditNível atual de crédito do usuário (após a criação do compromisso)
$resourcesOs nomes dos recursos conectados (somente Agenda de Serviço)
$positionMostra a posição na lista de espera (somente Agenda de Capacidade)
$addressMostra o conteúdo do campo de endereço, se disponível
$field_1
$field_2
Mostra o valor dos campos personalizados definidos na tela de configuração, aba Processo
$field_1a
$field_2a
Mostra o valor dos campos personalizados definidos na página Controle de acesso
$suMostra o valor do campo do supervisor, se estiver disponível
$if "action"O restante da frase só é exibido se action corresponder à ação atual. Para aplicar a condição a várias linhas, coloque-as entre chaves. Veja abaixo a lista de ações disponíveis
$else {mensagem}A cláusula $else só pode seguir uma cláusula $if. A mensagem deve ficar entre chaves e só será exibida se a condição anterior do $if não for verdadeira
$skipNão envie este e-mail. Pode ser combinado com $if e $else para enviar mensagens apenas em ações específicas
$title
$location
$quantity
$level
$description
Somente Agenda de Capacidade: título, local, descrição e quantidade reservada. $level mostra o número de reservas em um horário. Em agendas com múltiplos recursos, $description contém o nome do recurso
$serviceSomente Agenda de Serviço: a descrição do serviço. Para obter apenas o nome do serviço, você pode usar $description

Normalmente, o seu texto personalizado é anexado ao e-mail gerado pelo sistema. No entanto, se você usar a sequência $replace em qualquer ponto da mensagem, o seu texto substituirá completamente a mensagem do sistema.

Observe que o campo usado para ajustar o texto das confirmações de compromisso controla todas as confirmações possíveis por e-mail, não apenas confirmações de novas reservas. Para personalizar o texto de uma confirmação específica, você precisará usar a instrução condicional $if, como explicado abaixo.

Para confirmações e lembretes por e-mail, você pode visualizar a aparência da mensagem clicando no botão Visualizar ao lado do campo em que insere o autotexto. Isso mostrará um e-mail com base no compromisso atualizado mais recentemente.

Instruções “if”

Comandos de autotexto também podem ser encadeados. Use instruções $if para ajustar o conteúdo com base em ações como confirmações de agendamento, cancelamentos ou mudanças na lista de espera. O trecho abaixo só substitui o assunto quando um novo compromisso é criado e, caso contrário, mantém o assunto padrão:

$if "created" {$subject Você tem um novo compromisso em $start}

Condições disponíveis
A instrução $if aceita os seguintes valores: created, changed, deleted, approved, refunded, placed_on_the_waiting_list, changed_on_the_waiting_list, removed_from_the_waiting_list ou placed (placed significa que saiu da lista de espera e se tornou um compromisso regular).

$if "placed_on_the_waiting_list" {Você está na posição $position da lista de espera}

Condições específicas de idioma
Você também pode usar um identificador de idioma, como EN ou ES, para exibir uma mensagem apenas quando a pessoa tiver selecionado esse idioma no calendário.

$if "ES" {Gracias} $else {Thank you}
Várias condições podem ser combinadas com operadores lógicos (|| e &&), por exemplo:
$if "created || placed_on_the_waiting_list" {Obrigado pela reserva}
(um dos termos precisa ser verdadeiro)
$if "EN && deleted" {Cancelamento confirmado}
(os dois termos precisam ser verdadeiros)

Usando modurl
Outro uso dos autotextos é fornecer aos clientes um link direto para uma tela onde eles podem editar o compromisso. Você pode adicionar este texto às notificações por e-mail:
Para alterar seu compromisso online, acesse: $modurl

O código $modurl gera um link que contém um token e permite ao visitante desse link modificar ou excluir o compromisso sem precisar fazer login. Isso é especialmente útil se você permitir que as pessoas criem compromissos sem login, pois assim elas poderão alterar os próprios compromissos depois. Você pode ler mais sobre isso em nosso blog sobre personalização de e-mails.

Adicionando estilo às mensagens de e-mail

Por padrão, os e-mails são enviados em formato “Texto simples”, porque esse formato tem a maior chance de passar pelos filtros de spam. Ao mudar o formato do e-mail para HTML na página Configurações de layout, você passa a poder adicionar estilo às mensagens. O editor HTML de e-mails tem botões para adicionar cor e links, e você pode editar o HTML em si clicando no pequeno botão “Código-fonte” .

Se você adicionar muitos links ou imagens a um e-mail, aumenta o risco de ele ser marcado como spam. Observe também que o HTML suportado por clientes de e-mail é apenas um pequeno subconjunto daquele aceito pelos navegadores. Para piorar, cada cliente de e-mail suporta um subconjunto diferente de HTML e renderiza os elementos de forma ligeiramente distinta. Por isso, é melhor limitar-se às opções fornecidas pelo editor.

Se você for desenvolvedor e precisar de controle total sobre a formatação do e-mail, ou precisar anexar arquivos, talvez faça sentido enviar o e-mail a partir do seu próprio servidor.

Configurando o endereço “De”

As notificações por e-mail da sua conta são enviadas automaticamente com noreply@supersaas.com no campo “De:” da mensagem. É uma boa ideia mudar esse campo para tranquilizar seus usuários de que a mensagem veio de você e para garantir que as respostas retornem ao seu endereço. Você pode alterar essa configuração na tela Configurações de layout. Ali é possível adicionar um cabeçalho “Responder para” ou alterar o cabeçalho “De” para o seu próprio endereço.

Geralmente, usar um endereço personalizado de Responder para é a opção mais segura. Mudar o verdadeiro campo De dá mais controle de marca, mas exige configuração de DNS e boa entregabilidade.

Alterar o endereço “De” para o seu próprio endereço parece atraente, mas essa opção vem com a importante ressalva de que os e-mails correm maior risco de serem marcados como spam, porque não podemos assiná-los se o endereço “De” for diferente do nosso. Além disso, para cumprir os padrões da internet voltados à prevenção de spam, você precisará adicionar nosso servidor de e-mail ao registro SPF do seu DNS. Modificar o DNS pode ser complicado e talvez você nem tenha permissão para alterar o DNS do seu servidor de e-mail.

O cabeçalho “Responder para”, por outro lado, continuará enviando a mensagem com noreply@supersaas.com no campo “De”, mas a maioria dos clientes de e-mail mostrará o nome da sua conta como remetente e enviará as respostas para você. Como nosso servidor pode assinar criptograficamente a mensagem quando supersaas.com aparece no campo “De”, ela tem grande chance de passar pelos filtros de spam.

Além disso, os links mencionados nas mensagens de e-mail mostrarão supersaas.com, a menos que você configure um domínio personalizado e o vincule à sua conta.

A maioria dos domínios é configurada com um chamado registro SPF. Esse registro informa a outros servidores de e-mail que eles só devem aceitar mensagens de remetentes listados nesse SPF. Se você definir o endereço “De” como o seu próprio e-mail, nosso sistema verificará se existe tal registro SPF no DNS do seu domínio. Se o registro existir, ele precisará indicar que nosso servidor tem permissão para enviar e-mails. O texto específico que precisa aparecer no registro SPF é: include:spf.supersaas.com
Outra forma de usar o seu próprio endereço “De” é enviar e-mail pelo seu próprio servidor. Usar seu próprio servidor pode ser útil se você quiser evitar qualquer referência ao SuperSaaS nos cabeçalhos do e-mail e também poder assinar criptograficamente a mensagem para melhorar a entregabilidade. Isso exige um bom nível de conhecimento técnico.

Mensagens SMS personalizadas

Na página Integrações, você encontra a página “Gateway de SMS”, onde pode personalizar o conteúdo padrão do lembrete por SMS. Os mesmos códigos de autotexto usados para personalizar e-mails também podem ser usados para personalizar lembretes por SMS enviados aos seus clientes. Observe que isso não afeta notificações por SMS enviadas a você para informar sobre reservas novas ou atualizadas.

O conteúdo padrão do lembrete é: Lembrete: <título do compromisso> em <data e hora> O primeiro campo inserido mostrará o título do compromisso, e o segundo mostrará a data e a hora do compromisso. Por exemplo, se você não tiver modificado a mensagem, um lembrete para uma aula de ioga seria algo assim: Lembrete: Yoga (Briana) em 10/10/2026 18:00

Mais informações sobre a configuração de confirmações por SMS podem ser encontradas na documentação sobre confirmações e lembretes.