> ## 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. # Vanity e Server Tags > Dê um cargo aos membros enquanto o status personalizado, o nome ou a tag de servidor deles atender a uma regra, agradeça em um canal e registre cada mudança de cargo. Os cargos de Vanity e de Server Tag fazem parte do Petto. Uma regra dá (ou tira) um cargo quando o perfil do Discord de um membro corresponde: o texto do **Status personalizado**, o nome de usuário, o nome global, o apelido no servidor ou o nome exibido, ou o **Server Tag** que ele usa. > [!NOTE] > > Os dois funcionam com o prefixo e como comandos slash (`/vanity` e `/guildtag`), que são mais fáceis quando uma regra tem várias opções. Você também pode gerenciar tudo pelo dashboard, em **Cargos Vanity**. Nomes curtos com o prefixo: `!vy` para `!vanity`, `!tag`, `!gt` ou `!servertag` para `!guildtag`, e `!idlog` para `!identity`. ## O que dá para fazer * Verificar o **texto do Status personalizado** ou o nome do perfil de um membro e gerenciar um cargo. * Verificar o **Server Tag** que um membro usa (o servidor dele, o texto, ou se ele mostra um) e gerenciar um cargo. * Manter um cargo seguro quando várias regras o usam, e nunca tirar um cargo que alguém deu manualmente. * Agradecer o membro em um canal quando uma regra passa a corresponder, com um **embed salvo de Embeds** (clássico ou V2), se quiser. * Registrar cada cargo que as regras adicionam ou removem, com um cartão do Petto ou um embed salvo para cada tipo de entrada. * Verificar todo mundo de uma vez com uma barra de progresso ao vivo. ## Primeira configuração 1. Dê ao Petto **Gerenciar cargos** e coloque o cargo dele acima de todos os cargos que uma regra deve adicionar ou remover (**Configurações do servidor → Cargos**). Caso contrário, o Discord recusa a mudança de cargo. 2. As regras de Status personalizado precisam da **Presence Intent** do Petto, que já está ativada. 3. Crie uma regra, depois confira com `!vanity test` e aplique com `!vanity sync`. ![liam cria a regra cinnamochi, testa chu, cujo status combina, e sincroniza: 1.840 membros verificados e 12 cargos adicionados](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-step-3.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=5b0bc338da78dad4f069d844cd1a0a56) No Discord: passo 3: crie uma regra, teste em um membro e depois aplique a todos. > [!TIP] > > Você só pode criar regras para cargos **abaixo do seu cargo mais alto** (o dono pode usar qualquer cargo que o Petto consiga dar). Isso impede que um moderador dê a si mesmo cargos mais altos por meio de uma regra. ![kira tenta uma regra que dá Admin e o Petto responde em vermelho que ela só pode usar cargos abaixo do cargo mais alto dela](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-role-above.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=083274ebffbb7269536bcb8082161527) No Discord: um moderador não pode criar uma regra para um cargo acima do seu cargo mais alto. ## Regras de Vanity ### Fontes | Fonte | O que ela lê | | - | - | | `custom_status` | O texto atual do Status personalizado do membro (padrão) | | `username` | O nome de usuário do Discord | | `global_name` | O nome de exibição global do membro | | `guild_nickname` | O apelido neste servidor | | `display_name` | O nome mostrado para o membro: apelido, depois nome global, depois nome de usuário | ### Crie uma regra ```text theme={null} !vanity add cinnamochi cinnamochi @Rep !vanity add cinnamochi cinnamochi @Rep --source custom_status --comparison contains --action add_role ``` ![liam cria a regra cinnamochi para o cargo Rep e o Petto confirma, com uma dica para usar !vanity sync](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-add.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=d37bc4b26d652d4f181f1c66ce723ac1) No Discord: !vanity add com os valores padrão. ![liam cria a regra com --source, --comparison e --action e o Petto confirma](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-add-flags.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=3342bb9c0886798d9cc1bf5e3267ef72) No Discord: a mesma regra com cada opção escrita como flag. * `name`: um nome curto para a regra (letras, números, `-` e `_`); * `word`: o texto a procurar (até 200 caracteres); * `role`: o cargo que a regra gerencia; * `source`: onde procurar (padrão `custom_status`); * `comparison`: `equals`, `contains` (padrão), `starts_with`, `ends_with` ou `regex`; * `action`: `add_role` (padrão) ou `remove_role`. Com o comando slash (`/vanity add` ou `/guildtag add`), o Discord pede cada opção uma por uma e mostra as escolhas, então você não precisa decorar as palavras. Os outros comandos abaixo funcionam do mesmo jeito: `/vanity list`, `/vanity test`, `/vanity sync` e assim por diante. Letras maiúsculas e espaços extras não importam. Um regex é limitado a 256 caracteres, e um padrão que não compila é recusado quando você salva a regra. ![kira salva uma regra regex com um parêntese aberto e o Petto responde em vermelho que o padrão não é válido](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-regex-refused.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=e39a1c9f2172e79d2ee50fb4d1a8d3ac) No Discord: um regex que não compila é recusado ao salvar a regra. ### Outros comandos | Comando | O que faz | | - | - | | `!vanity list` | Mostra as regras, incluindo as desativadas | | `!vanity edit [word] [source] [comparison] [role] [enabled]` | Altera uma regra. A regra é verificada de novo como um todo | | `!vanity remove ` | Apaga uma regra. O histórico dela continua no registro de auditoria | | `!vanity test [user]` | Mostra com o que um membro corresponde, sem mudar nada | | `!vanity sync [user]` | Aplica as regras a todos (com uma barra de progresso) ou a um membro | | `!vanity offline [remove\|keep]` | O que fazer com o cargo quando um membro fica offline (veja abaixo). Sem valor, mostra o que está definido | > [accordion] !vanity list > > ![O Petto lista duas regras que dão Rep, invite-link marcada como desligada, e o canal de agradecimentos](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-list.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=585aa9d35e3e79291635ea29b48aa62f) > > No Discord: as regras, a que está desligada e para onde vão os agradecimentos. > [accordion] !vanity edit > > ![liam usa !vanity edit invite-link --enabled true e o Petto confirma que a regra foi atualizada](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-edit.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=bcd80b278bb158ed653fc912ec4de868) > > No Discord: !vanity edit liga uma regra de novo. > [accordion] !vanity remove > > ![liam remove invite-link e o Petto confirma](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-remove.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=444a891b3e65d366856a23249997c410) > > No Discord: !vanity remove apaga uma regra. > [accordion] !vanity test > > ![O Petto mostra o status personalizado de chu, a regra cinnamochi que combina e invite-link que não](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-test.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=3f3be7e648afde0c56473b291242fcb4) > > No Discord: !vanity test: o que cada regra diz sobre um membro, sem mudar nada. > [accordion] !vanity sync > > ![O cartão de progresso do Petto em 60%, 1.104 de 1.840 membros, 48 por segundo, cerca de 16 segundos](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-sync-progress.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=f036bbb8819c4b7491fce0c20ba4bcb0) > > No Discord: !vanity sync enquanto roda: a barra de progresso, a contagem e o tempo restante. > > ![O Petto diz que as regras de Vanity foram sincronizadas: 1.840 membros verificados em 38 segundos, 12 cargos adicionados e 3 removidos](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-sync.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=f48feb6747761fdf0061067af8577774) > > No Discord: quando a sincronização termina: membros verificados e cargos adicionados e removidos. > [accordion] !vanity sync \ > > ![liam sincroniza chu e o Petto diz que verificou chu, com 1 mudança de cargo](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-sync-member.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=707de12b0a3825f70a26c8e6e89aff94) > > No Discord: !vanity sync para um membro. > [accordion] !vanity offline > > ![O Petto explica que o cargo é tirado quando um membro fica offline e depois confirma que agora os membros o mantêm](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-offline.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=cf2205e4553a3beeca42d19123349688) > > No Discord: !vanity offline mostra a configuração; com keep ela muda. ### Quando um membro fica offline O Discord esconde o Status personalizado de um membro que está **offline ou invisível**. Cada servidor escolhe o que o Petto faz com o cargo nesse caso, com `!vanity offline` (ou `/vanity offline`) ou no dashboard, em **Cargos Vanity**: * `remove` (o padrão): quando o Discord avisa que o membro ficou offline, o Petto **tira o cargo**. Ele devolve quando o membro estiver online com um Status personalizado que corresponda, e agradece de novo. * `keep`: o membro **mantém** o cargo até ficar online de novo, e ele só sai quando o Petto vê que o status deixou de corresponder. > [!NOTE] > > O Petto só tira cargos que ele mesmo deu, nunca um cargo que alguém deu manualmente. O `!vanity sync` segue a mesma configuração: com o padrão, ele pede ao Discord os membros com suas presenças e tira o cargo de quem está offline. Se o Discord estiver limitando as requisições e o Petto tiver que usar o que lembra, os membros offline ficam como estão e o resultado avisa que está incompleto. Um membro de quem o Petto não tem a presença nunca é alterado, então uma reinicialização ou uma varredura não consegue tirar os cargos de quem está online. As regras que leem o nome ou o apelido não são afetadas: esses estão sempre visíveis. Se o mesmo cargo também é gerenciado por outra regra que ainda corresponde (uma regra de nome, ou uma regra de Server Tag), o cargo fica. > [!WARNING] > > Com `remove`, os cargos vêm e vão conforme as pessoas ficam online e offline. Se você tem um registro de mudanças de cargos, ele vai mostrar essas mudanças: desative no registro os eventos de Vanity de que você não precisa, ou escolha `keep`. ![A página Regras de vanity com a opção de offline, o formulário Criar uma regra e duas regras que dão o cargo Rep](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/guides/pt-br/vanity.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=751ae60c70974fbb8b2376eaa769eca7) Dashboard → Cargos Vanity → Regras de vanity: o que acontece quando um membro fica offline, o formulário para criar uma regra e as regras do servidor. ## Regras de Server Tag ```text theme={null} !guildtag add partner is_guild_id @Partner 707307527846625280 !guildtag add shows-tag identity_enabled @Tagged ``` ![liam cria as regras partner, para um ID de servidor, e shows-tag, e o Petto confirma cada uma](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-guildtag-add.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=a26d4732c6c31154dd150ecb2baa4bbb) No Discord: as duas regras de exemplo de Server Tags. | Condição | Precisa de valor | Corresponde quando | | - | - | - | | `is_guild_id` | Sim | A tag é daquele servidor (ID) | | `is_not_guild_id` | Sim | A tag é de outro servidor | | `identity_enabled` | Não | O membro mostra um Server Tag | | `identity_disabled` | Não | O membro escolheu não mostrá-lo | | `tag_equals` | Sim | O texto da tag é esse valor | | `tag_not_equals` | Sim | O texto da tag é outro | O `!guildtag` tem os mesmos `list`, `edit`, `remove`, `test`, `sync`, `notify` e `notify-off` que o `!vanity`. ![O Petto lista as regras de Server Tag shows-tag e partner com seus cargos](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-guildtag-list.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=098d7d4abdee547e3b3a80a250877cbb) No Discord: !guildtag list. ![O Petto mostra que shi usa o tag PETO, que shows-tag combina e partner não](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-guildtag-test.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=69eeef30b9c42f062730e7a38fb7b238) No Discord: !guildtag test: o tag que o Petto lê e quais regras combinam. O Discord nem sempre envia um evento quando alguém muda o Server Tag. Se uma mudança passou despercebida, `!guildtag sync` (ou `!identity sync`) coloca tudo em dia. ![O Petto diz que as regras de Server Tag foram sincronizadas: 1.840 membros verificados, 4 cargos adicionados e 1 removido](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-guildtag-sync.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=4b2c65d478420ea657ad30ed78b08bbc) No Discord: !guildtag sync coloca tudo em dia. ![A página Regras de Server Tag com o formulário Criar uma regra e as regras partner e shows-tag](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/vanity-tag-bot-dashboard-tags.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=4370e67cd9c433e8ff343be0360305f7) Dashboard → Cargos Vanity → Regras de Server Tag: o formulário para criar uma regra e as regras do servidor. ## Como os cargos ficam seguros * Um cargo fica enquanto **pelo menos uma regra de adicionar corresponde e nenhuma regra de remover corresponde** (uma regra de remover sempre vence). * O Petto só tira um cargo se **lembra de tê-lo adicionado ele mesmo**. Um cargo que alguém deu manualmente nunca é removido, mesmo que uma regra depois passe a corresponder e deixe de corresponder. * Se o bot não consegue ler um valor agora (o Status personalizado de alguém que está **offline ou invisível**, porque o Discord o esconde, ou de alguém de quem ele não tem a presença), a regra deixa o cargo como está em vez de tratá-lo como vazio. O cargo só é tirado quando a pessoa está online e o status não corresponde mais. * Bots nunca são alterados. * Várias regras podem gerenciar **o mesmo cargo**: é um cargo só. Ele fica enquanto pelo menos uma regra de adicionar corresponde, sai quando nenhuma corresponde (e nenhuma regra de remover corresponde), e o membro recebe um agradecimento por fonte (Vanity e Server Tag), não um por regra. Um cargo que uma regra de Vanity e uma regra de Server Tag gerenciam continua sendo um cargo só. ## Mensagens de agradecimento ```text theme={null} !vanity notify #thanks !vanity notify #thanks my-embed none !guildtag notify #tags !vanity notify-off ``` > [accordion] !vanity notify #thanks > > ![liam define o agradecimento de Vanity em obrigado e o Petto confirma](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-notify.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=defd70cbc4f4a4cce418cef3741245a3) > > No Discord: o agradecimento padrão em um canal. > [accordion] !vanity notify #thanks my-embed none > > ![liam define o agradecimento com o embed my-embed e o Petto confirma](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-notify-embed.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=30a20199b106c59641d927c1e7e0cfd4) > > No Discord: com um embed salvo e sem menção. > [accordion] !guildtag notify #tags > > ![liam define o agradecimento de Server Tag em tags e o Petto confirma](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-notify-guildtag.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=f0b078c2a8ff45a3553017b1463bfad1) > > No Discord: o agradecimento de Server Tag. > [accordion] !vanity notify-off > > ![liam desliga o agradecimento e o Petto confirma](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-notify-off.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=b8558384ce98fbe68bcda924d61e84e3) > > No Discord: !vanity notify-off. `embed` é o nome de um embed salvo de **Embeds** (deixe vazio para a mensagem simples). Com o comando slash (`/vanity notify`, `/guildtag notify`), o Discord lista seus embeds salvos embaixo da opção enquanto você digita, então você só precisa escolher um, e `ping` é `user` (padrão) ou `none`. A mensagem é enviada quando um membro **passa a** corresponder a uma regra, não a cada atualização. Sem um embed salvo, é um cartão com a foto do membro, o cargo que ele agora tem e a palavra da regra. ![O Petto agradece a chu, que agora tem o cargo Rep, com a foto de chu, a palavra cinnamochi e o nome da regra](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=77c96f65f40ead5f44df385791c40956) No Discord: o agradecimento padrão quando um membro começa a atender a uma regra de Vanity. ![O embed do Petto Cargo de vanity adicionado agradece a chu, que agora tem Rep](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-thanks-embed.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=a51d66b47bf808447a6c775bcf61561c) No Discord: o agradecimento feito com o embed salvo my-embed. ![O agradecimento de Vanity em obrigado com a mensagem padrão, e o de Server Tag em tags com my-embed e sem menção](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/vanity-tag-bot-dashboard-messages.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=2b1c076eb787ea76969de7b1ecd61662) Dashboard → Cargos Vanity → Mensagens de agradecimento: o canal, a mensagem e a menção de cada agradecimento. ## Registro de mudanças de cargos ```text theme={null} !identity logs #staff-log !identity log-event vanity_add false !identity log-embed tag_add my-embed !identity logs-off ``` > [accordion] !identity logs > > ![liam define o log em registro-staff e o Petto confirma, com como escolher as entradas](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-logs.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=c39c66a76261d9a15c8ddffaf7719f48) > > No Discord: !identity logs define o canal do log. > [accordion] !identity log-event > > ![liam desliga vanity\_add e o Petto diz que essas entradas estão desligadas](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-log-event.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=0fb83b4637a3e983108b5e403aab2566) > > No Discord: um tipo de entrada desligado. > [accordion] !identity log-embed > > ![liam define my-embed para tag\_add e o Petto confirma](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-log-embed.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=bc865797452648e889e265225a1c0955) > > No Discord: um embed salvo para um tipo de entrada. > [accordion] !identity logs-off > > ![liam desliga o log e o Petto confirma](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-logs-off.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=d31651fff9787047c13e9b2d990d8e64) > > No Discord: o log desligado. Os tipos de entrada são `vanity_add`, `vanity_remove`, `tag_add`, `tag_remove` e `error`. Sem um embed salvo, cada um é o mesmo embed verde ou vermelho que o bot Vanity usava, com o emoji do Petto, o cargo e o membro, e a palavra (Vanity) ou o motivo (Server Tag). Escolha um embed salvo para uma entrada só se quiser um visual diferente. `!identity status` mostra toda a configuração, e `!identity sync` aplica todas as regras de uma vez. ![O cartão do Petto com 2 regras de Vanity e 1 de Server Tag, os canais de agradecimento e o canal do log com suas entradas](https://mintcdn.com/wikipetto/7DGCqVRNIrjSZYjq/images/discord/guides/pt-br/vanity-tag-bot-status.webp?fit=max\&auto=format\&n=7DGCqVRNIrjSZYjq\&q=85\&s=9ecc3bb14feb550a8bbcf2d9f1e97910) No Discord: !identity status: regras, agradecimentos e log. ![O Petto diz que as regras foram sincronizadas: 1.840 membros verificados, 15 cargos adicionados e 4 removidos](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-tag-bot-identity-sync.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=cd9f131ee5a4f494a06470fb7464a0e0) No Discord: !identity sync aplica todas as regras. ![Um registro verde de Vanity para chu, um verde de Server Tag para shi com a condição, e um vermelho pelo cargo Rep tirado de kira](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/vanity-log.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=8436f7cc6ad0c33258edbea6eb0e8628) No Discord: três registros do log, sem um embed salvo. ![O cartão do log de ações da equipe com registro-staff, os cinco tipos de entrada ligados e my-embed para Cargo de Server Tag adicionado](https://mintcdn.com/wikipetto/tnepcXIgsoo8sThu/images/dashboard/guides/pt-br/vanity-tag-bot-dashboard-logs.webp?fit=max\&auto=format\&n=tnepcXIgsoo8sThu\&q=85\&s=e346e7737634712d67022d60fa09f236) Dashboard → Cargos Vanity → Logs de vanity: o canal, os tipos de entrada e o embed salvo de cada um. ## Variáveis para as mensagens Use estas nos embeds salvos das mensagens de agradecimento e do registro (a lista completa com exemplos está em [Variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md#vanity-e-tag-do-servidor), e em **Variáveis** no dashboard): ```text theme={null} {vanity.rule} {vanity.word} {vanity.source} {vanity.value} {vanity.role} {tag} {tag.rule} {tag.condition} {tag.rule_value} {tag.guild_id} {tag.enabled} {tag.badge} {tag.role} {rule.name} {rule.source} {rule.value} {rule.condition} {rule.reason} {rule.role} {rule.role_id} {rule.action} {rule.action_text} {rule.result} {rule.error} {rule.matched_value} {rule.event} {rule.event_title} ``` Para uma regra `custom_status`, `{vanity.value}` é o Status personalizado atual do membro. Em uma mensagem de Server Tag, `{tag}` é o texto da tag. Todas as variáveis de sempre (`{user.mention}`, `{guild.name}`...) também funcionam. ## Cargos que voltam Os **cargos persistentes** (`!stickyroles enable`) devolvem os cargos de um membro quando ele sai e volta. Os cargos das regras de Vanity e de Server Tag são a exceção: as regras os dão de novo se o membro ainda corresponder. ## Vindo do bot Vanity O antigo bot Vanity não é mais necessário. Os dados dele (regras, quem recebeu qual cargo, mensagens de agradecimento, configurações de registro e embeds salvos) são importados para o Petto uma vez pela equipe, então nada se perde e nenhum cargo é tirado. As mensagens que usavam os nomes antigos de variáveis (`{role}`, `{action.text}`, `{event.title}`...) são atualizadas para os novos (`{rule.role}`, `{rule.action_text}`, `{rule.event_title}`...). ## Solução de problemas ### O cargo não é adicionado 1. O Petto tem **Gerenciar cargos** e o cargo dele está acima do cargo de destino. 2. A fonte certa foi escolhida (`custom_status` não é o nome de usuário). 3. O texto corresponde à comparação. Teste com `!vanity test @member`. 4. Rode `!vanity sync` depois de mudar uma regra. ### O cargo não é tirado 1. O servidor pode estar em `keep` (`!vanity offline`): nesse caso, um membro **offline ou invisível** mantém o cargo, porque o Discord esconde o Status personalizado dele. Use `!vanity offline remove` (o padrão) se quiser que o cargo saia quando ele ficar offline. 2. O Petto só tira cargos que **ele mesmo deu**. Um cargo que alguém deu manualmente fica. 3. Se outra regra que gerencia o mesmo cargo ainda corresponde, o cargo fica. Confira com `!vanity test @member`. ### A mensagem de agradecimento não chega Confira o `!identity status`, se o canal é um canal de texto em que o Petto pode escrever, e se o embed salvo existe. A mensagem é enviada quando uma regra passa a corresponder; a mesma correspondência sem mudanças não a repete. ### O Server Tag aparece vazio ou atrasado O Discord pode omitir ou atrasar os dados do Server Tag. Use `!guildtag test @member` para ver o que o Petto lê e `!guildtag sync` para colocar em dia. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.