Visão geral de Apps
O que são aplicativos e bots no vsync, como eles aparecem nos servidores e quais são os limites de cada conta.
Guia para quem administra o vsync e para quem desenvolve bots. Esta página apresenta os conceitos; as próximas explicam cada parte em detalhe.
O que são bots e aplicativos#
Um aplicativo é o que você cria em Configurações → Desenvolvedores. Cada aplicativo tem exatamente um bot: uma conta automatizada que entra em servidores, lê mensagens, responde a comandos de barra (/) e envia mensagens e embeds pela API.
- A conta de bot tem o mesmo id do aplicativo (o
client_iddos links de convite). Ela não faz login com senha, não recebe pedidos de amizade, não tem mensagens diretas e não aparece nos rankings. - Nos servidores o bot aparece na lista de membros e nas mensagens com o selo APP ao lado do nome. Ele fica online enquanto houver pelo menos uma conexão ao gateway e pode mostrar uma atividade (por exemplo "Jogando Xadrez").
- Ao ser adicionado, o bot ganha um cargo gerenciado com o nome do aplicativo e só as permissões escolhidas no convite. Esse cargo some quando o bot sai, é expulso ou banido.
- Cada pessoa pode criar até 10 aplicativos.
- Um bot privado (padrão) só pode ser adicionado pelo dono. Ligue Bot público na aba Bot para que qualquer pessoa com a permissão Gerenciar servidor possa adicioná-lo.
Como as peças se encaixam#
- Autenticação e criação: o token e o passo a passo para criar o primeiro bot.
- Entrada em servidores: o link de convite OAuth2 e as permissões.
- Interações: comandos de barra, componentes e modais.
- Conteúdo: mensagens, embeds, menções e emojis.
- Acesso aos dados: API REST para ações e gateway para eventos em tempo real.
- Voz: bots em canais de voz.