Mensagens de boas-vindas

O Kakashi pode enviar uma mensagem de boas-vindas personalizada para um canal configurado sempre que um membro entra. O editor aceita conteúdo normal e embed, permitindo desde uma mensagem simples até uma apresentação com a identidade do servidor.

Fluxo recomendado

1. Escolha o destino com /config welcome channel.
2. Abra o editor de boas-vindas e configure o conteúdo e/ou embed.
3. Insira variáveis dinâmicas onde forem úteis.
4. Visualize o resultado.
5. Execute /config welcome test em vez de esperar um membro real entrar.
6. Use /config welcome remove quando quiser desativar a mensagem.

Conteúdo editável

O editor atual aceita mensagem normal e campos de embed como:

• título;
• cor;
• descrição;
• thumbnail;
• imagem.

Imagem e thumbnail devem usar URLs válidas, e as cores devem usar um valor hexadecimal válido.

Variáveis

O sistema de boas-vindas aceita variáveis como:

{member}
{member.tag}
{member.avatar}
{server.name}
{server.icon}
{server.members}

Exemplo:

Boas-vindas {member} ao **{server.name}**!
Você é o membro #{server.members}.

Use {member} quando quiser realmente mencionar a pessoa que entrou. Use as variantes de tag/avatar/servidor quando precisar de texto ou valor de imagem.

dica

Execute o teste integrado depois de cada mudança importante no embed. É muito mais rápido do que descobrir uma URL quebrada ou uma cor ilegível quando alguém entrar de verdade.

Dicas de design

Mantenha a primeira mensagem útil. Uma boa mensagem de entrada geralmente responde uma ou duas perguntas imediatas — onde começar, onde estão as regras ou qual é o próximo passo — em vez de virar uma parede de texto.

Se usar uma imagem grande, mantenha as instruções essenciais também em texto; o carregamento da imagem não deve ser a única forma de entender o onboarding.

Permissões

O Kakashi precisa conseguir ver o canal de destino e enviar mensagens nele. Se a mensagem usar embeds ou mídia vinculada, as permissões correspondentes também precisam estar liberadas nas sobrescritas desse canal.

Erros comuns

• Configurar um canal onde o Kakashi não pode enviar mensagens.
• Colar uma URL inválida para imagem/thumbnail.
• Usar uma cor hexadecimal inválida.
• Escrever uma variável não suportada pelo renderer de boas-vindas.
• Esquecer de testar depois de alterar as sobrescritas de permissões do canal.

Solução de problemas

Nada é enviado

Confirme que existe um canal de boas-vindas configurado e que o Kakashi consegue vê-lo/enviar nele. Depois use /config welcome test para separar um problema de configuração de um problema no evento real de entrada.

A mensagem funciona, mas o embed não

Verifique a permissão Inserir Links e valide as URLs e a cor usadas no editor.

Uma variável aparece como texto literal

Use exatamente um dos nomes de variável suportados e documentados acima.