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

# Cargos ao entrar

> Dê um ou mais cargos a cada membro assim que ele entra, para todos, só para pessoas ou só para bots.

## Visão geral

Os cargos ao entrar são dados aos membros no momento em que eles entram no servidor. Use para um cargo base de "Membro", ou para um cargo separado para bots.

Precisa de **Gerenciar cargos**. O cargo do próprio Petto precisa estar acima do cargo que ele dá, e cargos gerenciados (de uma integração) e `@everyone` não podem ser usados.

![O log Cargos do membro atualizados em #registro-membros: a Mia recebeu o cargo Membros, dado pelo Petto](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/join-roles-given.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=ffa451998d61e85a109207f201ce0ffe)

No Discord: a Mia entra e recebe Membros na hora; o log de cargos diz que foi o Petto.

## Comandos

```javascript Syntax theme={null}
!joinrole add <role> [target] [after_rules]
!joinrole remove <role>
!joinrole list
!joinrole clear
!joinrole apply <role> [preview] [reason]
!joinroleconfig
```

```javascript Example theme={null}
!joinrole add @Membro
!joinrole add @Bots bots
!joinrole add @Novato humans
!joinrole list
```

> [accordion] !joinrole add (recusado)
>
> ![O Petto recusa @Admin porque está acima do cargo mais alto dele, e @Server Booster porque é gerenciado por uma integração](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/join-roles-add-refused.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=1ae72698b3083a7566cb81e5ccae2347)
>
> No Discord: um cargo acima do Petto e um cargo de uma integração não podem ser cargos ao entrar.

> [accordion] !joinrole remove
>
> ![O Petto confirma que @Bots não é mais dado ao entrar e depois diz que @Ajudantes não é um cargo ao entrar](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/join-roles-remove.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=e0ffbedc1db1492363efb6cde3aff03d)
>
> No Discord: um cargo ao entrar removido, e um cargo que não era.

> [accordion] !joinrole list (vazia)
>
> ![O Petto responde que não há cargos ao entrar e para usar !joinrole add](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/join-roles-list-empty.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=fc9143976cb0b5101990d1c84feb19ef)
>
> No Discord: a lista quando ainda não há cargos ao entrar.

> [accordion] !joinrole clear
>
> ![O Petto confirma que removeu os 2 cargos ao entrar](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/pt-br/join-roles-clear.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=768acabacafe47ec6b4a50223bc1b733)
>
> No Discord: todos os cargos ao entrar removidos de uma vez.

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

`target` diz quem recebe o cargo: `all` (o padrão), `humans` ou `bots`.

* `add` adiciona um cargo (ou muda o alvo dele).
* `remove` para de dar um cargo.
* `list` mostra todos os cargos ao entrar com o alvo de cada um.
* `clear` remove todos.
* `apply` dá um cargo de entrada agora aos membros que já estão no servidor, com o alvo com que foi configurado. Adicione `preview` para só contar quem receberia. Roda como uma [tarefa de cargos em massa](https://wiki.petto.sbs/pt-br/automation/role-commands.md) (uma por vez, com cartão de progresso, pausa e cancelamento).

`after_rules` dá o cargo quando o membro aceita as regras do servidor (Triagem de membros) em vez de ao entrar. Até lá, um membro que ainda precisa aceitá-las só recebe os cargos de entrada que não esperam. `apply` também pula esses membros.

`list` também avisa sobre um cargo de entrada que foi apagado do servidor, é gerenciado por uma integração ou está acima do cargo mais alto do Petto, porque o Petto não consegue dá-lo. O Petto também avisa a equipe no registro de cargos quando um cargo de entrada é apagado.

Os mesmos comandos ficam em `/role join` (`/role join add`, `/role join apply`...), e `!joinrole`, `!jr` e `!greet joinrole` continuam funcionando.
`!joinrole` também funciona como `!jr`. `!joinroleconfig` mostra o que está configurado agora para os cargos ao entrar e cada comando para mudar.

> [!TIP]
>
> Combine com os [cargos persistentes](https://wiki.petto.sbs/pt-br/automation/sticky-roles.md) para que os membros que voltam também recebam os cargos antigos.

![kira adiciona o cargo Bots só para bots, e a lista mostra Membros para humanos e Bots para bots](https://mintcdn.com/wikipetto/ym43wKcqHRA_RnWi/images/discord/onboarding/pt-br/join-roles.webp?fit=max\&auto=format\&n=ym43wKcqHRA_RnWi\&q=85\&s=e81df1ea1e0407260371f16fc3ca5beb)

No Discord: um cargo de entrada para bots e depois a lista de cargos de entrada.

![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.


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