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

# Convites

> Registre qual membro trouxe quem para o servidor, ordene quem convida em um ranking, deixe de fora as entradas falsas e dê cargos por convites.

## Visão geral

Registra quem convidou quem, com um ranking de quem está trazendo mais membros.

Use para premiar quem faz o servidor crescer, fazer concursos de convites por semana ou mês, ou descobrir como alguém entrou. O Petto conta sozinho assim que consegue ver os links de convite; não há nada para ativar.

![liam usa invites top e o Petto mostra os seis que mais convidam com os convites, entradas, saídas e bônus](https://mintcdn.com/wikipetto/LoL7QuPJ71yd9F_N/images/discord/community/pt-br/invites.webp?fit=max\&auto=format\&n=LoL7QuPJ71yd9F_N\&q=85\&s=d3ad97cf3d0a1784d0eeb378d36d2f45)

No Discord: o ranking de convites do servidor.

## Comandos

```javascript Sintaxe theme={null}
!invites user [user]
!invites top [all|week|month]
!invites who [user]
!invites list [user]
!invites codes [user]
!invites bonus <user> <amount>
!invites reset <user>
!invites config [fake_days] [quick_leave_minutes] [ignore_bots] [subtract_leaves]
!invites reward add <invites> <role>
!invites reward remove <role>
!invites reward list
```

```javascript Exemplo theme={null}
!invites user @Alguém
!invites who @MembroNovo
!invites bonus @Alguém 5
```

Se `user` for omitido, o padrão é você mesmo, e `!invites` sozinho é `!invites user`. Nome curto: `!invs`. O Petto precisa de **Gerenciar servidor** para ver os links de convite.

* **Convites** = entraram - saíram + bônus. O ranking (`top`) é ordenado por esse número. Com **subtrair saídas** desativado (veja as configurações abaixo) quem saiu continua no total: entraram + bônus.

* **Entradas falsas** não contam: uma conta com menos de 3 dias, ou alguém que saiu e voltou. Quando um membro falso sai, isso também não conta.

* `who` diz quem convidou um membro e como: um convite, o link personalizado do servidor ou um link que o Petto não conseguiu identificar. Um convite de uso único também é reconhecido.

* `list` mostra os últimos 15 membros que alguém trouxe. `codes` mostra os links que alguém criou e quanto cada um foi usado.

* `bonus` adiciona (ou, com um número negativo, retira) convites bônus e precisa de **Gerenciar servidor**. `reset` zera os contadores de alguém e precisa de **Administrador**.

* `top week` e `top month` classificam quem trouxe mais membros no período (as semanas começam na segunda-feira, em [GMT-5](https://wiki.petto.sbs/pt-br/setup/time.md)).

* `config` sozinho mostra as quatro configurações do servidor. Para mudar uma, dê um valor: `!invites config --fake_days 7` (o nome curto é `!icon`, então `!icon --fake_days 7`), ou em ordem, `!icon 7 10 on off`. Slash: `/invites config fake_days:7`. Mudar precisa de **Gerenciar servidor**; ver não.

#### Configurações

| Configuração | Padrão | O que faz |
| - | - | - |
| `fake_days` | 3 | Uma conta com menos desses dias (0 a 365) é uma entrada falsa. Com 0 a idade não é verificada; quem volta é sempre falso. |
| `quick_leave_minutes` | 0 (desativado) | Quem sai em menos desses minutos (0 a 1440) depois de entrar conta como entrada falsa e não como real, então o convite não é creditado. |
| `ignore_bots` | desativado | Contas de bots são registradas (como vindas de um bot) e nunca creditadas a quem convida. Bots não usam links de convite, então isso só os deixa fora do registro. |
| `subtract_leaves` | ativado | Quem saiu é subtraído do total. Desative para que continue nele (entraram + bônus). |

Nada muda até você mudar uma configuração: os padrões são como o rastreador sempre funcionou. O mesmo total é usado por `!invites`, os rankings, os cargos de recompensa e `{inviter.invites}`.

> [!NOTE]
>
> O **filtro de links de convite do AutoMod** é outra coisa: apaga mensagens que divulgam outros servidores (veja [Convites permitidos](https://wiki.petto.sbs/pt-br/moderation/automod.md#convites-permitidos)). O rastreador daqui só conta quem trouxe quem.

> [accordion] !invites user
>
> ![mia.draws usa !invites user: 29 convites, 33 entraram, 4 saíram, 2 falsos e 0 bônus](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-user.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=53679244579c8052f83654f6dd0ed602)
>
> No Discord: os convites de um membro: entraram, saíram, falsos e bônus.

> [accordion] !invites top week
>
> ![liam usa !invites top week e o Petto lista cinco membros desta semana, Chillet em primeiro com 8](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-top-week.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=1511bc25add21cc055870d9ddebc5593)
>
> No Discord: quem trouxe mais membros nesta semana.

> [accordion] !invites who
>
> ![kira usa !invites who em sam: convidado por mia.draws por meio de um convite, código artclub, entrou ontem, contabilizado](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-who.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=989287d0b2c79b973039b3e3b28e2455)
>
> No Discord: quem convidou um membro, como e quando.

> [accordion] !invites list
>
> ![kira usa !invites list em mia.draws e o Petto lista cinco membros, um que saiu e uma entrada falsa](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-list.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=8aa67ee37186e4b2f5bdf163ec9bf5c1)
>
> No Discord: os últimos membros que alguém trouxe, com os que saíram e os falsos.

> [accordion] !invites codes
>
> ![mia.draws usa !invites codes: artclub em #arte com 21 usos, pettoland em #general com 9 usos e gamenight com 3 usos de 10, que termina depois de amanhã](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-codes.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=3b6d03a3e7030716517c1a2bbda3a59f)
>
> No Discord: os links de convite de um membro e quanto cada um foi usado.

> [accordion] !invites bonus
>
> ![liam usa !invites bonus em kira com 5, e o Petto responde que kira agora tem 45](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-bonus.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=a32d172007cf06a8577c33ffdfc852ee)
>
> No Discord: convites bônus adicionados pela staff.

> [accordion] !invites reset
>
> ![liam usa !invites reset em nico e o Petto responde que os convites de nico voltaram a zero](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-reset.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=34c0458811f043166a0a0dbadba12881)
>
> No Discord: os convites de um membro voltam a zero (Administrador).

> [accordion] !invites config
>
> ![liam usa !invites config: entradas falsas são contas com menos de 3 dias e membros que voltam, 2 recompensas](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-config.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=b4c16b917f5515a7fc4919307865ba53)
>
> No Discord: as configurações de convites do servidor.

> [accordion] !invites config fake\_days
>
> ![liam usa !invites config fake\_days 7 e o Petto confirma que a partir de agora contas com menos de 7 dias contam como entradas falsas](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-config-fake-days.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=2c5ad78d056b04269b1c1f3b682cd0df)
>
> No Discord: contas com menos de 7 dias passam a ser entradas falsas.

`!inviteinfo <code>` (curto `!ii`) mostra para onde um link de convite leva, de qualquer servidor: o servidor, a descrição, os membros e os online, o canal, quem criou o link e quando ele expira.

![Chillet usa !inviteinfo discord.gg/cozycafe: Cozy Café com a descrição, o código, o canal, quem criou, nunca expira, 2416 membros e 538 online, e um botão Abrir convite](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-inviteinfo.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=1550f92d728c4748a021547bb73e098e)

No Discord: para onde leva o link de convite de outro servidor.

### Recompensas

`!invites reward add 10 @Recrutador` dá esse cargo a quem chegar a 10 convites, e o retira se a pessoa ficar abaixo disso. Adicione quantas quiser com `reward add`, remova uma com `reward remove` e veja todas com `reward list`. Quando você adiciona uma recompensa, o Petto a dá a quem já tem o suficiente. O cargo precisa estar abaixo do cargo mais alto do Petto e do seu.

> [accordion] !invites reward add
>
> ![liam usa !invites reward add 10 Recrutador e o Petto responde que Recrutador é dado ao chegar a 10 convites](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-reward-add.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=8079325940789399dbd2d5938de3b574)
>
> No Discord: um cargo dado aos 10 convites; o Petto verifica quem já os tem.

> [accordion] !invites reward remove
>
> ![liam usa !invites reward remove Lenda e o Petto responde que Lenda não é mais dado por convites](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-reward-remove.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=18dfdb8331bf7dbfa3ce63a038154fb8)
>
> No Discord: um cargo que não é mais dado por convites.

> [accordion] !invites reward list
>
> ![mia.draws usa !invites reward list: 10 convites para Recrutador e 50 para Lenda](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-reward-list.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=2d5790df13225ee4212447537165ea86)
>
> No Discord: os cargos dados por convites.

### Dashboard

A aba **Convites** de **Estatísticas** no [dashboard](https://petto.sbs/dash) tem uma parte de **Configurações de convites** com as mesmas verificações dos comandos:

* **Cargos por convites**: adicione um cargo e quantos convites o ganham (escolher um cargo que já está lá muda o número dele), ou remova um. Membros que já têm o suficiente recebem na hora; quem tem o cargo continua com ele quando ele é removido.
* **Configurações**: as quatro configurações acima em um cartão, com um único botão **Salvar configurações**: a idade da conta em dias (0 a 365) abaixo da qual uma entrada não conta (com 0, uma conta nova conta como qualquer outra), os minutos de saída rápida (0 a 1440, 0 é desativado), **Ignorar contas de bots** e **Subtrair quem saiu**. Os campos usam a largura toda no celular.
* **Quem mais convida**: o ranking com um filtro de **Todo o tempo**, **Esta semana** ou **Este mês**. Clique em um nome para ver esse membro.
* **Procurar um membro**: digite um nome (ou cole o ID) para ver entraram, saíram, falsas, bônus e total, quem o convidou e como, e os códigos com que trouxe gente. A aba lê isso do banco de dados, então olhar não custa nada ao bot.
* **Ajustar os convites de um membro**: **Adicionar extra** (um número negativo tira convites) ou **Zerar**. Os cargos de recompensa seguem o novo número. Zerar precisa de **Administrador**, como o comando.

![A aba Convites de Estatísticas com as entradas por convite por dia, quem mais convida, dois cargos por convites e o ajuste de entradas falsas](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/community/pt-br/invites.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=165ad4b7d73117076f7e75f6201297f5)

Dashboard → Estatísticas → Convites: as entradas por convite, quem mais convida e as Configurações de convites.

![O card Ajustar os convites de um membro com um campo de membro, o número de bônus, Adicionar extra e Zerar](https://mintcdn.com/wikipetto/-zl3RNr1X6pRGWW3/images/dashboard/community/pt-br/invites-dash-adjust.webp?fit=max\&auto=format\&n=-zl3RNr1X6pRGWW3\&q=85\&s=34c1570d48b2d09e56f31a972cf83a16)

Dashboard → Estatísticas → Convites: Ajustar os convites de um membro: um bônus (negativo tira) ou zerar.

### Variáveis para a mensagem de boas-vindas

Na mensagem de boas-vindas (e na DM ao entrar) você pode usar `{inviter}` (menciona quem convidou, ou *Desconhecido*), `{inviter.name}`, `{inviter.id}`, `{inviter.invites}` (quantos convites essa pessoa tem) e `{invite.code}`. Por exemplo, `Boas-vindas, {user}! Convidado por {inviter.name}, que agora tem {inviter.invites} convites.` Veja as [variáveis de convites](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md#convites).

![Em #boas-vindas o Petto diz: Boas-vindas, @sam! Convidado por mia.draws, que agora tem 29 convites.](https://mintcdn.com/wikipetto/WlMseWjf_M7PtL1S/images/discord/community/pt-br/invites-welcome-variables.webp?fit=max\&auto=format\&n=WlMseWjf_M7PtL1S\&q=85\&s=7b5f9e88240a093f780c15ced983fdb7)

No Discord: uma mensagem de boas-vindas que diz quem convidou o membro novo e quantos convites essa pessoa tem.

As entradas e saídas também são contadas por dia para o [`!summary`](https://wiki.petto.sbs/pt-br/resources/utility-commands) e para a página Estatísticas do dashboard.


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