Primeiros passos

Configure seu primeiro bot personalizado, conecte um servidor Discord e comece a verificar membros em menos de 10 minutos. Este guia o orienta em todas as etapas, desde o zero até um link de verificação funcional.

Pré-requisitos

Antes de começar, verifique se você tem o seguinte: uma conta do Discord, propriedade ou permissão de administrador no servidor do Discord que deseja proteger e uma conta do RestoreHub (inscreva-se em restorehub.net com Discord, Google, GitHub, Apple ou e-mail/senha).

O Restore Hub funciona em um modelo de bot personalizado. Em vez de adicionar um bot compartilhado que milhares de servidores usam, você cria seu próprio aplicativo Discord e fornece as credenciais ao Restore Hub. Isso significa que seus membros veem seu nome de bot e avatar, não o nosso.

Dica: você pode começar totalmente no plano Free. As contas gratuitas incluem 1 bot personalizado, 2 servidores, 3 backups e verificação de núcleo. Os recursos premium, como detecção de VPN, detecção de alt e o firewall, exigem um upgrade.

Etapa 1 - Criar um aplicativo Discord

Todo bot do Restore Hub começa como um aplicativo Discord padrão. Você o criará no Portal do desenvolvedor do Discord e, em seguida, entregará as credenciais ao Restore Hub.

1. Abra o Portal do desenvolvedor - Navegue até https://discord.com/developers/applications em seu navegador. Faça login com sua conta do Discord, se solicitado.
2. Criar um novo aplicativo - Clique no botão "New Application" (Novo aplicativo) no canto superior direito. Dê um nome a ele (esse será o nome de exibição do bot em seu servidor) e aceite os Termos de serviço do desenvolvedor do Discord.
3. Copie o ID do aplicativo (cliente) - Na página "General Information" (Informações gerais), localize o campo Application ID (ID do aplicativo). Clique em "Copy" (Copiar) e salve-o em algum lugar - você o colará no Restore Hub em breve.
4. Copiar a chave pública - Ainda em "Informações gerais", copie a chave pública. O Restore Hub usa isso para verificar se as cargas úteis de interação recebidas são genuinamente do Discord.
5. Gerar o segredo do cliente - Navegue até a seção "OAuth2" na barra lateral esquerda. Em "Client information" (Informações do cliente), clique em "Reset Secret" (Redefinir segredo) e confirme. Copie o segredo imediatamente - o Discord só o mostra uma vez.
6. Crie o usuário do bot e copie o token - Navegue até "Bot" na barra lateral esquerda. Clique em "Reset Token" e confirme. Copie o token do bot e armazene-o com segurança. Esse token dá controle total sobre o bot, portanto, nunca o compartilhe publicamente.
7. Ativar intenções privilegiadas - Role para baixo na página Bot até "Privileged Gateway Intents". Ative o Server Members Intent (necessário para extração e backups de membros) e o Message Content Intent (necessário para backups de mensagens). Clique em "Save Changes" (Salvar alterações).

Aviso: Seu token de bot e o segredo do cliente são credenciais confidenciais. Nunca as cole em mensagens do Discord, repositórios públicos ou capturas de tela. O Restore Hub as criptografa com AES-256 em repouso e nunca as exibe após a configuração inicial.

Etapa 2 - Definir o URI de redirecionamento do OAuth2

O Discord exige que você coloque na lista de permissões o URL exato para o qual os usuários são redirecionados após a autorização com o OAuth2. O Restore Hub precisa dessa configuração para que a verificação funcione.

1. Navegue até OAuth2 Redirects - No Portal do desenvolvedor, vá para OAuth2 → General. Role a tela para baixo até "Redirects".
2. Adicione a URL de retorno de chamada do Restore Hub - Clique em "Add Redirect" e digite: https://restorehub.net/api/callback. Se você planeja usar um domínio personalizado (por exemplo, verify.yourdomain.com), adicione também https://verify.yourdomain.com/api/callback. Clique em Save Changes (Salvar alterações).

https://restorehub.net/api/callback

Dica: você pode adicionar vários URIs de redirecionamento. Adicione o retorno de chamada restorehub.net e qualquer retorno de chamada de domínio personalizado que planeja usar.

Etapa 3 - Adicione seu bot ao Restore Hub

Agora que você tem seu aplicativo Discord configurado, traga as credenciais para o Restore Hub usando o assistente de configuração de bot em cinco etapas.

1. Abra a página Bots personalizados - Faça login no restorehub.net. Na barra lateral do painel, clique em "Custom Bots" (Bots personalizados) e, em seguida, clique em "Add Bot" (Adicionar bot).
2. Cole suas credenciais (Etapa 1 de 5 do Assistente) - Insira o token do bot, o ID do cliente, o segredo do cliente, a chave pública e o URI de redirecionamento. O Restore Hub valida cada campo em tempo real.
3. Configurar o endpoint do Interactions (Etapa 2 de 5 do assistente) - O RestoreHub gera um URL de ponto de extremidade de interações exclusivo para seu bot (por exemplo, https://restorehub.net/api/interactions/{botId}). O assistente fornece essa URL e instrui você a colá-la no Portal do desenvolvedor do Discord em Informações gerais → URL do ponto de extremidade de interações. O Discord envia um ping de verificação - o RestoreHub responde automaticamente. Quando o Discord mostrar uma marca de verificação verde, prossiga.
4. Defina seu URL de verificação (Etapa 3 de 5 do Assistente) - Escolha entre um URL baseado em slug (restorehub.net/s/your-community) ou um domínio personalizado (verify.yourdomain.com). As lesmas são instantâneas; os domínios personalizados exigem um registro CNAME (abordado no documento sobre domínios personalizados).
5. Convidar para um servidor (Etapa 4 de 5 do Assistente) - O assistente gera um link de convite OAuth2 com as permissões corretas (Gerenciar funções, Chutar membros, Exibir canais, Ler histórico de mensagens). Clique em "Invite to Server" (Convidar para o servidor), selecione seu servidor Discord no menu suspenso e autorize.
6. Configurar as definições do servidor (Etapa 5 de 5 do assistente) - Selecione a função Verificado que os membros recebem após passarem pela verificação. Opcionalmente, defina um canal de registro para eventos de verificação, ative o captcha, defina a idade mínima da conta e alterne os recursos de segurança.

Etapa 4 - Compartilhe o link de verificação

Seu bot agora está ativo. Compartilhe o URL de verificação com seus membros. Você pode publicá-lo em um canal, colocá-lo na descrição do servidor ou usar o comando de barra /verify-embed para criar um botão incorporado em qualquer canal.

Quando um membro clica no link, ele é levado à sua página de verificação personalizada. Eles clicam em "Verificar", autorizam com o Discord OAuth2 (concedendo escopos de identificação, e-mail, guildas e guildas.join) e recebem automaticamente a função verificada em seu servidor.

Dica: use o comando /verify-embed (Premium+) para publicar uma incorporação de verificação limpa com um botão diretamente em um canal do Discord. Os membros clicam no botão e são redirecionados para a página de verificação.

O que acontece nos bastidores

Os bots do Restore Hub usam o Endpoint de Interações baseado em HTTP do Discord, e não o Gateway WebSocket tradicional. Essa é uma distinção arquitetônica importante que afeta o comportamento do bot.

Com a abordagem de gateway, um bot mantém uma conexão WebSocket persistente com o Discord e recebe todos os eventos em tempo real (mensagens, reações, adesões de membros, etc.). Isso requer uma infraestrutura sempre ativa e mostra um ponto de status verde/amarelo/vermelho ao lado do bot na lista de membros.

Com a abordagem do Endpoint de Interações (que o Restore Hub usa), o Discord envia solicitações HTTP POST para o URL do endpoint do seu bot somente quando um usuário aciona um comando de barra ou uma interação de botão. Não há conexão persistente. O bot aparece na lista de membros sem um ponto de status - limpo e profissional.

Todas as outras operações (atribuição de funções, extração de membros, criação de backups, chute de membros) são realizadas por meio da API REST do Discord usando o token do bot. Isso significa que o Restore Hub pode ser dimensionado para milhares de bots sem manter milhares de conexões WebSocket.

Visão geral dos limites do plano

| Recurso | Gratuito | Premium | Negócios | Empresa |
|---|---|---|---|---|
| Servidores | 2 | 10 | 50 | Ilimitado |
| Bots personalizados | 1 | 5 | 25 | Ilimitado |
| Backups | 3 | 10 | 30 | 50 |
| Mensagens/Backup | 50 | 200 | 500 | 2.000 |
| Pull Cooldown | 6 horas | 1 hora | 15 min | Nenhum |
| Detecção de VPN | Não | Sim | Sim | Sim | Sim
| Detecção de Alt | Não | Sim | Sim | Sim | Sim
| Firewall | Não | Sim | Sim | Sim | Sim
| Anti-Nuke | Não | Não | Sim | Sim | Sim |
| Anti-Raid | Não | Não | Sim | Sim |
| Domínio personalizado | Não | Não | Sim | Sim |
| Backups agendados | Não | Sim | Sim | Sim |
comandos de barra | Não | Sim | Sim | Sim | Sim |
| Gerenciamento de equipes | Não | Não | Sim | Sim |
| Limite de taxa de API | 20/10s | 50/10s | 100/10s | 200/10s |

Próximas etapas

• Leia o documento Custom Bots para entender como funcionam as interações HTTP e quais permissões seu bot precisa.
• Leia o documento Verificação para saber mais sobre cada verificação de segurança no fluxo de verificação.
• Leia o documento Segurança para ativar a detecção de VPN, detecção de alt, regras de firewall, anti-nuke e anti-raid.
• Leia o documento Backups para configurar instantâneos do servidor e backups programados.
• Leia o documento Member Pulling para saber como mover membros verificados entre servidores.
• Leia o documento sobre Domínios Personalizados se você quiser verificar.seudomínio.com em vez de um URL de slug.
• Leia o documento da API REST se quiser integrar o Restore Hub às suas próprias ferramentas ou painéis.