Configurações do DonateX

Instalado à parte: este módulo não vem no instalador do aplicativo. Abra Catálogo de Módulos → Extensões e clique em Instalar no cartão dele; até lá, o aplicativo não tem esse módulo.

O que é esta página

Conexões → Monetização → DonateX é onde se dá um token da API ao DonateX para que as doações cheguem ao aplicativo. Duas coisas vivem aqui: o interruptor Aceitar doações e o token em si.

Como configurar

1. Abra Conexões → Monetização e clique em Conectar DonateX no cartão. Em um cartão já conectado, a mesma página abre com Configurar. A seta no canto superior esquerdo, Voltar, volta para a lista.
2. A página tem como título Configurações do DonateX, com "Configure o DonateX para receber notificações de doações." embaixo.
3. A linha de cima é Aceitar doações, com o subtítulo DonateX, com um distintivo e um interruptor. O interruptor atua no momento em que você o muda — não está esperando o botão de salvar. Com ele desligado, o distintivo diz Desativado e nada é recebido.
4. Clique em Abrir o painel do DonateX. Abre donatex.gg no seu navegador normal. A dica diz onde procurar: "O DonateX emite o token no seu painel, em Configurações → Api."
5. Copie o token dessa página e cole-o em Token da API. O campo esconde o que você escreve; enquanto está vazio, pede "Cole o seu token da API do DonateX".
6. Clique em Salvar Configurações no canto superior direito. Ele reporta sobre si mesmo — Salvando…, depois Salvo, ou Erro se o token não foi salvo. Depois de salvar com sucesso, a página se fecha sozinha e volta para a lista de serviços.
7. Salvar com o campo vazio e sem token salvo ainda é recusado com "Por favor, insira o seu token da API do DonateX."
8. Reabra a página para verificar. O campo do token está vazio de propósito — um token salvo nunca é mostrado a você. Que ele existe é dito pela mensagem dentro do campo: "Token salvo — deixe em branco para mantê-lo". Deixar o campo vazio e clicar em Salvar Configurações mantém o token salvo intocado; para substituí-lo, escreva o novo por cima.
9. O distintivo ao lado do interruptor diz a você onde está a conexão: Não conectado (ainda sem token), Desativado (o interruptor está desligado), Conectando…, Novo token necessário, Erro de conexão, ou Conectado como {username}. Ele se atualiza sozinho de poucos em poucos segundos enquanto a página está aberta.
10. Novo token necessário significa que o token salvo já não funciona. Obtenha um novo no painel do DonateX e salve-o por cima do antigo.

Uma recusa não é tomada como definitiva na hora. Se o DonateX já aceitou este token antes, o aplicativo responde a uma recusa com uma pausa e uma nova tentativa: 5 segundos, depois 10, 20 e assim por diante, até cinco minutos. Novo token necessário só aparece depois de dez minutos de recusas, e mesmo assim o token é testado de novo a cada cinco minutos, então o distintivo volta ao normal sozinho assim que o DonateX o aceitar. Para um token que o DonateX nunca aceitou, o aplicativo pede outro na hora.

O que chega, e o que conta como

• Uma doação do DonateX chega como um evento de doação normal, por isso os alertas, objetivos, o leilão e a voz sintetizada a captam sem serem informados sobre o DonateX.
• O valor é convertido para a sua moeda base, o mesmo que todos os outros serviços.
• Uma doação enviada do painel do DonateX como um teste chega como qualquer outra e conta para objetivos e o leilão. Isso é deliberado: um teste que pulasse os totais não poderia ser usado para verificá-los. Apague-o de Estatísticas depois e a sua contribuição é retirada.
• O nome do doador chega com a doação. Uma doação enviada anonimamente se mostra como anônima.

O que não pode fazer

• O token não pode ser lido de volta do aplicativo — o campo não mostra nada, e não há controle de revelação.
• Não há login no navegador aqui: o token é copiado à mão. O botão apenas abre o painel do DonateX, não busca nada.
• O nome da conta não é escrito. Ele chega com a conexão, e o distintivo o mostra como Conectado como {username} assim que o token funciona.
• O interruptor apenas governa se o DonateX é aceito. Não é o ligar/desligar do módulo no catálogo, e não desliga mais nada.
• Desconectar e Remover conexão (o ícone da lixeira) estão no cartão do DonateX em Conexões → Monetização, não nesta página.
• Nenhuma doação, valores ou histórico são mostrados aqui — esta página é apenas sobre acesso.
• Doações que chegaram enquanto o aplicativo estava fechado não são preenchidas retroativamente. O aplicativo recupera apenas pelo tempo em que esteve realmente conectado: se a conexão ao vivo ficou em silêncio por um tempo, o que perdeu é recuperado, mas as horas em que o aplicativo não estava funcionando não são preenchidas depois.