> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensagens de boas-vindas

> Publique uma saudação no canal que você escolher sempre que alguém entra, como texto com variáveis ou um embed salvo, e veja como fica antes de alguém chegar.

## Visão geral

Enviada em um canal que você escolher sempre que um novo membro entra. Use texto simples com [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md), ou um [embed](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md) salvo.

![O Petto dá boas-vindas à Mia no Petto Land no canal de boas-vindas e diz que ela é o membro 1841](https://mintcdn.com/wikipetto/ym43wKcqHRA_RnWi/images/discord/onboarding/pt-br/welcome.webp?fit=max\&auto=format\&n=ym43wKcqHRA_RnWi\&q=85\&s=d01f93ec74b2b9083181b2da38e2e9cf)

No Discord: as boas-vindas que o Petto publica quando um membro entra.

No dashboard, as mensagens de boas-vindas, de saída e de boost ficam lado a lado em **Segurança → Filtro de entrada → Mensagens**, cada uma com uma prévia ao vivo de como fica no Discord.

![A aba Mensagens da página Boas-vindas com as mensagens de boas-vindas, saída e boost do Petto Land e as prévias](https://mintcdn.com/wikipetto/Z-XTVemdYTr1KRaH/images/dashboard/onboarding/pt-br/welcome.webp?fit=max\&auto=format\&n=Z-XTVemdYTr1KRaH\&q=85\&s=5235aea0743cb4a2b1097b3740eac7c8)

Dashboard → Segurança → Filtro de entrada → Mensagens: as mensagens de boas-vindas, saída e boost, cada uma com a prévia.

## Comandos

```javascript Syntax theme={null}
!welcome setup <channel> [embed] [message]
!welcome status
!welcome test
!welcome disable
!welcomeconfig
```

```javascript Example theme={null}
!welcome setup #boas-vindas --message "Boas-vindas ao {server_name}, {user}!"
!welcome setup #boas-vindas welcome-embed
```

```text Result theme={null}
✅ As mensagens de boas-vindas serão publicadas em #boas-vindas.
Mensagem: Boas-vindas ao {server_name}, {user}!
```

> [accordion] !welcome setup (uma mensagem)
>
> ![kira configura as boas-vindas em #boas-vindas com --message e o Petto confirma o canal e mostra a mensagem com as variáveis](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-setup-message.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=a0deffa4481ecccae3301a27d892ad09)
>
> No Discord: as boas-vindas ficam com um texto usando `--message`.

> [accordion] !welcome setup (um embed salvo)
>
> ![kira aponta as boas-vindas para o embed salvo welcome-embed e o Petto confirma](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-setup-embed.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=cef9842bdbe2b678da8f54e082f71428)
>
> No Discord: as boas-vindas usam o embed salvo `welcome-embed`.

> [accordion] !welcome status
>
> ![O Petto mostra o canal #boas-vindas, nenhum embed e a mensagem de texto](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-status.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=c5c31181a4d6b3496f8fad7266f44cbb)
>
> No Discord: o canal, o embed e a mensagem das boas-vindas.

> [accordion] !welcome test
>
> ![kira usa !welcome test em #boas-vindas, o Petto dá boas-vindas à kira como membro 1841 e diz que o teste foi enviado](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-test.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=bb1e670c0d00852058796b2b1b403c44)
>
> No Discord: o teste publica as boas-vindas com a sua própria conta e depois confirma.

> [accordion] !welcome test (sem configurar)
>
> ![O Petto responde que as mensagens de boas-vindas não estão totalmente configuradas e para usar !welcome setup primeiro](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-test-not-configured.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=506eddb6f6a069e7008171b8ea6e75c9)
>
> No Discord: um teste antes de as boas-vindas terem canal e mensagem.

> [accordion] !welcome disable
>
> ![O Petto confirma que as mensagens de boas-vindas foram desativadas](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-disable.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=51ab56802efaea8252dd7c47cbdf7d39)
>
> No Discord: as mensagens de boas-vindas são desativadas.

> [accordion] !welcomeconfig
>
> ![liam digita !welcomeconfig e o Petto responde com as configurações atuais de as boas-vindas, os comandos e um botão Documentação](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-config-card.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=3234d20963ee2c22d4cc9c02c8b323c3)
>
> No Discord: `!welcomeconfig`, as configurações de as boas-vindas e os comandos para mudar.

`embed` tem prioridade sobre `message` se os dois estiverem definidos. `test` envia a mensagem com a sua própria conta como novo membro, sem ninguém entrar de verdade. `!welcome` também funciona como `!wc`. `!welcomeconfig` mostra o que está configurado agora para as boas-vindas e cada comando para mudar.

> [!WARNING]
>
> Escreva `--message` antes de uma mensagem de texto. Sem isso, a primeira palavra depois do canal é lida como o nome de um embed salvo: `!welcome setup #boas-vindas Olá {user}` procura um embed chamado `Olá`. Um **código de embed** não precisa de `--message`: `!welcome setup #boas-vindas {embed}$v{description: Oi {user.mention}}$v{button: green && Regras && embed:regras}` o salva inteiro como mensagem, com seus [botões](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md#botões-com-ação).

![kira digita !welcome setup #boas-vindas Olá \{user} e o Petto responde que nenhum embed chamado Olá foi encontrado](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-setup-no-embed.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=26ebac8fb9b00f2a154f0fa44adb01ff)

No Discord: sem `--message`, a primeira palavra é lida como o nome de um embed salvo.

## Quando a boas-vindas é enviada

Por padrão a boas-vindas é enviada no momento em que o membro entra, como sempre. Um servidor pode escolher quando ela sai (dashboard: **Segurança → Filtro de entrada → Mensagens → Boas-vindas → Enviar a boas-vindas**):

| Valor | Quando a boas-vindas é enviada |
| - | - |
| Assim que o membro entra (o padrão) | Na hora. Nada muda para os servidores que não mexem nisso. |
| Depois que o membro aceita as regras | Quando o membro aceita as regras do servidor (Membership Screening). Um membro que nunca as aceita nunca recebe a boas-vindas. |
| Depois das regras e da integração | Quando o membro também termina a integração (onboarding) do Discord, as perguntas que dão cargos e canais. Em alguns servidores os membros podem pular a integração, então a boas-vindas é enviada mesmo assim **10 minutos depois de aceitar as regras**, ou **30 minutos depois de o membro entrar** quando o servidor não tem regras para aceitar. |

Isso só funciona quando **Membership Screening** ou **Onboarding do servidor** estão ativados no Discord (Configurações do servidor → Configuração de segurança e Integração). Um membro que não espera nada (um bot, alguém que já terminou, um membro que saiu e voltou) recebe a boas-vindas na hora.

Só a boas-vindas espera. Todo o resto continua imediato: a [DM ao entrar](https://wiki.petto.sbs/pt-br/onboarding/dm-on-join.md) costuma levar as regras ou os passos de verificação e o [ping ao entrar](https://wiki.petto.sbs/pt-br/onboarding/ping-on-join.md) existe para trazer o membro, então os dois saem na hora, assim como os logs de entrada, o rastreio de convites, os [cargos de entrada](https://wiki.petto.sbs/pt-br/onboarding/join-roles.md) e o bônus de nível. Um membro que sai antes de a boas-vindas ser enviada é descartado, uma boas-vindas em espera sobrevive a um reinício do Petto, e uma espera de 7 dias é esquecida. Se você desligar o ajuste enquanto há membros esperando, eles não recebem a boas-vindas atrasada: só os novos recebem na hora.

## Segunda boas-vindas

Um servidor pode ter **duas boas-vindas**: por exemplo uma em um canal de boas-vindas e outra no chat geral. A segunda tem seu próprio canal, mensagem (ou embed ou design salvo, com as mesmas [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md)) e seu próprio interruptor. Ela é enviada logo depois da primeira, segue o mesmo [ajuste de espera](#quando-a-boas-vindas-é-enviada), e se uma não puder ser publicada (o canal não existe mais ou o Petto não pode escrever) a outra é enviada mesmo assim; o log avisa uma vez por hora.

```javascript Syntax theme={null}
!welcome second-setup <canal> [embed] [mensagem]
!welcome second-disable
```

```javascript Example theme={null}
!welcome second-setup #geral --message "Todo mundo dê oi para {user}!"
```

`!welcome status` e `!welcome test` cobrem as duas boas-vindas, e o dashboard tem um cartão **Segunda boas-vindas** ao lado da primeira.

## Exemplos

Todos os exemplos podem ser colados do jeito que estão. Os resultados mostram o que um membro chamado Liam vê quando entra no **Cozy Corner** como o 1.204º membro.

> [tab] Simples
>
> ```javascript Command theme={null}
> !welcome setup #boas-vindas --message "Boas-vindas ao **{server_name}**, {user}! 🎉"
> ```
>
> ```text Result theme={null}
> Boas-vindas ao Cozy Corner, @Liam! 🎉
> ```

> [tab] Número do membro
>
> ```javascript Command theme={null}
> !welcome setup #boas-vindas --message "Oi {user}, você é o nosso **{user.join_position_suffix}** membro! Pegue seus cargos e diga oi."
> ```
>
> ```text Result theme={null}
> Oi @Liam, você é o nosso 1204º membro! Pegue seus cargos e diga oi.
> ```

> [tab] Quem convidou
>
> ```javascript Command theme={null}
> !welcome setup #boas-vindas --message "Boas-vindas, {user}! Você foi convidado por {inviter}, que agora tem {inviter.invites} convites."
> ```
>
> ```text Result theme={null}
> Boas-vindas, @Liam! Você foi convidado por @Mia, que agora tem 12 convites.
> ```
>
> As variáveis de convite precisam que o Petto tenha **Gerenciar servidor**. Quando o Petto não consegue saber qual convite foi usado (um link personalizado, por exemplo), `{inviter}` mostra Desconhecido.

> [tab] Saudação aleatória
>
> ```javascript Command theme={null}
> !welcome setup #boas-vindas --message "{choose:Olha quem chegou|Um membro selvagem apareceu|Seja bem-vindo a bordo}, {user}! {reactreply:👋}"
> ```
>
> ```text Result theme={null}
> Um membro selvagem apareceu, @Liam!
> (o Petto reage com 👋 à própria mensagem)
> ```

> [tab] Com um cartão de imagem
>
> ```javascript Command theme={null}
> !welcome setup #boas-vindas --message "Boas-vindas, {user}! {imgcard:welcome}"
> ```
>
> Envia o texto com o [cartão de imagem](https://wiki.petto.sbs/pt-br/resources/image-cards.md) chamado `welcome` desenhado para o membro (o avatar e o nome dele no seu design).

## Usando um embed salvo

**1. Crie o embed**

Monte na página **Embeds** do dashboard, ou a partir de um código:

```javascript Command theme={null}
!embed create welcome-embed {embed}$v{title: Boas-vindas ao {server_name}!}$v{description: Oi {user}, você é o membro número **{server_membercount}**.{newline}Leia as regras e escolha seus cargos.}$v{thumbnail: {user.avatar}}$v{color: #f0a88f}
```

![kira cria welcome-embed a partir de um código e o Petto responde com o embed: Boas-vindas ao Petto Land, membro número 1841](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-embed-step-1-create.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=ec4c9c8e503bcc830512009a26d6e3e1)

No Discord: o embed é salvo a partir de um código e o Petto mostra ele preenchido para você.

**2. Aponte as boas-vindas para ele**

```javascript Command theme={null}
!welcome setup #boas-vindas welcome-embed
```

![O Petto confirma que as boas-vindas vão para #boas-vindas com o embed welcome-embed](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-embed-step-2-setup.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=1a60f166d894c195f7ca6a7323343fd4)

No Discord: as boas-vindas agora usam `welcome-embed`.

**3. Teste**

```javascript Command theme={null}
!welcome test
```

Você recebe o embed em `#boas-vindas` com o seu próprio nome, avatar e a quantidade real de membros.

![kira usa !welcome test e o Petto publica o embed de boas-vindas para a kira com o avatar dela e o número de membro 1841](https://mintcdn.com/wikipetto/DDKlM2GsalxhQwiX/images/discord/onboarding/pt-br/welcome-embed-step-3-test.webp?fit=max\&auto=format\&n=DDKlM2GsalxhQwiX\&q=85\&s=766de7b281c89daca79faab5a329f65f)

No Discord: o teste publica o embed com o seu nome, avatar e a quantidade real de membros.

## Variáveis

Todas as [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md) funcionam. As feitas para boas-vindas:

| Variável | O que mostra | Exemplo |
| - | - | - |
| `{user}` | Menciona o novo membro | @Liam |
| `{user.display_name}` | O nome dele no servidor | Liam |
| `{user.join_position_suffix}` | O número de membro dele como ordinal | 1204º |
| `{user.created_at_timestamp}` | Quando a conta foi criada, para usar como `<t:…:R>` | há 6 anos |
| `{server_membercount}` | Membros agora | 1204 |
| `{inviter}` / `{inviter.name}` | Quem convidou | @Mia / Mia |
| `{inviter.invites}` | Quantos convites essa pessoa tem | 12 |
| `{invite.code}` | O convite que foi usado | cozy |

![A aba Mensagens com o menu Variáveis aberto sobre a mensagem de boas-vindas, com \{user}, \{user.mention}, \{user.name} e mais](https://mintcdn.com/wikipetto/NrGrZ7c5mnuxcpr5/images/dashboard/onboarding/pt-br/welcome-variables-menu.webp?fit=max\&auto=format\&n=NrGrZ7c5mnuxcpr5\&q=85\&s=95ed9e1c32c5fa793fbadc05bcd2ee8b)

Dashboard → Segurança → Filtro de entrada → Mensagens: o menu Variáveis mostra cada variável; clique em uma para copiar.

Coloque um `!` antes de uma menção (`!@everyone`, `!@Moderadores`) para mostrá-la sem notificar ninguém: veja [Menções silenciosas](https://wiki.petto.sbs/pt-br/concepts/variables-engine.md#menções-silenciosas).

## Relacionados

> [card] [DM ao entrar](https://wiki.petto.sbs/pt-br/onboarding/dm-on-join.md)
>
> Uma mensagem privada para cada novo membro.

> [card] [Mensagens de saída](https://wiki.petto.sbs/pt-br/onboarding/leave.md)
>
> O mesmo, quando alguém sai.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.