{"id":193123,"date":"2025-08-17T19:54:41","date_gmt":"2025-08-17T17:54:41","guid":{"rendered":"https:\/\/fivemx.com\/?p=193123"},"modified":"2026-08-12T15:40:38","modified_gmt":"2026-08-12T13:40:38","slug":"configuracao-do-discord-do-txadmin","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/pt\/txadmin-discord-setup\/","title":{"rendered":"Como conectar o txAdmin ao Discord: status, cargos e whitelist"},"content":{"rendered":"<p><strong>Para conectar o txAdmin ao Discord, crie um aplicativo e bot Discord dedicados, convide-o para o servidor correto com apenas as permiss\u00f5es necess\u00e1rias, copie o token do bot nas configura\u00e7\u00f5es do Discord do txAdmin e configure as mensagens de status e o acesso baseado em cargos como recursos separados.<\/strong> Mantenha o token privado: ele autentica o bot e nunca deve aparecer em capturas de tela, arquivos do cliente ou um reposit\u00f3rio p\u00fablico.<\/p>\n<h2 id=\"separate-the-four-moving-parts\">Separe os quatro componentes<\/h2>\n<div aria-label=\"Tabela com rolagem horizontal\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\n<table>\n<thead>\n<tr>\n<th>Parte<\/th>\n<th>Prop\u00f3sito<\/th>\n<th>Falha t\u00edpica<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>aplicativo Discord e bot<\/td>\n<td>Identidade usada por txAdmin<\/td>\n<td>Aplicativo errado, bot desativado ou token regenerado<\/td>\n<\/tr>\n<tr>\n<td>Status do servidor<\/td>\n<td>Publica ou atualiza o status em um canal escolhido<\/td>\n<td>Canal errado ou permiss\u00f5es de visualiza\u00e7\u00e3o\/envio\/incorpora\u00e7\u00e3o ausentes<\/td>\n<\/tr>\n<tr>\n<td>Cargos ou lista de permiss\u00f5es<\/td>\n<td>Mapeia a associa\u00e7\u00e3o\/cargos Discord para a regra de acesso configurada<\/td>\n<td>ID incorreto do servidor ou cargo, hierarquia de cargos ou exig\u00eancia de intent de membros<\/td>\n<\/tr>\n<tr>\n<td>Permiss\u00f5es do txAdmin<\/td>\n<td>Controla quem pode administrar o servidor FiveM<\/td>\n<td>Suposi\u00e7\u00e3o de que um cargo no Discord concede automaticamente permiss\u00f5es no txAdmin<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>N\u00e3o depure esses componentes como uma \u00fanica funcionalidade. Primeiro confirme que o bot est\u00e1 online, depois que consegue acessar um canal, em seguida configure o status e s\u00f3 ent\u00e3o teste a l\u00f3gica opcional de cargos ou da lista de acesso permitido.<\/p>\n<h2 id=\"step-1-create-a-dedicated-discord-application\">Passo 1: crie um aplicativo Discord dedicado<\/h2>\n<ol>\n<li>Abra o Portal do Desenvolvedor do Discord e crie um novo aplicativo para este servidor.<\/li>\n<li>Adicione um bot ao aplicativo.<\/li>\n<li>D\u00ea um nome claro ao bot para que a equipe possa distinguir o ambiente de produ\u00e7\u00e3o do ambiente de homologa\u00e7\u00e3o.<\/li>\n<li>Gere ou redefina o token apenas quando estiver pronto para armazen\u00e1-lo com seguran\u00e7a.<\/li>\n<\/ol>\n<p>Um token de bot \u00e9 um segredo, n\u00e3o um ID de aplicativo ou chave p\u00fablica. Se for exposto, redefina-o no Discord e atualize o txAdmin imediatamente. Armazene a substitui\u00e7\u00e3o apenas na configura\u00e7\u00e3o do lado do servidor destinada ao token.<\/p>\n<h2 id=\"step-2-invite-the-bot-with-minimal-permissions\">Passo 2: convide o bot com permiss\u00f5es m\u00ednimas<\/h2>\n<p>Use o fluxo de instala\u00e7\u00e3o OAuth2 do Discord para o aplicativo e selecione o escopo do bot exigido pela configura\u00e7\u00e3o atual. Comece com as menores permiss\u00f5es de canal que satisfa\u00e7am o recurso: visualize o canal selecionado, envie mensagens, incorpore links e leia o hist\u00f3rico de mensagens onde a atualiza\u00e7\u00e3o de status precisar. Evite Administrador, a menos que a integra\u00e7\u00e3o oficial o exija explicitamente e voc\u00ea tenha revisado o porqu\u00ea.<\/p>\n<p>Restrinja o bot a um canal de status ou administra\u00e7\u00e3o dedicado, quando pr\u00e1tico. Ap\u00f3s convid\u00e1-lo, confirme se ele aparece no servidor Discord pretendido. Ser listado como offline \u00e9 esperado at\u00e9 que o txAdmin fa\u00e7a login com sucesso com o token.<\/p>\n<h2 id=\"step-3-configure-the-bot-in-txadmin\">Passo 3: configure o bot no txAdmin<\/h2>\n<p>Abra o txAdmin como um administrador autorizado e localize as configura\u00e7\u00f5es de integra\u00e7\u00e3o do Discord em sua vers\u00e3o instalada. Cole o token no campo do token sem aspas ou espa\u00e7os extras. Selecione o servidor e o canal Discord pretendidos usando as entradas fornecidas pelo txAdmin. Salve e, em seguida, reinicie apenas o componente ou servidor se a interface solicitar.<\/p>\n<p>Se voc\u00ea estiver construindo o lado FiveM do zero, use o <a href=\"https:\/\/rpcrate.com\/pt\/como-criar-um-servidor-fivem\/\">caminho de configura\u00e7\u00e3o do servidor FiveM<\/a> primeiro. O Discord n\u00e3o pode corrigir um FXServer com problemas ou uma inst\u00e2ncia inacess\u00edvel do txAdmin.<\/p>\n<h2 id=\"configure-status-messages-separately\">Configure as mensagens de status separadamente<\/h2>\n<p>Ative a funcionalidade de status e selecione um canal onde o bot possa publicar. Comece com uma atualiza\u00e7\u00e3o simples de teste antes de adicionar texto personalizado ou embeds. Confirme que a mensagem muda quando o servidor FiveM inicia, para ou muda a quantidade de jogadores, conforme o comportamento documentado pela sua vers\u00e3o do txAdmin.<\/p>\n<p>Se o bot fizer login, mas nenhum status aparecer, verifique o ID do canal selecionado e as substitui\u00e7\u00f5es de permiss\u00f5es espec\u00edficas desse canal. Um cargo do servidor pode permitir o envio, enquanto uma permiss\u00e3o do canal o nega. Inspecione tamb\u00e9m a sa\u00edda do console ou dos logs do txAdmin para ver a resposta da API do Discord em vez de gerar o token repetidamente.<\/p>\n<h2 id=\"configure-roles-or-whitelist-rules-separately\">Configure os cargos ou as regras de whitelist separadamente<\/h2>\n<p>O acesso baseado em cargos exige os identificadores exatos do servidor e dos cargos do Discord esperados pela integra\u00e7\u00e3o. Ative o modo de desenvolvedor do Discord para copiar os IDs quando a configura\u00e7\u00e3o atual os solicitar. Nomes de cargos n\u00e3o s\u00e3o identificadores est\u00e1veis e dois cargos podem ter nomes semelhantes.<\/p>\n<p>Teste com uma conta que tenha o cargo exigido e outra que n\u00e3o tenha. Remova e adicione novamente o cargo, reconecte e confirme quando a integra\u00e7\u00e3o atualiza a participa\u00e7\u00e3o. N\u00e3o presuma que um cargo do Discord concede automaticamente permiss\u00f5es de administrador no txAdmin; o modelo de permiss\u00f5es do pr\u00f3prio txAdmin permanece um controle separado, a menos que a funcionalidade documentada fa\u00e7a esse mapeamento explicitamente.<\/p>\n<h2 id=\"protect-the-token-and-permission-boundary\">Proteja o token e os limites de permiss\u00e3o<\/h2>\n<ul>\n<li>Nunca cole o token em um chat do Discord, em um ticket de suporte vis\u00edvel para outras pessoas ou em um recurso do lado do cliente.<\/li>\n<li>N\u00e3o o inclua em commits do Git nem em capturas de tela p\u00fablicas.<\/li>\n<li>Limite o acesso ao aplicativo no Discord Developer Portal e \u00e0s configura\u00e7\u00f5es do txAdmin.<\/li>\n<li>Redefina o token ap\u00f3s uma exposi\u00e7\u00e3o ou quando um administrador com acesso sair.<\/li>\n<li>Revise periodicamente as permiss\u00f5es do bot no servidor e nos canais.<\/li>\n<\/ul>\n<h2 id=\"troubleshooting-checklist\">Lista de verifica\u00e7\u00e3o para solucionar problemas<\/h2>\n<div aria-label=\"Tabela com rolagem horizontal\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\n<table>\n<thead>\n<tr>\n<th>Sintoma<\/th>\n<th>Verifica\u00e7\u00e3o<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>O bot permanece offline<\/td>\n<td>O token pertence ao bot correto, n\u00e3o cont\u00e9m espa\u00e7os em branco, n\u00e3o foi redefinido e os logs do txAdmin mostram uma tentativa de login<\/td>\n<\/tr>\n<tr>\n<td>O bot est\u00e1 online, mas n\u00e3o consegue publicar<\/td>\n<td>Canal selecionado, permiss\u00f5es de visualizar, enviar e incorporar links, e substitui\u00e7\u00f5es de permiss\u00f5es do canal<\/td>\n<\/tr>\n<tr>\n<td>O status nunca \u00e9 atualizado<\/td>\n<td>Funcionalidade de status ativada, canal correto, estado do txAdmin\/FXServer e log da integra\u00e7\u00e3o<\/td>\n<\/tr>\n<tr>\n<td>Um membro com o cargo \u00e9 rejeitado<\/td>\n<td>ID correto do servidor e do cargo, cargo realmente atribu\u00eddo, comportamento de atualiza\u00e7\u00e3o e reconex\u00e3o e qualquer intent de membros exigida<\/td>\n<\/tr>\n<tr>\n<td>Um membro n\u00e3o autorizado \u00e9 aceito<\/td>\n<td>Regras alternativas de acesso, v\u00e1rios cargos permitidos e configura\u00e7\u00e3o de permiss\u00f5es no servidor<\/td>\n<\/tr>\n<tr>\n<td>Parou de funcionar ap\u00f3s redefinir o token<\/td>\n<td>O txAdmin ainda est\u00e1 usando o token antigo; salve o novo e reinicie conforme necess\u00e1rio<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2 id=\"final-verification\">Verifica\u00e7\u00e3o final<\/h2>\n<ol>\n<li>O bot faz login ap\u00f3s uma reinicializa\u00e7\u00e3o limpa, sem erros de token.<\/li>\n<li>O status \u00e9 publicado somente no canal pretendido.<\/li>\n<li>O cargo m\u00ednimo do bot permite atualizar a mensagem sem privil\u00e9gios mais amplos no servidor.<\/li>\n<li>O usu\u00e1rio de teste autorizado passa pela regra de cargo ou whitelist.<\/li>\n<li>O usu\u00e1rio de teste n\u00e3o autorizado \u00e9 rejeitado pela mesma regra.<\/li>\n<li>Nem o acesso ao Discord nem um bot\u00e3o oculto na interface contornam as permiss\u00f5es de administrador do pr\u00f3prio txAdmin.<\/li>\n<\/ol>\n<p>Quando essas verifica\u00e7\u00f5es passam de forma independente, a integra\u00e7\u00e3o fica mais f\u00e1cil de manter: uma identidade de bot, um segredo protegido, acesso restrito aos canais e regras expl\u00edcitas para status, whitelist e administra\u00e7\u00e3o.<\/p>\n<h2 id=\"reference-documentation\">Documenta\u00e7\u00e3o de refer\u00eancia<\/h2>\n<p><a href=\"https:\/\/docs.fivem.net\/docs\/resources\/txAdmin\/\">Cfx.re \u2014 txAdmin<\/a> \u00b7 <a href=\"https:\/\/docs.discord.com\/developers\/quick-start\/getting-started\">Fonte: docs.discord.com<\/a> \u00b7 <a href=\"https:\/\/docs.discord.com\/developers\/topics\/oauth2\">Fonte: docs.discord.com<\/a><\/p>","protected":false},"excerpt":{"rendered":"<p>Para conectar txAdmin ao Discord, crie um aplicativo e bot dedicado do Discord, convide-o para o servidor correto apenas com as permiss\u00f5es necess\u00e1rias, copie o token do bot nas configura\u00e7\u00f5es do Discord do txAdmin e configure mensagens de status e acesso baseado em fun\u00e7\u00f5es como recursos separados. Mantenha o token privado: ele autentica o bot e nunca deve aparecer em capturas de tela, arquivos do cliente ou em um reposit\u00f3rio p\u00fablico.<\/p>","protected":false},"author":1,"featured_media":193124,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2885],"tags":[],"class_list":["post-193123","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-discord-guides"],"_links":{"self":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/193123","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/comments?post=193123"}],"version-history":[{"count":2,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/193123\/revisions"}],"predecessor-version":[{"id":213836,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/193123\/revisions\/213836"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media\/193124"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media?parent=193123"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/categories?post=193123"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/tags?post=193123"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}