# Boas-vindas Receba quem entra no Discord com mensagem, imagem, cargo e DM, e avise quando alguém sai do servidor. Source: https://fivedash.fivex.gg/docs/pt/discord/welcome As **Boas-vindas** recebem cada novo morador da cidade assim que ele entra no Discord: uma mensagem no canal, um cargo na hora e, se você quiser, uma mensagem privada com botões. Quando alguém vai embora, o bot também pode avisar. Esta página é para o dono e a equipe que cuidam do Discord do servidor. ## Antes de começar * **Plano:** o módulo Discord precisa estar no plano da organização (vale para Plus, Pro e Ultra). * **Bot conectado:** o bot da cidade precisa estar conectado ao servidor do Discord, com o **Server Members Intent** ligado no Developer Portal. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot). * **Nível de acesso** na área **Boas-vindas**: | Nível | O que permite | | -------------- | ------------------------------------------------- | | **Ver** | Entradas e saídas (números e tabela de atividade) | | **Configurar** | Mensagens, cargo e DM (salvar e **Enviar teste**) | * **Cargo ao entrar:** o cargo do bot precisa estar **acima** dele no Discord. Cargos acima do bot aparecem como **Acima do bot** no seletor. > As entradas chegam por um serviço que fica conectado ao Discord o tempo todo. Se ele estiver fora do ar, a página mostra um aviso ("O serviço que avisa das entradas está fora do ar desde…") e as boas-vindas só voltam quando ele reconectar. O **Enviar teste** funciona mesmo assim. ## O que acontece quando alguém entra 1. O bot registra a entrada na atividade (mesmo com as boas-vindas desligadas). 2. Com as boas-vindas **Ativa**, ele dá o **Cargo ao entrar**, se escolhido. 3. Publica a mensagem de boas-vindas no **Canal das boas-vindas**. Se **Mencionar o membro** estiver ligado, marca a pessoa acima da mensagem para ela ser notificada. 4. Se a **Mensagem privada** estiver ligada, manda uma DM com o texto e os botões. Quem fecha a DM para servidores não recebe. Quando alguém sai, o bot registra a saída e, com **Avisar quando alguém sair** ligado, publica a despedida no **Canal da despedida**. Contas de bot são ignoradas nas entradas e saídas. ## Configurar as boas-vindas ### Abra a página No painel, vá em **Discord → Boas-vindas**. ### Escolha o canal Em **Mensagem → Canal**, escolha o **Canal das boas-vindas**. ### Escolha o cargo (opcional) Em **Cargo → Cargo ao entrar**, escolha o cargo dado na hora a todo mundo que entra. ### Ligue a despedida (opcional) Em **Despedida**, ligue **Avisar quando alguém sair** e escolha o **Canal da despedida**, ou deixe **Mesmo das boas-vindas**. ### Ajuste os textos Na coluna da direita, clique em **Mensagens** (**Textos e imagens**) para editar as boas-vindas, a despedida e a DM. Clique em **Aplicar**. ### Ligue e salve Ligue a chave no topo (**Ativa**) e clique em **Salvar** na barra de baixo. ### Teste Clique em **Enviar teste**. O bot se dá as boas-vindas no canal escolhido, usando o próprio nome e foto. O aviso **Teste enviado** confirma. > Usa a verificação? Dê aqui um cargo de "não verificado" e marque ele em **Verificação → Remover cargo**, para ele sair quando a pessoa passar no captcha. Não use o cargo de verificado como cargo de entrada: todo mundo pularia a verificação. A página avisa nos dois casos. ## Configurações | Grupo | Campo | O que faz | Padrão | | ------------- | ------------------------------------- | ---------------------------------------------------------------- | ------------------------- | | **Mensagem** | **Canal** (**Canal das boas-vindas**) | Onde o bot recebe quem acabou de entrar. Obrigatório para ligar. | Nenhum | | **Cargo** | **Cargo ao entrar** | Opcional. Dado na hora a todo mundo que entra. | Nenhum | | **Despedida** | **Avisar quando alguém sair** | Uma mensagem curta com o nome de quem saiu. | Desligado | | **Despedida** | **Canal da despedida** | Separe as saídas num canal da equipe, se preferir. | **Mesmo das boas-vindas** | ## Mensagens Em **Mensagens**, o diálogo **Personalizar mensagens** tem três seções. Use **Restaurar padrão** para voltar aos textos originais no idioma da cidade. ### Boas-vindas | Campo | O que faz | Limite | Padrão | | ---------------------- | -------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | **Título** | Título da mensagem. | 120 | "Bem-vindo(a), `{nome}`!" | | **Mensagem** | Texto da mensagem. | 1500 | "Que bom ter você em **`{servidor}`**! Dá uma lida nas regras, passe pela verificação e aproveite a cidade." | | **Imagem** | Opcional. Larga (2:1), embaixo do texto. | — | Nenhuma | | **Miniatura** | Quadrada, no canto direito da mensagem: **Foto do membro**, **Imagem própria** ou **Nenhuma**. | — | **Foto do membro** | | **Mencionar o membro** | Marca a pessoa acima da mensagem, para ela receber a notificação. Menções dentro do embed não notificam. | — | Ligado | A mensagem precisa de um título, um texto ou uma imagem. ### Despedida | Campo | O que faz | Limite | Padrão | | ------------- | ------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------- | | **Despedida** | Avisa quando alguém sai do servidor (a mesma chave de **Avisar quando alguém sair**). | — | Desligado | | **Mensagem** | Texto da despedida. | 500 | "**`{nome}`** saiu do servidor. Agora somos `{membros}`." | | **Imagem** | Opcional. Larga (2:1), só na despedida. | — | Nenhuma | | **Miniatura** | **Foto do membro**, **Imagem própria** ou **Nenhuma**. | — | **Foto do membro** | ### Mensagem privada | Campo | O que faz | Limite | Padrão | | -------------------- | -------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------- | | **Mensagem privada** | Também manda uma mensagem direta para quem entrou. | — | Desligado | | **Mensagem** | Texto da DM. Obrigatório com a DM ligada. | 1000 | "Olá, `{nome}`! Seja bem-vindo(a) a **`{servidor}`**. Qualquer dúvida, é só chamar a equipe." | | **Botões** | Até 5 botões numa linha, embaixo da DM. | 5 | Nenhum | Cada botão da DM tem: | Campo | O que faz | Limite | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------ | | **Estilo** | **Link** (abre um site, convite ou loja), ou **Azul**, **Cinza**, **Verde**, **Vermelho** (respondem com uma mensagem quando clicados). | — | | **Texto** | Texto do botão, com emoji opcional. Precisa de texto ou emoji. | 80 | | **Link** | Só no estilo **Link**. Precisa começar com `https://`. | 512 | | **Resposta ao clicar** | Só nos estilos coloridos. Sem resposta, o clique é só confirmado. Só quem clicou vê, na própria DM. | 1000 | ### Variáveis Digite `/` num texto para inserir uma variável. Os nomes são os mesmos em qualquer idioma. | Variável | O que vira | | ------------ | ------------------------------------ | | `{membro}` | Marca quem entrou (@Jogador) | | `{nome}` | O nome de exibição do membro | | `{servidor}` | O nome do servidor do Discord | | `{membros}` | Quantos membros o servidor tem agora | ## Embed Em **Embed**, o diálogo **Personalizar embed** define o visual de todas as mensagens das boas-vindas. | Campo | O que faz | Padrão | | ------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------- | | **Cor** | A barra lateral das mensagens das boas-vindas. | Cor do bot | | **Cabeçalho do servidor** | Nome e ícone do servidor do Discord no topo. | Desligado | | **Rodapé** | Texto curto (até 100 caracteres), com um ícone opcional do pacote do bot. O ícone só aparece junto de um texto. | Vazio | Imagens: PNG, JPG, WebP ou GIF de até 1 MB. ## Visão geral e atividade A **Visão geral** mostra o total de membros do servidor e os **Últimos 7 dias**: | Número | O que mostra | | ----------------- | ------------------------------------------------------------------- | | **Entradas** | Quem entrou nos últimos 7 dias, comparado com os 7 dias anteriores. | | **Entradas hoje** | Entradas de hoje, hora a hora, comparadas com ontem. | | **Saídas** | Quem saiu nos últimos 7 dias. | | **Saldo** | Entradas − saídas. | A tabela **Atividade** lista cada entrada e saída com **Membro**, **Conta criada**, **Evento** (**Entrou** ou **Saiu**) e **Quando**. Dá para buscar por nome ou ID, filtrar por evento, escolher o **Período** (**Últimas 24 horas**, **Últimos 7 dias**, **Últimos 30 dias**, **Todo o período**) e mostrar 10, 25 ou 50 linhas por página. ## Perguntas frequentes **O teste funcionou, mas ninguém recebe as boas-vindas. Por quê?** Confira se a chave está em **Ativa** e se a página não mostra o aviso do serviço que avisa das entradas. Confira também se o **Server Members Intent** está ligado no Developer Portal. **O membro não recebeu a DM.** Quem fecha a DM para servidores não recebe a mensagem privada. Não há como contornar isso pelo bot. **A despedida pode ir para outro canal?** Sim. Em **Despedida → Canal da despedida**, escolha um canal da equipe. Sem escolha, ela vai no canal das boas-vindas. ## Próximos passos [Verificação](https://fivedash.fivex.gg/docs/pt/discord/verification) Peça um captcha antes de liberar os canais. [Connect](https://fivedash.fivex.gg/docs/pt/discord/connect) Um painel fixo com o status e o connect da cidade. [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot) Intents, cor e pacote de emojis do bot. [Visão geral do Discord](https://fivedash.fivex.gg/docs/pt/discord/overview) Todos os módulos do bot da cidade.