Discord
Conecte o bot da MinePag ao servidor do Discord da sua comunidade para dar e remover cargos conforme as compras.
Com o Discord conectado, um produto pode dar cargos no seu servidor do Discord. O bot da MinePag dá o cargo quando o pagamento é confirmado e remove quando o acesso é revogado ou expira. Se o cliente ainda não está no servidor, o bot o adiciona já com o cargo.
Antes de começar
- Você precisa ser administrador do servidor do Discord (ou ter a permissão Gerenciar servidor).
- Na loja, você precisa ser Proprietário ou Administrador. Veja Membros e permissões.
Conectar o servidor
Autorize o bot
No painel da loja, abra Entregas › Discord e clique em Conectar servidor. O Discord abre a tela de autorização: escolha o servidor e mantenha marcada a permissão Gerenciar cargos.
Volte para o painel
Depois de autorizar, você volta para Entregas › Discord com a mensagem "Servidor conectado". O servidor aparece com a situação Conectado e a lista de cargos que o bot pode entregar.
Posicione o cargo do bot
No Discord, abra Configurações do servidor › Cargos e arraste o cargo do bot da MinePag para acima dos cargos que você vai vender. O Discord só deixa um bot dar cargos que estão abaixo do cargo dele.
A lista de cargos do painel se atualiza sozinha em alguns segundos. Se quiser conferir na hora, use /minepag sincronizar no Discord ou clique em Atualizar cargos no painel.
Use o cargo em um produto
Em Catálogo › Produtos, abra o produto, adicione o benefício Cargo no Discord e marque os cargos em Cargos concedidos. Se quiser um acesso com prazo, preencha Duração do acesso em dias: ao fim do prazo, o cargo é removido.
Quais cargos aparecem na lista
Só aparecem os cargos abaixo do cargo do bot. O @everyone e os cargos gerenciados por outras integrações (como cargos de outros bots ou de impulso do servidor) nunca aparecem, porque o Discord não permite atribuí-los.
O que o cliente faz
Para receber o cargo, o cliente vincula a conta do Discord uma vez, na área do cliente:
- Na vitrine, ele abre Minha conta › Conexões e clica em Entrar com o Discord.
- O Discord pede autorização para a MinePag ver a identidade dele e adicioná-lo ao servidor.
- Ao voltar, ele vê "Conta do Discord vinculada. Os cargos comprados serão entregues em instantes."
Se o cliente comprar antes de vincular, a entrega fica Na fila com o motivo "O cliente ainda não vinculou a conta do Discord na área do cliente". Essa espera não gasta tentativas, e a entrega roda assim que ele vincula. Detalhes em Vincular contas.
Avise os clientes na descrição do produto ou na página de agradecimento que eles precisam vincular o Discord.
Comandos do bot no servidor
O bot da MinePag fica online no seu servidor e responde a comandos de barra. As respostas aparecem só para quem usou o comando.
| Comando | Quem usa | O que faz |
|---|---|---|
/vincular | Qualquer membro | Mostra o botão para abrir a área do cliente da loja e vincular a conta do Discord. Se a conta já estiver vinculada, avisa. |
/cargos | Qualquer membro | Lista os cargos que a pessoa comprou neste servidor. Se algum estiver faltando, o bot devolve em instantes. |
/minepag status | Quem pode gerenciar o servidor | Mostra a loja conectada, a situação da conexão, quantos cargos o bot consegue entregar e as entregas dos últimos 7 dias. |
/minepag sincronizar | Quem pode gerenciar o servidor | Confere as permissões do bot e atualiza a lista de cargos no painel. |
Os comandos /minepag só aparecem para quem tem a permissão Gerenciar servidor. Para mudar quem vê cada comando, use Configurações do servidor › Integrações › MinePag.
O que o bot faz sozinho
- Membro que sai e volta: o Discord tira todos os cargos de quem sai do servidor. Quando a pessoa volta, o bot devolve os cargos que ela comprou e que continuam ativos.
- Cargos alterados: quando você cria, renomeia, reordena ou apaga cargos, a lista do painel se atualiza sozinha.
- Bot removido: se alguém expulsar o bot ou tirar a permissão Gerenciar cargos, a conexão passa para Reautorização necessária e os proprietários e administradores da loja recebem um aviso. As entregas esperam até você conectar o servidor de novo e voltam a rodar sozinhas.
Essas devoluções aparecem em Entregas como reenvio e não contam no faturamento.
Remoção do cargo
O bot remove o cargo quando o acesso é revogado (reembolso total, contestação ou cancelamento, conforme as opções do benefício), quando a assinatura termina ou quando a duração do acesso acaba. Se o cliente já saiu do servidor, a remoção é dada como concluída.
Gerenciar a conexão
Cada servidor conectado aparece em Entregas › Discord com os cargos e quantos benefícios usam cada um.
- Atualizar cargos: busca de novo os cargos no Discord. Use depois de criar, renomear ou reordenar cargos.
- Desconectar: o servidor sai dos benefícios dos produtos e as entregas pendentes para ele passam a falhar. Quem já recebeu um cargo continua com ele. O bot sai do servidor se nenhuma outra loja o usar. Exige digitar o nome do servidor.
Você pode conectar mais de um servidor do Discord à mesma loja.
Solução de problemas
| Mensagem ou situação | O que fazer |
|---|---|
| "O bot não pode gerenciar este cargo. No Discord, coloque o cargo do bot da MinePag acima do cargo entregue." | Suba o cargo do bot em Configurações do servidor › Cargos, clique em Atualizar cargos e reprocesse a entrega. |
| "O cargo não existe mais no servidor do Discord." | O cargo foi apagado. Escolha outro cargo no benefício e reprocesse a entrega. |
| "O bot não está mais no servidor do Discord." | O bot foi expulso. Conecte o servidor de novo. |
| O cliente diz que ficou sem o cargo | Peça para ele usar /cargos no servidor. Se o cargo comprado estiver ativo, o bot devolve. |
| Os comandos do bot não aparecem | Confira se o bot está no servidor e se o membro tem permissão para usar comandos de aplicativos no canal. |
| "A conexão com o Discord precisa ser reautorizada no painel." | Clique em Conectar servidor e autorize o mesmo servidor de novo. As entregas são retomadas sozinhas. |
| "O cliente não está no servidor e a autorização do Discord expirou." | Peça ao cliente para vincular a conta de novo em Minha conta › Conexões. |
| O Discord recusou a conexão | Confira se você é administrador do servidor e se o bot recebeu a permissão Gerenciar cargos. |
| "Integração com o Discord indisponível" | A integração não está habilitada na plataforma. Fale com o suporte da MinePag. |
Quando o Discord fica fora do ar ou limita as requisições, a MinePag tenta de novo sozinha, até 8 vezes. Para reprocessar uma entrega depois de corrigir a causa, veja Acompanhar entregas.