GameVox

Discord Relay

Uma ponte ao vivo entre o Discord e o GameVox. As mensagens postadas nos seus canais do Discord aparecem nos seus canais do GameVox em segundos, com o nome e o avatar do autor, e edições, exclusões, reações e anexos ficam todos sincronizados. Junte com a retransmissão de chat GameVox → Discord e a ponte funciona nos dois sentidos.

O que é retransmitido

Tudo o que uma mensagem faz no Discord, espelhado no GameVox

Mensagens

Postadas com o nome de exibição e o avatar do autor no Discord, para a conversa ficar natural dos dois lados. Funciona em canais comuns e de anúncios, inclusive com posts que chegam de canais que o seu servidor segue.

Edições e exclusões

Edite uma mensagem no Discord e a cópia no GameVox é atualizada; apague e o espelho some. Com a retransmissão GameVox → Discord junto, edições e exclusões feitas no GameVox também atualizam a cópia no Discord no lugar, sem repost com "(editado)" poluindo o chat.

Reações

Reaja de qualquer lado de uma mensagem com ponte. As reações do Discord aparecem como pílulas ao vivo no GameVox, com o nome de quem reagiu, e as reações adicionadas no GameVox aparecem na mensagem original do Discord.

Anexos e stickers

Imagens, arquivos e stickers vão junto com a mensagem e aparecem direto no GameVox.

Importação do histórico

Puxe até 500 mensagens recentes de um canal do Discord para o GameVox com um clique, das mais antigas para as mais novas.

Registro de conexão

Um registro ao vivo e com horário da conexão do bot direto nas configurações do servidor. Veja exatamente quando ele conectou ou por que não conectou.

Quer as mensagens indo para o outro lado também? Junte o relay com GameVox → Discord (Retransmissão de chat) na mesma aba de configurações: as mensagens do GameVox são postadas no Discord, e edições ou exclusões feitas no GameVox atualizam a cópia no Discord no lugar. A proteção contra loop já vem embutida: mensagens ecoadas nunca são retransmitidas de novo.

Configure

Uns cinco minutos. Você precisa de Gerenciar servidor no servidor do Discord e de Gerenciar servidor no servidor do GameVox. O assistente no app mostra os mesmos passos.

1

Crie seu bot

Abra o Discord Developer Portal, clique em New Application e dê um nome, algo como "GameVox Relay". A conta do bot é criada junto com a aplicação, e o nome dela é o que seus membros veem como a ponte. Cada comunidade cria o próprio bot, então ele fica totalmente sob o seu controle. Não precisa enviar avatar: o bot recebe automaticamente o ícone de relay do GameVox na primeira vez que conecta.

Captura de tela: Developer Portal → janela New Application com um nome preenchido
2

Deixe ele ler mensagens

Na sua aplicação, abra a aba Bot e role até Privileged Gateway Intents. Ative Message Content Intent e salve.

Sem essa opção, o Discord recusa a conexão na hora e nada pode ser retransmitido. É o erro de configuração mais comum. Deixe Presence e Server Members desligados; o relay não usa esses dois.
Captura de tela: aba Bot → Privileged Gateway Intents com Message Content Intent ativado
3

Copie o token do bot

Ainda na aba Bot, clique em Reset Token e copie o token. O Discord mostra o token uma única vez; se perder, é só resetar de novo. No GameVox ele fica guardado criptografado e nunca é mostrado para ninguém depois que você cola.

Captura de tela: aba Bot com o botão Reset Token / o token exibido uma única vez
4

Convide o bot para o seu servidor do Discord

No GameVox, abra Configurações do servidor → Integração com o Discord → Discord → GameVox e cole seu token na etapa 3 do assistente. Um link de convite aparece automaticamente: abra, escolha seu servidor do Discord e clique em Autorizar. O link concede Ver canais, Ver histórico de mensagens, Adicionar reações (para as reações feitas no GameVox aparecerem no Discord) e Gerenciar webhooks (que faz funcionar o sentido GameVox → Discord das mensagens).

Captura de tela: o assistente do GameVox com o link de convite gerado automaticamente
5

Garanta que o bot veja seus canais

O convite dá permissões no servidor todo, mas canais privados não herdam essas permissões. Em qualquer canal com acesso restrito, abra as configurações de permissão do canal no Discord e adicione o bot (ou um cargo que ele tenha) com Ver canal e Ver histórico de mensagens. Se o bot não enxerga um canal, nada é retransmitido dele e a importação do histórico falha com erro de permissão.

Captura de tela: permissões do canal no Discord com o bot adicionado e as duas permissões liberadas
6

Conecte e verifique

De volta ao assistente do GameVox, cole o ID do seu servidor do Discord (clique com o botão direito no nome do servidor no Discord → Copiar ID do servidor; se não aparecer, ative o Modo desenvolvedor em Configurações de usuário → Avançado) e clique em Conectar e verificar. O GameVox abre a conexão e acompanha ao vivo: em poucos segundos o status fica verde com Relay conectado e verificado. Se algo der errado, você vê o motivo exato e como resolver, em vez de um ícone girando.

Captura de tela: o card verde "Relay conectado e verificado" com o Registro de conexão logo abaixo
7

Mapeie canais e importe o histórico

Depois da verificação, a seção de mapeamento de canais é liberada. Para cada ponte: clique com o botão direito no canal do Discord → Copiar ID do canal, cole, escolha o canal do GameVox que vai espelhar e clique em Adicionar mapeamento. As novas mensagens começam a chegar na hora. Clique em Preencher histórico em qualquer mapeamento para puxar até 500 mensagens recentes, das mais antigas para as mais novas.

Captura de tela: uma linha de mapeamento de canal com o botão Preencher histórico e a contagem de um preenchimento concluído

Solução de problemas

Toda falha aparece no card de status e no Registro de conexão. Veja o que cada uma significa

O Discord recusou a conexão porque o Message Content Intent está desligado. No Developer Portal, abra sua aplicação → aba Bot → Privileged Gateway Intents → ative Message Content Intent → salve. Depois clique em Tentar conexão novamente no GameVox e você vai ver a sequência connecting → identifying → ready no Registro de conexão.

Para bots em menos de 100 servidores (o que bots de relay sempre são), a opção é instantânea e gratuita, sem nenhuma análise do Discord.

O Discord rejeitou o token do bot: ele foi digitado errado ou foi resetado no portal depois que você salvou. Vá até a aba Bot, clique em Reset Token, copie o novo token, cole em Configurações do bot no GameVox e clique em Atualizar. Um token novo força automaticamente uma nova conexão.

O bot está no seu servidor do Discord, mas não enxerga aquele canal específico. Quase sempre isso quer dizer que o canal (ou a categoria dele) é privado, e canais privados não herdam as permissões do servidor que vêm do convite.

Solução: no Discord, abra as configurações do canal → Permissões → adicione o bot (ou um cargo que ele tenha) com Ver canal e Ver histórico de mensagens liberados. Se o canal sincroniza as permissões com uma categoria, ajuste a categoria. Depois rode a importação do histórico de novo.

As mesmas regras de acesso valem para a retransmissão ao vivo: um canal que o bot não consegue ver não envia evento nenhum.

Siga estes passos em ordem:

1. Confira o mapeamento. O ID do canal do Discord precisa ser o do canal em que você está postando. Clique com o botão direito no próprio canal (não no servidor), use Copiar ID do canal e compare com a linha do mapeamento.

2. Confira se o bot enxerga o canal. Mesmas regras de acesso do 403 acima: se o canal for privado, adicione o bot nas permissões dele.

3. Confira se o status é READY. Se o Registro de conexão mostrar uma falha, resolva ela primeiro. Os mapeamentos só funcionam enquanto a conexão está ativa.

4. O intent foi revogado depois? Se o relay funcionava e parou depois de mudanças no Developer Portal, reative o Message Content Intent e clique em Tentar conexão novamente.

O Registro de conexão abaixo do card de status guarda cada estado pelo qual a conexão do bot passa, dos mais recentes para os mais antigos, e continua lá mesmo quando reiniciamos algo do nosso lado:

connecting / identifying: abrindo o gateway e fazendo login com o bot · ready: conectado e retransmitindo · reconnecting: uma oscilação de rede, recuperando sozinho · intent_denied / auth_failed: precisa de ação sua (veja acima) · stopped: o relay foi desativado ou está reiniciando.

Uma configuração saudável termina em ready. Qualquer coisa em vermelho mostra exatamente o que corrigir e, depois de corrigir, Tentar conexão novamente roda a sequência de novo enquanto você acompanha.

Requisitos

O que você precisa antes de começar

  • Seu próprio bot do Discord. Criado de graça no Developer Portal em cerca de um minuto, com o assistente de configuração guiando você. Um bot por comunidade deixa você no controle total do acesso dele.
  • Gerenciar servidor no Discord. Necessário para convidar o bot para o servidor que você vai espelhar.
  • Gerenciar servidor no GameVox. A aba Integração com o Discord nas configurações do servidor é restrita a donos e administradores.
  • Modo desenvolvedor do Discord para copiar IDs de servidor e de canal: Configurações de usuário → Avançado → Modo desenvolvedor.

Conecte sua comunidade

Mantenha a conversa em um só lugar enquanto sua comunidade faz a mudança. Configure o relay em cinco minutos.