Como vender cargos no Discord automaticamente

Para vender um cargo no Discord sem ninguém entregar na mão, você precisa de três peças: um checkout que confirma o pagamento, a conta do Discord de quem comprou e um bot com a permissão Gerenciar cargos, que adiciona o cargo quando o pagamento é aprovado. O bot só consegue dar cargos que estão abaixo do cargo dele na hierarquia do servidor, então confira a ordem dos cargos antes da primeira venda.

Essas peças podem vir do próprio Discord (as Assinaturas de Servidor, que hoje só atendem donos nos Estados Unidos), de um bot de vendas ou da loja do seu servidor de jogo. Cada caminho muda quem recebe o dinheiro e o que acontece com o cargo num reembolso.

Por que servidores vendem cargos

Um cargo carrega permissões e aparência, e por isso um cargo pago costuma servir para:

• acesso a canais privados, como um chat VIP, um canal de sugestões direto com a equipe ou uma sala de voz para apoiadores;
• destaque na comunidade, porque o nome do membro aparece com a cor do cargo mais alto que ele tem;
• espelho do que o jogador comprou no jogo: quem tem VIP no servidor de Minecraft recebe o cargo VIP no Discord.

O canal privado se cria em Editar canal > Permissões, ativando Canal privado. Segundo a central de ajuda do Discord, isso tira a permissão "Ver canais" do @everyone, e você libera o canal para o cargo VIP.

No terceiro caso, o benefício dentro do jogo segue as regras do jogo. No Minecraft, a seção sobre servidores das Diretrizes de Uso diz o que um servidor pode cobrar.

Como a entrega automática funciona

Toda ferramenta que entrega cargo sozinha faz o mesmo caminho:

1. O comprador escolhe o produto e informa qual é a conta dele no Discord.
2. O provedor de pagamento confirma a compra.
3. O sistema chama a API do Discord para adicionar o cargo àquele membro.
4. O comprador passa a ver os canais liberados para o cargo.

O passo 3 é a rota PUT /guilds/{guild.id}/members/{user.id}/roles/{role.id}. A documentação do Discord diz que ela adiciona um cargo a um membro do servidor e exige a permissão MANAGE_ROLES, que no aplicativo aparece como Gerenciar cargos. Tirar o cargo usa a mesma rota com DELETE. Como a rota age sobre um membro, o comprador precisa estar no servidor para receber o cargo.

A hierarquia de cargos

A permissão sozinha não resolve. A central de ajuda explica que "Usuários com a permissão Gerenciar cargos podem criar e modificar cargos posicionados abaixo de seus próprios na hierarquia de cargos". A documentação de permissões aplica a mesma regra a bots: um bot só concede a outros usuários cargos em posição menor que o cargo mais alto dele.

Em Configurações do servidor > Cargos, uma ordem que funciona, de cima para baixo:

1. Administração e moderação
2. Cargo do bot que entrega as compras
3. Cargos vendidos (VIP+, VIP)
4. Demais cargos e @everyone

Para mudar a posição, arraste o cargo na lista. Se o pagamento foi aprovado e o cargo não apareceu, confira primeiro se o cargo do bot está acima do cargo vendido.

Como saber qual conta comprou

Pedir para o comprador digitar o nome de usuário dá problema. Um erro de digitação manda o cargo para outra pessoa ou para ninguém, e a documentação do objeto de usuário descreve o username como não único na plataforma. O dado que identifica a conta é o id.

O jeito confiável é o login com Discord, pelo OAuth2. O comprador clica para entrar com o Discord, autoriza o escopo identify, e o sistema consulta a rota /users/@me, que devolve os dados da conta, com o id, sem o e-mail. O cargo vai para a conta que fez login, sem nada digitado. Algumas ferramentas pedem também o escopo guilds.join, que permite adicionar o usuário ao servidor, útil para quem compra antes de entrar no seu Discord.

Os três caminhos para vender

Assinaturas de Servidor do Discord

Os Termos de Monetização dizem que as ofertas "podem incluir assinaturas do seu servidor ou conteúdo, acesso a determinadas vantagens ou cargos, compras avulsas e muito mais". Na prática são dois formatos: Assinaturas de Servidor, mensais, com até três níveis, e a Loja do Servidor, com cargos premium de compra única, que o Discord descreve como em beta para um grupo selecionado de servidores.

As condições, segundo o artigo para donos de servidor e os Termos de Monetização:

• o dono precisa estar nos Estados Unidos e fornecer à Stripe conta bancária e documento de identidade americanos;
• o dono precisa ter 18 anos ou mais e autenticação em dois fatores, e o servidor precisa ter o recurso Comunidade ativado;
• a divisão é de 90% para o servidor e 10% para o Discord, e os Termos de Monetização ainda listam 6% de taxa de processamento nas compras pelo desktop e pelo navegador.

O FAQ de receita para criadores é direto sobre o resto do mundo: as Assinaturas de Servidor não estarão disponíveis fora dos Estados Unidos. Para um servidor com dono no Brasil, este caminho fica fechado.

Bots de venda

Há bots feitos para vender cargos: o membro escolhe o cargo num comando ou painel, paga por um link e o bot aplica o cargo. Antes de adicionar um, confira:

• para onde vai o dinheiro e quanto o bot cobra por venda;
• quais formas de pagamento ele aceita, como Pix, se o seu público é brasileiro;
• quais permissões ele pede ao entrar no servidor;
• o que ele faz com o cargo em caso de reembolso, estorno ou fim do prazo.

Os Termos de Serviço tratam bots e apps de outras empresas como serviços de terceiros, pelos quais o Discord diz não ser responsável. Se o bot sair do ar, quem responde aos compradores é você.

Loja do servidor que entrega o cargo

Se o servidor de jogo já vende VIP numa loja, faz sentido que a mesma compra também entregue o cargo no Discord. O jogador paga uma vez e o pedido aprovado cuida das duas entregas. Se você ainda não tem loja, o guia como criar uma loja para seu servidor de jogos passa pelas decisões na ordem.

A Gamecart é uma das opções: a integração com Discord dá cargos ao aprovar o pagamento e está nos planos Pro e Enterprise, conforme a página de preços. O dinheiro vai direto para a conta do vendedor no provedor de pagamento.

Reembolso, estorno e fim do prazo

Dar o cargo é a parte fácil de automatizar. Antes de vender, decida o que acontece com ele em três situações:

• No reembolso, você devolveu o dinheiro e escolhe entre tirar o cargo na hora ou deixar até o fim do período pago.
• No estorno, o comprador contestou a compra no cartão. Se o cargo fica, ele fica com o benefício e com o dinheiro.
• No fim do prazo, um cargo mensal precisa sair quando o mês acaba, a menos que a compra seja renovada.

Nas ferramentas do Discord, parte disso já vem definida. Quem sai do servidor tem a assinatura cancelada e não renova no mês seguinte, e o artigo para donos diz que o Discord não faz reembolso de produtos da Loja do Servidor.

Num bot ou numa loja, pergunte se a remoção é automática ou se fica com você. Se for manual, anote cada caso para saber quem ainda deveria ter o cargo.

Escreva a regra na descrição do produto: duração, o que o cargo libera e o que acontece num reembolso. Se ainda está decidindo entre cargo mensal e permanente, o post sobre como precificar VIPs do servidor ajuda a montar os planos.

Segurança do bot

• Dê ao bot só as permissões que ele usa. Para entregar cargo, Gerenciar cargos basta. Nunca dê Administrador: a central de ajuda avisa que ele "concede todas as permissões e ignora todas as restrições de canais".
• Deixe o cargo do bot logo acima dos cargos vendidos e abaixo da moderação. Ele só altera cargos abaixo do dele e só concede permissões que ele mesmo tem, então um cargo baixo limita o estrago se o token do bot vazar.
• Não coloque permissões de moderação nos cargos vendidos. Um VIP precisa ver canais e conversar; expulsar membros fica com a moderação.
• Se o servidor exige autenticação em dois fatores para moderação, o dono do bot também precisa usar 2FA, porque MANAGE_ROLES está entre as permissões que a documentação de permissões marca com essa exigência.

O que as regras do Discord dizem

O próprio Discord vende cargos pelas Assinaturas de Servidor. Os Termos de Serviço deixam a criação dos cargos e o que eles podem fazer com donos e administradores do servidor. Eles valem para qualquer servidor, então leia antes de começar a vender e de novo quando o Discord atualizar o texto.

Quando a venda passa pelas ferramentas do Discord, vale a Política de Monetização, que "se aplica a todos os recursos de monetização do usuário do Discord, incluindo as Assinaturas dos Servidores, Assinaturas de Apps, e Loja do Servidor". A lista do que não pode ser monetizado inclui "Propriedade intelectual sem a permissão por escrito dos detentores dos direitos" e facilitação de jogos de azar.