Integrações

Discord

Início de sessão, o bot de anúncios, missões que leem o seu servidor e cargos entregues como recompensa.

Cinco funcionalidades diferentes levam o nome Discord, e ativar uma não ativa as outras.

O que querO que é de factoOnde é configurado
Os fãs iniciam sessão com a conta do DiscordUm fornecedor de início de sessãoPor comunidade, por nós
Os fãs associam o Discord a uma conta que já têmAssociação de contaPor comunidade, por nós
O seu servidor recebe uma mensagem quando publica algoO bot da FanBaseSettings, depois Automation
Uma missão que verifica se um fã entrou no servidor ou tem um cargoDois modelos de missãoMissões do Discord
Um cargo do Discord concedido por concluir algoUm tipo de recompensaRecompensas

Início de sessão e associação de conta

São duas coisas diferentes, configuradas de forma independente.

O início de sessão é o Discord como porta de entrada da sua aplicação. O fã toca em Continuar com o Discord e já está dentro, sem palavra-passe separada. Fica ao lado de Google, X, Twitch e Shopify, e pode escolher quais aparecem.

A associação de conta é um fã que já iniciou sessão a associar a conta do Discord depois, a partir do perfil. Vem ativada por predefinição, porque um fã que iniciou sessão com o Google continua a precisar de uma conta do Discord associada antes que qualquer missão do Discord possa ser verificada.

A associação é a que importa para as missões. Um fã que iniciou sessão com o Discord fica associado automaticamente, mas um fã que iniciou sessão de outra forma não fica, e as missões do Discord dele ficam bloqueadas até que associe a conta. O cartão trata disso sozinho. Veja Modelos que exigem uma conta associada.

Diga ao seu contacto na FanBase que métodos de início de sessão quer e se a associação do Discord deve ficar disponível: é uma alteração de configuração, não um desenvolvimento. Início de sessão traz a lista completa.

Os nomes de utilizador na aplicação têm o formato name#1234. É um nome de utilizador da FanBase com um formato parecido com o do Discord, e não tem relação com a conta do Discord do fã.

Anúncios no seu servidor

O bot publica num canal do seu servidor quando algo acontece na aplicação. O anúncio sai, quer alguém da sua equipa se lembre de escrever um, quer não.

GatilhoO que o servidor vê
Uma missão é publicadaUma mensagem com a missão e um link para chegar até ela
Um evento começaUma mensagem quando o evento abre
Um evento terminaUma mensagem quando encerra

Cada tipo de notificação tem o seu próprio interruptor, por isso pode anunciar as missões e ficar em silêncio sobre tudo o resto. Vêm aí mais tipos: publicações do feed de notícias, alterações na loja e vencedores de eventos são os que estão a ser desenvolvidos. Em desenvolvimento

Como configurar

Coloque o bot no seu servidor

Vá a Settings, depois Automation. Prima Connect no cartão do Discord. O Discord pede que escolha o servidor e aprove o bot, e depois encaminha de volta para o painel de administração.

Quem clicar precisa da permissão Manage Server (Gerir servidor) nesse servidor do Discord, por isso garanta que essa pessoa está presente antes de começar. Se o cartão já oferece Disconnect, o bot está instalado e pode saltar esta etapa.

Escolha o canal

Indique o ID do canal em que quer receber as mensagens. Vale a pena criar um canal dedicado: num chat geral movimentado, os anúncios desaparecem em minutos.

Escolha um cargo para mencionar, ou nenhum

Opcional. Escolha um cargo e todas as mensagens o mencionam. Deixe em branco e a mensagem não notifica ninguém.

Mencionar toda a gente a cada missão é a forma de um servidor aprender a silenciar o seu canal de anúncios. Se quer uma menção, crie um cargo opcional para os fãs que a pediram.

Ative as notificações que quer

Ative uma de cada vez e deixe as outras desativadas. Pode voltar e adicionar mais quando souber qual é o volume.

Publique algo e observe o canal

O único teste a sério.

Como obter os IDs

Os dois IDs ficam atrás do modo de programador do Discord, que Como encontrar os IDs ensina a ativar.

ID necessárioComo obter
ID do canalClique com o botão direito no canal na lista de canais e depois em Copy Channel ID (Copiar ID do canal)
ID do cargoClique com o botão direito no cargo em Server Settings (Definições do servidor), depois Roles, e em Copy Role ID (Copiar ID do cargo)

Confirme que o cargo do bot pode ver o canal e enviar mensagens nele. Um canal em que o bot não consegue publicar tem exatamente o mesmo aspeto de um bot que não funciona, e é a primeira hipótese a descartar.

O Discord como fonte de missões

Dois modelos leem o seu servidor em vez de escreverem nele.

Join the server (entrar no servidor) pede que o fã seja membro de um servidor indicado por si, e verifica isso. Hold a role (ter um cargo) pede um cargo específico e também verifica, e é assim que se recompensa quem já conquistou algo no Discord.

Os dois exigem que a conta do Discord do fã esteja associada, e os dois exigem o ID do servidor. Todos os campos estão em Missões do Discord.

Um cargo do Discord também pode ser um requisito de acesso em vez de uma missão: pode ocultar uma missão, ou bloqueá-la, até que o fã tenha um cargo. Isso está em Criar uma missão.

Um cargo do Discord como recompensa

O sentido inverso. Um fã conclui uma missão e o bot atribui-lhe um cargo no seu servidor, sem ninguém a meio do processo.

É isto que sustenta o padrão que a maioria dos parceiros quer: o nível dez na aplicação dá direito a uma cor no Discord. É preciso que o bot esteja ligado, e o cargo do próprio bot tem de ficar acima do cargo que ele atribui na lista de cargos do seu servidor. O Discord não deixa um bot conceder um cargo posicionado acima do dele. Verifique primeiro essa ordem se um cargo não estiver a ser atribuído.

Os tipos de recompensa que pode associar a uma missão estão em Recompensas.

Nesta página