Bot ou webhook — qual é a diferença?

Ambos ligam o teu servidor de jogos ao Discord, mas em direções diferentes.

Um webhook é uma via de sentido único: o teu servidor envia mensagens para um canal (falha, backup concluído, poucos recursos). Ele não consegue receber nada. Para isso existe o guia próprio “Configurar webhook do Discord".

O bot funciona nos dois sentidos. Ele responde a comandos da vossa guilda: /status, /players, /uptime, /link — e quem tiver as permissões certas inicia, para ou reinicia o servidor sem abrir o painel. Podes usar os dois ao mesmo tempo; não entram em conflito.

Ligado em três passos

Tudo o que precisas está no painel do servidor da game-serverhosting em “Discord e notificações" no cartão “Ligar bot do Discord".

1. Convidar o bot

O botão “Convidar bot" no passo 1 abre a janela de convite própria do Discord. Tu precisas da permissão “Gerir servidor" na guilda — na tua própria guilda tens isso automaticamente. Quando o convite tiver sido feito, aparece por baixo a linha “Bot foi convidado para …". Se em vez disso aparecer “Ainda não foi comunicado nenhum convite da tua conta Discord.", liga primeiro a tua conta Discord no perfil — caso contrário, o painel não consegue associar o convite a nenhuma conta.

2. Gerar o código

“Gerar código" cria um código de ligação. Ele é válido por poucos minutos e pode ser resgatado exatamente uma vez. “Copiar código" copia intencionalmente apenas o código.

3. Executar /connect no Discord

Escreve /connect num canal da tua guilda, seleciona o comando na janela de sugestões e cola o código no campo code.

O erro mais comum: colar a linha inteira. Para o Discord, texto colado é uma mensagem normal, não um comando — então simplesmente não acontece nada. O comando tem de ser escrito e selecionado na janela de sugestões.

Quem já se ligou ao site uma vez através de “Iniciar sessão com Discord" também pode deixar o campo code vazio: nesse caso, o bot liga o próprio servidor através da conta de cliente associada. Se houver vários servidores próprios, ele pergunta em vez de adivinhar.

Que comandos existem

Grupo no painel Comandos Predefinição
Estado e comunidade /status, /players, /uptime, /link, /pool, /credit, /invoices ligado
Controlar servidor /start, /stop, /restart, /console, /send, /maintenance, /embed desligado
Gerir comunidade /announce desligado

Além disso, há os comandos de moderação /kick, /ban, /unban e /whitelist; eles pertencem ao grupo “Controlar servidor" e exigem a mesma permissão de servidor.

/credit e /invoices dizem respeito à tua conta inteira, não apenas a este servidor — por isso respondem exclusivamente ao titular da conta, independentemente da liberação do grupo.

Quem pode fazer o quê — duas barreiras, Discord primeiro

Em “Comandos e acesso", decides por grupo em “Liberação": “Todos na guilda", “Funções específicas", “Utilizadores específicos" ou “Apenas coadministradores".

Esta é a segunda barreira. A primeira é o próprio Discord: em “Definições do servidor → Integrações → Permissões de comandos", cada guilda pode bloquear comandos slash individuais para funções ou canais. Um comando bloqueado ali nunca chega ao painel — não aparece em nenhum registo, porque nunca chega. O que o Discord deixa passar é verificado uma segunda vez pela liberação no painel.

E, independentemente de ambos, vale isto: comandos de controlo só funcionam, mesmo liberados, para uma conta de cliente ligada com a permissão de servidor adequada. /send e /maintenance continuam reservados ao proprietário.

Se o bot não responder

Quase todas as tentativas falhadas têm uma de cinco causas. Verifica-as nesta ordem — de cima para baixo, a verificação fica mais trabalhosa:

  1. O comando foi colado em vez de escrito. Para o Discord, texto colado é uma mensagem normal. /connect tem de ser escrito e selecionado na janela de sugestões; só então aparece o campo code.
  2. O código expirou ou já foi usado. Ele é válido por poucos minutos e só pode ser resgatado exatamente uma vez. Basta gerar um novo no painel.
  3. O Discord está a bloquear o comando. Em Definições do servidor → Integrações → Permissões de comandos, cada guilda pode desativar comandos slash individuais para funções ou canais. Um comando bloqueado ali não chega ao painel e, por isso, também não deixa rasto em nenhum registo.
  4. O bot não pode escrever no canal. Se lhe faltar ali a permissão para enviar mensagens, a resposta não aparece, mesmo que o comando tenha chegado. Testa o mesmo comando num canal onde esteja confirmado que o bot pode escrever.
  5. A conta de cliente não está ligada. Comandos de controlo exigem uma conta ligada com a permissão de servidor adequada. Inicia sessão uma vez no site através de “Iniciar sessão com Discord”, para que o painel consiga associar o utilizador Discord a uma conta.

Se depois disso continuar tudo em silêncio, verifica no painel em “Guildas Discord ligadas” se a guilda ainda está ligada — uma entrada removida anteriormente explica totalmente a ausência de resposta.

Feed e anúncios

Em “Feed e anúncios", escolhes dois canais. Para o canal de feed vão entradas, saídas, online, offline e falhas; para o canal de anúncios vão /announce, janelas de manutenção e backups concluídos. Sem seleção, o bot não publica nada por iniciativa própria.

Opcionalmente, o nome do canal mostra o número atual de jogadores. O Discord permite mudar o nome no máximo a cada cinco minutos — por isso, em caso de dúvida, o nome pode ficar um pouco atrasado.

Desfazer a ligação

Em “Guildas Discord ligadas", há um botão “Desligar" por guilda. Depois disso, o bot deixa de responder por este servidor nessa guilda. O próprio bot permanece na guilda até o removeres de lá.

FAQ

Preciso de bot e webhook, ou basta um deles?

Depende da direção. Para simples notificações do teu servidor para um canal, o webhook é suficiente. Assim que os teus colegas tiverem de executar comandos a partir do Discord, precisas do bot. Usar ambos ao mesmo tempo é comum e não causa problemas.

Porque é que não acontece nada depois de /connect?

Porque o comando foi colado em vez de escrito — esse é o erro mais comum. Para o Discord, texto colado é uma mensagem normal. Escreve /connect, escolhe a entrada na janela de sugestões e coloca o código no campo code.

Os meus colegas podem parar o servidor se eu liberar o grupo?

Não. A liberação no painel é apenas uma de duas barreiras. Além disso, comandos de controlo só funcionam para uma conta de cliente ligada com a permissão de servidor adequada; /send e /maintenance continuam reservados ao proprietário. Quem não tiver uma conta ligada não consegue fazer nada com isso.

Todos na guilda veem as minhas faturas?

Não. /credit e /invoices dizem respeito à conta de cliente inteira, não apenas a este servidor. Por isso, respondem exclusivamente ao titular da conta — independentemente de como o grupo “Estado e comunidade” esteja liberado.

Porque é que o nome do canal mostra um número de jogadores desatualizado?

O Discord permite renomear um canal no máximo a cada cinco minutos. Por isso, a indicação pode ficar um pouco atrasada. Para um valor atual, consulta /players — o comando lê o estado diretamente no servidor.

Quellen