Configurações do DonateX

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 à aplicação. Duas coisas vivem aqui: o interruptor Aceitar doações e o token em si.

Como configurar

1. Abre Conexões → Monetização e carrega em Ligar DonateX no cartão. Num cartão já ligado, 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 "Configura o DonateX para receber notificações de doações." por baixo.
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 o mudas — não está à espera do botão de guardar. Com ele desligado, o distintivo diz Desativado e nada é recebido.
4. Carrega em Abrir o painel do DonateX. Abre donatex.gg no teu navegador normal. A dica diz onde procurar: "O DonateX emite o token no teu painel, em Definições → Api."
5. Copia o token dessa página e cola-o em Token da API. O campo esconde o que escreves; enquanto está vazio, pede "Cola o teu token da API do DonateX".
6. Carrega em Guardar Configurações no canto superior direito. Ele reporta sobre si mesmo — A guardar…, depois Guardado, ou Erro se o token não foi guardado. Depois de uma guardagem bem-sucedida, a página fecha-se sozinha e volta para a lista de serviços.
7. Guardar com o campo vazio e sem token guardado ainda é recusado com "Introduz o teu token da API do DonateX."
8. Reabre a página para verificar. O campo do token está vazio de propósito — um token guardado nunca te é mostrado. Que ele existe é dito pela mensagem dentro do campo: "Token guardado — deixa vazio para o manter". Deixar o campo vazio e carregar em Guardar Configurações mantém o token guardado intocado; para o substituir, escreve o novo por cima.
9. O distintivo ao lado do interruptor diz-te onde está a ligação: Não conectado (ainda sem token), Desativado (o interruptor está desligado), A ligar…, Novo token necessário, Erro de ligação, ou **Conectado como {username}". Ele atualiza-se sozinho de poucos em poucos segundos enquanto a página está aberta.
10. Novo token necessário significa que o token guardado já não funciona. Obtém um novo no painel do DonateX e guarda-o por cima do antigo.

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 off apanham-na sem serem informados sobre o DonateX.
• O montante é convertido para a tua 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 saltasse os totais não poderia ser usado para os verificar. Apaga-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 mostra-se como anónima.

O que não pode fazer

• O token não pode ser lido de volta da aplicação — o campo não mostra nada, e não há controlo de revelação.
• Não há início de sessão 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 ligação, e o distintivo mostra-o como Conectado como {username} assim que o token funciona.
• O interruptor apenas governa se o DonateX é aceite. Não é o ligar/desligar do módulo no catálogo, e não desliga mais nada.
• Desligar e Remover ligação (o ícone do caixote) estão no cartão do DonateX em Conexões → Monetização, não nesta página.
• Nenhumas doações, montantes ou histórico são mostrados aqui — esta página é apenas sobre acesso.
• Doações que chegaram enquanto a aplicação estava fechada não são preenchidas retroativamente. A aplicação recupera apenas pelo tempo em que esteve realmente conectada: se a ligação em direto ficou em silêncio por um tempo, o que perdeu é recuperado, mas as horas em que a aplicação não estava a funcionar não são preenchidas depois.