Super Admin — Discord (alertas do roadmap)

Disponível em Super Admin → Módulos → Discord (apenas utilizadores com papel de super administrador).

O que faz

Envia mensagens para dois canais do Discord:

1. Novas demandas públicas do roadmap (sugestão ou report).
2. Novas respostas do cliente na thread pública.

Falhas no Discord não impedem o registo da demanda nem a resposta do cliente no painel.

Ligar a integração

1. Ative Enviar alertas para o Discord.
2. Preencha os dois canais: Channel ID — novas demandas e Channel ID — mensagens do cliente.
3. Opcionalmente Guild ID (servidor, para referência) e o Bot token.
4. Clique em Salvar.

O token não volta a ser mostrado depois de guardado; para mudar, cole um token novo.

Menção @everyone

Cada alerta pode começar por @everyone para notificar quem tem o canal configurado. O bot precisa da permissão Mencionar todos (@everyone) no cargo do bot ou nas permissões do canal; sem isso a mensagem chega, mas sem notificação para todos.

Link direto da demanda

• Nas novas demandas, o alerta inclui o link do painel com ?suggestion= e o ID (abre em Sugestões públicas).
• Nas respostas do cliente também aparecem a thread pública e o painel.

Aspeto no Discord

Os alertas usam um embed (bloco tipo cartão com barra lateral colorida). Tipo e estado aparecem em formato de “badge” aproximado (emoji + texto em estilo código), porque o Discord não tem etiquetas como noutras apps. Na nova resposta do cliente, a cor lateral do cartão pode seguir o estado (pendente / aprovado / recusado).

Testar

Após guardar token e canais, use Enviar teste e confirme a mensagem no Discord.

Como criar o bot e obter credenciais (resumo)

1. No Discord Developer Portal (discord.com/developers/applications), crie uma aplicação e, em Bot, adicione um bot e copie o token (mantenha-o secreto).
2. Em OAuth2 → URL Generator, escolha escopo bot e permissão Send Messages (e View Channel se o Discord pedir). Gere o URL, abra no navegador e adicione o bot ao servidor da organização.
3. No Discord (desktop ou web), ative Modo desenvolvedor em Definições → Avançado.
4. Guild ID: clique com o botão direito no ícone do servidor → Copiar ID do servidor.
5. Channel IDs: clique com o botão direito em cada canal → Copiar ID do canal (um para demandas, outro para mensagens).
6. Cole Guild ID, os dois Channel IDs e o token na página Discord do Super Admin, guarde e envie um teste.

Resolução de problemas

• 401 / token inválido: confirme que copiou o token completo do Developer Portal (sem espaços) e que guardou de novo após alterações.
• 403 / Missing permissions: o bot precisa de permissão para ver o canal e enviar mensagens nesse canal.
• 404 / Unknown channel: o Channel ID não corresponde ao servidor onde o bot foi convidado, ou o canal foi apagado — volte a copiar o ID com o modo desenvolvedor.
• Teste OK mas sem alertas nas demandas: confirme que Enviar alertas para o Discord está ligada e que token e canais continuam válidos.