Integração Comunidade Discord
Como ativar a comunidade automática dos seus alunos
Antes de começar, confira
A integração conecta um produto da Perfect Pay ao seu servidor no Discord e passa a cuidar do acesso dos alunos automaticamente. Antes de ativar, garanta três coisas:
- Você tem um servidor no Discord em que é dono ou tem a permissão "Gerenciar Servidor".
- Os cargos que os alunos vão receber já existem no servidor (ex.: "Aluno", "VIP"). Se ainda não existem, crie-os no Discord em Configurações do Servidor > Cargos.
- A funcionalidade está habilitada na sua conta Perfect Pay — se o menu Discord não aparecer no seu painel, fale com o nosso suporte.
Passo 1 — Acesse a tela da integração
No painel, vá em Ferramentas > Integrações > Discord. Aqui ficam as suas integrações: o botão Adicionar cria uma nova e a chave Ativo liga e desliga cada uma a qualquer momento.
A lista mostra, para cada integração, o produto, o servidor e quantos planos já têm cargo mapeado.
Passo 2 — Instale o bot no seu servidor
Clique em Adicionar e depois em "Instalar bot da Perfect Pay". O Discord abre pedindo para você escolher o servidor e autorizar. Ao concluir, você volta para esta tela com o servidor registrado e o campo ID do servidor Discord preenchido automaticamente.
Só servidores instalados pela sua conta podem ser usados na integração.
Passo 3 — Configure e mapeie os cargos
Preencha a descrição, escolha o produto e, se quiser, ative "Expulsar do servidor ao revogar acesso" — por padrão, só o cargo é removido. Depois clique em "Carregar planos e cargos": os planos do produto aparecem à esquerda e os cargos do seu servidor à direita. Escolha qual cargo cada plano dá ao aluno e clique em Salvar.
Neste exemplo, quem compra o "Plano Assinatura Nacional" recebe o cargo VIP; os demais planos dão o cargo Aluno.
Passo 4 — Suba o cargo do bot e ative
| Este é o passo que mais gera dúvida — não pule. No Discord, abra Configurações do Servidor > Cargos e arraste o cargo do bot da Perfect Pay para cima dos cargos que os alunos vão receber. O Discord só permite que o bot entregue cargos que estejam abaixo do cargo dele — com o cargo do bot embaixo, a liberação falha. |
Por fim, confira se a chave Ativo da integração está ligada na lista (Passo 1). Pronto.
Como funciona no dia a dia
Com tudo ativo, a integração cuida do ciclo completo do acesso, do primeiro dia ao último:
|
COMPRA Aluno compra No email de confirmação da compra chega o botão "Entrar na comunidade do Discord". |
ACESSO Entra com o cargo certo Ao clicar, ele autoriza com a conta Discord dele e já entra no seu servidor com o cargo do plano que comprou. Se já estava no servidor, apenas recebe o cargo. |
SAÍDA Perdeu o direito, perdeu o cargo Reembolso, cancelamento ou assinatura expirada removem o cargo automaticamente — e, se você quiser, expulsam o aluno do servidor. |
Cada plano do produto pode dar um cargo diferente — quem compra o plano básico recebe um cargo, quem compra o VIP recebe outro. Você define esse mapeamento uma única vez, na tela da integração.
O que acontece a partir daqui
Com a integração ativa, toda compra aprovada do produto envia ao aluno o email com o botão de entrada na comunidade. A entrada, o cargo e a remoção do acesso passam a ser automáticos — você não precisa fazer nada.
Se o aluno trocar de conta no Discord, basta clicar de novo no botão do email e autorizar com a conta nova: o acesso muda de conta com segurança, e a conta antiga perde o cargo se não tiver outra compra válida.
Comando /vincular: libere um aluno sem sair do Discord
Às vezes o aluno não encontra o email da compra, ou você quer resolver na hora, durante um atendimento. Para isso existe o /vincular: ele procura a compra aprovada pelo email e entrega o cargo ao membro que você indicar — sem abrir o painel.
Quem pode usar
Apenas administradores do servidor (permissão "Gerenciar Servidor"). Os demais membros nem veem o comando, e as respostas aparecem só para quem digitou.
Como usar
1. Em qualquer canal, digite /vincular e selecione o comando da Perfect Pay. 2. Em email, informe o email usado na compra. 3. Em membro, selecione quem vai receber o acesso. 4. Envie — a resposta chega na hora:
|
/vincular email: [email protected] membro: @Maria Silva Perfect Pay APP Só você pode ver esta mensagem Membro vinculado com sucesso! O acesso está sendo liberado. |
Respostas do comando e o que fazer
| Resposta | O que significa | O que fazer |
|---|---|---|
| "Membro vinculado com sucesso! O acesso está sendo liberado." | Deu certo — o cargo está sendo entregue. | Nada. Em instantes o membro recebe o cargo. |
| "Nenhuma compra aprovada encontrada para este email nos produtos deste servidor." | O email não tem compra aprovada nos produtos ligados a este servidor. | Confira se o email está exatamente igual ao da compra e se o pagamento foi aprovado. |
| "Esta compra já está vinculada a outra conta Discord..." | A compra já pertence a outra conta — o comando não transfere acesso. | Peça ao aluno para clicar no botão do email de compra e autorizar com a conta nova. |
| "A assinatura desta compra não está ativa." | A assinatura foi cancelada ou expirou. | Verifique a assinatura do aluno no painel. |
| "O plano desta compra não tem cargo mapeado na integração..." | O plano comprado não foi ligado a nenhum cargo. | Abra a integração e mapeie o plano a um cargo (Passo 3). |
| "Não foi possível atribuir o cargo. Verifique se o bot da Perfect Pay..." | O Discord recusou: o cargo do bot está abaixo do cargo do plano. | Arraste o cargo do bot para cima (Passo 4) e repita o comando. |
| "A integração Discord não está ativa para este servidor." | Integração desligada, ou o bot não foi instalado neste servidor. | Ative a integração no painel e confirme a instalação do bot. |
| Segurança: uma compra já ligada a uma conta Discord não pode ser passada para outra pelo comando — isso impede que alguém "tome" o acesso de um aluno. A troca de conta é feita apenas pelo botão do email de compra, que prova que a pessoa é a dona do email. |
Dúvidas frequentes
O aluno já estava no meu servidor. Ele recebe o cargo?
Sim — nesse caso ele só recebe o cargo, sem precisar entrar de novo.
Posso usar a mesma integração para dois produtos?
Não — cada produto tem a sua integração. Mas várias integrações podem apontar para o mesmo servidor, cada uma com o seu mapeamento de cargos.
O aluno comprou duas vezes com o mesmo email. Como fica?
Cada compra tem o seu próprio botão no email e o seu próprio vínculo. Enquanto houver uma compra válida, o aluno mantém o cargo.
Desativei a integração. O que acontece?
Novas liberações e remoções param imediatamente; os cargos já entregues permanecem como estão.
Removi o bot do servidor. E agora?
Sem o bot, nenhuma liberação ou remoção funciona. Reinstale pelo botão "Instalar bot da Perfect Pay" na tela da integração.
Mudei os cargos do meu servidor. Preciso refazer algo?
Se você excluiu ou trocou um cargo usado no mapeamento, abra a integração, clique em "Carregar planos e cargos" e ajuste o mapeamento.