> ## 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.

# DM ao entrar

> Mande a cada membro novo uma mensagem privada quando ele entra, com as regras ou um primeiro oi, sem encher um canal público.

## Visão geral

Envia uma mensagem direta para os novos membros no momento em que eles entram, independente da [mensagem de boas-vindas no canal](https://wiki.petto.sbs/pt-br/onboarding/welcome.md). Útil para as regras, um convite para se apresentar ou qualquer coisa que você não queira enchendo um canal público.

Como toda DM do Petto, esta começa com uma linha cinza `De <servidor>` e tem botões de info, apagar e denunciar: veja [DMs do Petto](https://wiki.petto.sbs/pt-br/moderation/dms-from-petto.md).

![A mensagem direta do Petto para a Mia: Oi Mia, boas-vindas ao Petto Land, leia as regras antes de conversar, você é o membro 1841](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-dm.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=e4e221e8f114ba22c35793c83a5e8017)

No Discord: a DM que a Mia recebe assim que entra no Petto Land.

![A aba Cargos e DM com Membros para humanos, Bots para bots, e a mensagem de DM ao entrar com a prévia](https://mintcdn.com/wikipetto/Z-XTVemdYTr1KRaH/images/dashboard/onboarding/pt-br/join-roles.webp?fit=max\&auto=format\&n=Z-XTVemdYTr1KRaH\&q=85\&s=8d551e541f2e82029aafbf542b2edba6)

Dashboard → Segurança → Filtro de entrada → Cargos e DM: os cargos de entrada e a DM ao entrar com a prévia.

A DM é enviada no momento em que o membro entra, mesmo quando o servidor faz a [boas-vindas esperar](https://wiki.petto.sbs/pt-br/onboarding/welcome.md#quando-a-boas-vindas-é-enviada) pelas regras ou pela integração. Ela costuma levar as regras ou os passos de verificação, então não deve esperar.

## Comandos

```javascript Syntax theme={null}
!dmonjoin setup [embed] [message]
!dmonjoin status
!dmonjoin test
!dmonjoin disable
!dmonjoinconfig
```

```javascript Example theme={null}
!dmonjoin setup --message "Boas-vindas ao {server_name}! Dê uma olhada em #regras para começar."
```

> [accordion] !dmonjoin setup
>
> ![kira configura a DM ao entrar e o Petto confirma e mostra a mensagem](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-setup.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=a6a7e74c72a6d116a986eee60147be92)
>
> No Discord: a DM fica com um texto usando `--message`.

> [accordion] !dmonjoin setup (sem nada)
>
> ![O Petto responde para informar uma message ou um embed](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-setup-empty.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=f578490f185929032f95b980af9c531b)
>
> No Discord: `setup` sem mensagem nem embed.

> [accordion] !dmonjoin status
>
> ![O Petto mostra que não há embed e a mensagem de texto da DM](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-status.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=5c50ef175f62226d56c8bd313f6a1d26)
>
> No Discord: o embed e a mensagem da DM.

> [accordion] !dmonjoin test
>
> ![kira usa !dmonjoin test e o Petto diz que a prévia foi enviada para as DMs dela](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-test.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=07571848f565a459e5c3d53d0670deb3)
>
> No Discord: a prévia vai para as suas DMs.

> [accordion] !dmonjoin test (a DM)
>
> ![A DM do Petto para a kira: Oi kira, boas-vindas ao Petto Land](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-test-dm.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=cae947acca781a257e62400fab3337bd)
>
> No Discord: a prévia nas suas DMs, com o seu próprio nome.

> [accordion] !dmonjoin disable
>
> ![O Petto confirma que a DM ao entrar foi desativada](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-disable.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=5c40c2f54e762cccce8f38c4c342c55e)
>
> No Discord: a DM ao entrar é desativada.

> [accordion] !dmonjoinconfig
>
> ![liam digita !dmonjoinconfig e o Petto responde com as configurações atuais de a DM ao entrar, os comandos e um botão Documentação](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/dm-on-join-config-card.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=0e5e3e2fc3cfbb185c928b1c63a7c674)
>
> No Discord: `!dmonjoinconfig`, as configurações de a DM ao entrar e os comandos para mudar.

`embed` tem prioridade sobre `message` se os dois estiverem definidos. `setup` precisa de uma mensagem ou de um embed. `test` envia uma prévia por DM para você mesmo. `!dmonjoin` também funciona como `!dmjoin`. `!dmonjoinconfig` mostra o que está configurado agora para a DM ao entrar e cada comando para mudar.

## Exemplos

> [tab] Lembrete das regras
>
> ```javascript Command theme={null}
> !dmonjoin setup --message "Oi {user.display_name}, boas-vindas ao **{server_name}**! Leia as regras antes de conversar, por favor. Você é o membro #{server_membercount}."
> ```
>
> ```text Result theme={null}
> Oi Liam, boas-vindas ao Cozy Corner! Leia as regras antes de conversar, por favor. Você é o membro #1204.
> ```

> [tab] Agradecer quem convidou
>
> ```javascript Command theme={null}
> !dmonjoin setup --message "Boas-vindas ao {server_name}! {inviter.name} te convidou, agradeça no chat 💌"
> ```
>
> ```text Result theme={null}
> Boas-vindas ao Cozy Corner! Mia te convidou, agradeça no chat 💌
> ```

> [tab] Embed salvo
>
> ```javascript Command theme={null}
> !dmonjoin setup dm-welcome
> ```
>
> Envia o [embed](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md) salvo `dm-welcome`. As variáveis dele são preenchidas para o novo membro.

Em uma DM, as variáveis de canal como `{channel}` apontam para a própria DM, então mencione os canais escrevendo-os por extenso (`<#123456789012345678>`). As [variáveis de convite](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md#convites) funcionam aqui como nas mensagens de boas-vindas.

> [!WARNING]
>
> Membros com as DMs fechadas para quem não é amigo simplesmente não vão receber a mensagem, e o bot não tem como detectar nem contornar isso.

![O cartão DM ao entrar com a mensagem e a prévia: Oi Liam, boas-vindas ao Petto Land](https://mintcdn.com/wikipetto/NrGrZ7c5mnuxcpr5/images/dashboard/onboarding/pt-br/dm-on-join-dashboard-card.webp?fit=max\&auto=format\&n=NrGrZ7c5mnuxcpr5\&q=85\&s=915dcd98c805f33c6e72498420d784d1)

Dashboard → Segurança → Filtro de entrada → Cargos e DM: o cartão DM ao entrar, com a mensagem e a prévia.


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