Quando os usuários entram na sua instância Mastodon, eles recebem um e-mail de boas-vindas padrão gerado pelo servidor. Essa mensagem genérica não reflete a identidade da sua comunidade nem oferece orientações específicas para novos membros. Personalizar o e-mail de boas-vindas permite apresentar as regras da instância, hashtags recomendadas e a cultura local. Este artigo explica como um administrador de instância pode criar e implantar um modelo de e-mail de boas-vindas personalizado usando a interface administrativa do Mastodon.
Principais Pontos: Configuração de E-mail de Boas-Vindas Personalizado
- Preferências > Administração > Configurações do Site > User Mailer: Local do editor de modelo de e-mail personalizado para mensagens de boas-vindas a novos usuários.
- Variável de modelo de e-mail {{username}}: Insere automaticamente o nome de exibição do destinatário no corpo do e-mail de boas-vindas personalizado.
- Variável de modelo de e-mail {{instance_name}}: Insere o nome da sua instância definido nas Configurações do Site no e-mail de boas-vindas.
Entendendo o Sistema de E-mail de Boas-Vindas do Mastodon
O Mastodon envia um e-mail de boas-vindas para todo novo usuário registrado imediatamente após a confirmação da conta. O e-mail padrão é uma mensagem de texto simples que diz “Bem-vindo ao Mastodon” e inclui instruções básicas de login. Essa mensagem é gerada pelo módulo UserMailer no código da aplicação Mastodon. Você não pode editar o e-mail padrão pela interface web sem personalizar o modelo.
A interface administrativa do Mastodon inclui um recurso chamado Configurações do Site onde você pode configurar muitas opções da instância. Uma dessas configurações é a seção User Mailer, que fornece uma área de texto para um corpo de e-mail de boas-vindas personalizado. Esse modelo suporta um pequeno conjunto de variáveis que são substituídas por valores específicos do usuário quando o e-mail é enviado.
Para personalizar o e-mail de boas-vindas, você precisa ser um administrador da instância com acesso ao painel Administração. A alteração se aplica a todos os novos usuários que se registrarem após o modelo ser salvo. Usuários existentes não recebem o e-mail atualizado retroativamente.
Passos para Adicionar um E-mail de Boas-Vindas Personalizado na Sua Instância Mastodon
- Faça login como administrador
Use uma conta que tenha o papel de Administrador na sua instância Mastodon. Apenas administradores podem acessar o painel de Configurações do Site. - Abra o menu Administração
Clique no ícone do menu hambúrguer no canto superior esquerdo da interface do Mastodon. Selecione Preferências no menu suspenso. Na página de Preferências, clique em Administração na barra lateral esquerda. - Navegue até Configurações do Site
Na seção Administração, clique em Configurações do Site. Esta página contém todas as opções configuráveis no nível da instância. - Localize a seção User Mailer
Role a página de Configurações do Site até ver o título User Mailer. Esta seção contém uma única área de texto rotulada como Corpo do e-mail de boas-vindas. - Escreva seu modelo de e-mail personalizado
Na área de texto, digite o corpo do e-mail que deseja que novos usuários recebam. Você pode usar as seguintes variáveis que o Mastodon substituirá por valores reais:{{username}}— O nome de exibição do usuário conforme definido no perfil.{{instance_name}}— O nome da instância definido nas Configurações do Site em Título do Site.{{email}}— O endereço de e-mail do usuário.{{account_url}}— A URL da página de perfil do usuário.
Exemplo de modelo:
Bem-vindo ao {{instance_name}}, {{username}}!Estamos felizes por você ter se juntado. Aqui estão algumas dicas para começar:
- Apresente-se usando a hashtag #apresentacoes
- Leia as regras da instância em /about/more
- Siga a conta do admin em @adminSeu perfil está em {{account_url}}.
Boas postagens!
- Salve as configurações
Clique no botão Salvar alterações na parte inferior da página de Configurações do Site. O Mastodon aplicará o novo modelo de e-mail de boas-vindas imediatamente. - Teste o e-mail personalizado
Crie uma nova conta de teste na sua instância usando um endereço de e-mail separado. Verifique se o e-mail de boas-vindas contém sua mensagem personalizada e se todas as variáveis foram substituídas corretamente.
Erros Comuns e Limitações a Evitar
E-mail Personalizado Não Inclui Regras da Instância ou Links
O e-mail de boas-vindas padrão não inclui regras da instância ou links para páginas importantes. Seu modelo personalizado deve mencionar explicitamente a URL da página de regras da instância ou outros recursos que novos usuários precisam. O Mastodon não insere isso automaticamente. Você deve digitar a URL completa, por exemplo https://suainstancia.social/about/more.
Variáveis Aparecem como Texto Simples em Vez de Serem Substituídas
Se você vir {{username}} exibido literalmente no e-mail, o nome da variável está escrito errado ou usa colchetes incorretos. Use exatamente duas chaves de cada lado, sem espaços. Certifique-se também de usar os nomes de variáveis listados acima. O Mastodon ignora variáveis não reconhecidas e as deixa como texto simples.
E-mail Não Envia Após Alterar o Modelo
O e-mail de boas-vindas personalizado se aplica apenas a novos registros que ocorrerem após você salvar as configurações. Usuários existentes não receberão o e-mail atualizado. Se quiser reenviar um e-mail de boas-vindas para usuários existentes, você deve usar uma ferramenta de terceiros ou escrever um script personalizado usando a API do Mastodon. A interface administrativa não oferece uma opção de reenvio.
Formatação HTML Não Renderiza Corretamente
O e-mail de boas-vindas é enviado como texto simples, não HTML. Não use tags HTML como <b> ou <a>. O Mastodon as exibirá como texto simples no corpo do e-mail. Use formatação de texto simples com quebras de linha para estruturar sua mensagem.
| Item | E-mail de Boas-Vindas Padrão | E-mail de Boas-Vindas Personalizado |
|---|---|---|
| Conteúdo | Modelo genérico do Mastodon | Texto escrito pelo administrador |
| Variáveis suportadas | Nenhuma | {{username}}, {{instance_name}}, {{email}}, {{account_url}} |
| Formato | Texto simples | Texto simples |
| Escopo da atualização | Todos os novos usuários | Novos usuários após salvar o modelo |
| Local de edição | Não editável | Administração > Configurações do Site > User Mailer |
Com um e-mail de boas-vindas personalizado, você pode fornecer aos novos usuários orientação imediata e um senso de comunidade. Comece redigindo uma mensagem curta que inclua as regras da sua instância e uma hashtag recomendada para começar. Após salvar o modelo, teste com uma conta nova para confirmar que as variáveis funcionam. Para personalização avançada, considere editar o código-fonte do Mastodon diretamente ou usar a API para disparar e-mails de notificação personalizados.