Criar o seu bot no Discord
Passo a passo no Discord Developer Portal: criar a aplicação, ativar as intents, copiar o token, conectar no site e convidar o bot com as permissões certas.
Nesta página
Antes de começar
Na Kyo, cada loja usa um bot seu, com o nome e a foto que você escolher. Você cria esse bot uma vez no Discord Developer Portal (o site oficial do Discord para aplicações) e a Kyo cuida de manter ele online.
- Uma conta do Discord, de preferência com a verificação em duas etapas ligada: o Discord pode pedir o código ao gerar o token, e servidores que exigem verificação em duas etapas para moderação só aceitam punições de bots cujo dono tem ela ligada.
- Ser administrador do servidor da loja, ou ter a permissão Gerenciar Servidor.
- Estar logado em kyoapplications.com.br com a mesma conta.
1. Criar a aplicação
Abra o Developer Portal
Entre em discord.com/developers/applications com a sua conta do Discord.
Clique em New Application
Dê o nome da sua loja (é o nome que o bot vai ter no servidor), aceite os termos e clique em Create.
Coloque a foto (opcional)
Em General InformationApp Icon envie o logo da loja e salve. Dá para trocar depois.
2. Ativar as intents
Intents são autorizações que dizem ao Discord o que o bot pode acompanhar. No menu da esquerda abra Bot e role até Privileged Gateway Intents.
| Intent | Precisa? | Para que serve na Kyo |
|---|---|---|
| Server Members Intent | Obrigatória | Boas-vindas, cargo automático, anti-raid, cargos e entrega por cargo. Sem ela o site recusa a conexão e o bot não liga. |
| Message Content Intent | Recomendada | Anti-link e anti-convite do automod, o texto nos registros de mensagens apagadas e editadas e o texto das conversas na transcrição dos tickets. |
| Presence Intent | Não precisa | A Kyo não usa. Pode deixar desligada. |
Privileged Gateway Intents
Presence Intent Não precisa
Status e atividade dos membros.
Server Members Intent Obrigatória
Entradas, saídas e cargos dos membros.
Message Content Intent Recomendada
Ler o texto das mensagens.
3. Copiar o token
Ainda em Bot, clique em Reset Token
Confirme em Yes, do it!. O Discord pode pedir o código da verificação em duas etapas.
Clique em Copy
O token aparece uma vez só. Se perder, gere outro com Reset Token (o antigo para de funcionar na hora).
4. Conectar no site
Abra Meu bot
Escolha o servidor da loja no seletor do topo. Só aparecem servidores onde você é administrador ou tem Gerenciar Servidor.
Cole o token e clique em Conectar
O site confere o token com o Discord antes de salvar. Ele fica cifrado e não aparece de novo, nem para a equipe da Kyo.
Pronto, o bot liga sozinho
Em até 1 minuto o bot fica online. Se for o primeiro servidor da sua conta, a loja ganha 7 dias de teste grátis.
5. Convidar o bot
Clique em Convidar bot
O botão aparece em Meu bot depois da conexão. O link já vem com o servidor certo e com todas as permissões que a Kyo usa.
Confira e clique em Autorizar
Deixe todas as permissões marcadas. O passo fica verde sozinho assim que o bot entra no servidor.
O painel da loja é publicado
O bot publica o painel da loja no canal de sistema do servidor. Para escolher outro canal, use Escolher canal / publicar de novo em Meu bot, ou digite
/painelno canal desejado.
Permissões do bot
O convite pede estas permissões. Cada uma tem um motivo:
| Permissão | Usada em |
|---|---|
| Ver canais, Enviar mensagens, Ler histórico | Tudo: painéis, respostas, vitrine, logs. |
| Inserir links, Anexar arquivos | Cards da loja, QR Code do Pix, recibo e transcrição dos tickets. |
| Usar comandos de aplicativo | Os comandos de barra como /kyo e /sorteio. |
| Gerenciar cargos | Cargo por compra, cargo automático, cargos por botão, cargos de nível e por valor gasto. |
| Gerenciar canais | Tickets em canal, /canal, /trancar, /destrancar e /lento. |
| Gerenciar mensagens | /limpar e o automod (apagar spam e links). |
| Expulsar, Banir e Castigar membros | /kick, /ban, /castigo, anti-raid e punição automática. |
| Adicionar reações, Usar emojis externos | Reações nos anúncios e emojis do servidor nos botões. |
| Mencionar @everyone | Só quando você escolhe marcar todo mundo num anúncio. |
Os tópicos privados (do pedido e dos tickets) usam as permissões Criar tópicos privados e Enviar mensagens em tópicos, que o Discord já dá a todos por padrão. Se você tirou isso do cargo @everyone, libere para o bot no canal de compras e no canal do painel de tickets.
Posição do cargo do bot
O Discord só deixa um bot dar, tirar ou punir cargos que estão abaixo do cargo dele. Logo depois do convite, o cargo do bot nasce no fim da lista.
Abra Configurações do servidorCargos
Arraste o cargo do bot para cima
Ele precisa ficar acima de todos os cargos que a loja vai entregar (VIP, cargos de nível, cargos por botão, cargo automático).
Salve
Trocar ou desconectar o bot
- Trocar o bot: em Meu bot, cole o token do outro bot e clique em Trocar bot. Produtos e configurações continuam. Depois convide o bot novo.
- Desconectar: em Meu bot, use Desconectar bot e confirme. O bot sai do ar em até 1 minuto. A loja deste servidor fica parada até você conectar um bot de novo, e a assinatura continua valendo só para este servidor.
- Usar o mesmo bot em outro servidor: desconecte aqui, espere 1 minuto e conecte no outro servidor. O outro servidor precisa da própria assinatura.