Conteúdo
Guia de rastreamento de convites do Levlix
O módulo Convites do Levlix registra quais membros convidaram quem. Esses dados alimentam os sistemas de rastreamento de atividade, de marcos e de ranking.
Criar um convite rastreado
/invites create max_uses: <0-unlimited> duration: <hours> temporary: <true/false>
Crie um link de convite personalizado, com controle total sobre o seu comportamento:
| Parâmetro | Descrição | Padrão |
|---|---|---|
max_uses |
Número máximo de vezes que o link pode ser usado (0 = ilimitado) | 0 |
duration |
Quantas horas o link fica ativo (0 = nunca expira) | 24 |
temporary |
Se for true, os membros que entram por este link perdem os cargos ao se desconectar | false |
O Levlix responde em privado, então só você vê o link. Ele registra automaticamente quem criou cada convite e quantas vezes ele foi usado.
Links de convite pessoais
Por padrão, /invites create cria um convite para o canal em que o comando é executado. Se você prefere que cada membro compartilhe um único link fixo para um canal de sua escolha, por exemplo um canal de verificação oculto, mude o servidor para links de convite pessoais:
- Execute
/setupe abra Engajamento, Convites, ou abra o servidor no painel e vá em Convites. - Em Links de convite pessoais, escolha o Canal de convites (no painel: Canal de destino). A configuração é salva na hora.
Enquanto houver um canal de destino definido:
/invites createsempre cria um convite permanente e ilimitado para esse canal. As opçõesmax_uses,durationetemporarysão ignoradas.- Cada membro recebe exatamente um link. Executar o comando de novo devolve o mesmo link.
- Os membros não precisam de nenhuma permissão de convite e não precisam ver o canal de destino. Decida quem pode executar o comando com as permissões de comandos do Discord (Configurações do servidor, Integrações, Levlix,
/invites), por exemplo só o seu cargo de verificados. - Você pode tirar Criar convite de todos os cargos, para que os links do Levlix sejam a única forma de entrar no servidor.
- O Levlix precisa de Ver canais e Criar convite no canal de destino.
Limpe o canal em /setup ou no painel para voltar aos convites por canal. Os links pessoais existentes continuam funcionando até você excluí-los no Discord.
Configurações de admin
Os admins encontram as ferramentas de convite em /setup, em Engajamento, Convites. Além do Canal de convites para os links pessoais, a tela tem um botão Estatísticas que abre as Estatísticas de convites:
- Convites rastreados, quantas pessoas diferentes convidaram, entradas por convites e o maior número de usos de um único convite.
- Quem mais convidou, os membros que trouxeram mais pessoas.
- Um aviso quando há convites sem criador conhecido.
Na mesma tela, Atualizar dados de convites analisa todos os convites existentes e preenche os criadores que estiverem faltando. Use depois de migrar o bot ou de se recuperar de problemas. Isso pode ser executado uma vez a cada 5 minutos. O Levlix precisa de Gerenciar servidor para ler os convites do servidor.
Como o rastreamento funciona
O Levlix acompanha os eventos de convite do Discord em tempo real:
- Quando um membro entra, o Levlix verifica qual código de convite foi usado e credita quem criou o convite.
- Os dados de convites são armazenados no banco de dados e entram no perfil de atividade do usuário.
- As contagens de convites aparecem em
/activity,/leaderboarde no sistema de marcos.
