Configurações do DonationAlerts

Vem com o strAImer: este módulo é instalado junto com o aplicativo, então não há nada para baixar. Ele aparece em Catálogo de Módulos → Integrados.

O que é esta página

Conexões → Monetização → DonationAlerts é onde o app recebe acesso à sua conta do DonationAlerts. A página faz uma coisa — conectar você através do navegador — e relata se esse acesso ainda está ativo.

Como configurar

1. Abra Conexões → Monetização e encontre o cartão do DonationAlerts. Conectar DonationAlerts abre esta página. Em um cartão que já está conectado, a mesma página abre com Configurar, e com Reconectar quando o cartão está pedindo para você fazer login novamente.
2. A página é intitulada Configurações do DonationAlerts, com a linha "Configure a integração com o DonationAlerts para receber notificações de doações." abaixo dela. A seta no canto superior esquerdo, Voltar, retorna para a lista.
3. A primeira linha é Status da Conexão, e ao lado um indicador com uma das seis redações: Conectado como {username}, Conectando…, Conectado, mas nenhum evento está chegando, Login necessário, Erro de conexão ou Desconectado. O indicador se relê a cada quatro segundos enquanto a página está aberta — não há necessidade de reabri-la para ver uma mudança. Uma das seis precisa de uma palavra de explicação: Conectado, mas nenhum evento está chegando significa que as doações estão chegando ao app com atraso em vez de ao vivo. Por que isso acontece, e o que fazer sobre isso, está em "Conectado, mas nada chega".
4. A dica abaixo do status diz por que o login é necessário: "Requer autorização para receber alertas de doação em tempo real."
5. Pressione Autorizar via Navegador. O app abre a página de login do DonationAlerts no seu navegador comum — nada é digitado dentro do app.
6. Termine o login naquela janela do navegador. Ela mostra Finalizando login… com "Um momento, salvando a conexão.", então Autorização bem-sucedida! com "Conta {username} foi conectada com sucesso." e "Pode fechar esta janela. Ela será fechada automaticamente em alguns segundos."
7. Volte ao app. A página de configurações mostra Configuração do DonationAlerts salva com sucesso! e se fecha um momento depois, de volta à lista de serviços.
8. Abra-a novamente para verificar o resultado: Nome da Conta (login) agora contém o login da conta conectada, e o indicador mostra Conectado como {username}. Se o indicador disser Login necessário, pressione Autorizar via Navegador mais uma vez — essa é toda a reparação.

Uma recusa não é tomada como definitiva na hora. Se o DonationAlerts já aceitou esse login antes, o app responde à recusa com uma pausa e uma nova tentativa: 5 segundos, depois 10, 20 e assim por diante, até cinco minutos. O indicador mostra Erro de conexão a partir da terceira recusa seguida, e Login necessário só depois que as recusas duram dez minutos sem nenhuma resposta aceita (dois minutos logo depois de iniciar ou salvar). Mesmo assim o login é testado de novo a cada cinco minutos, e o indicador volta ao normal sozinho assim que o DonationAlerts o aceitar. Um login que o DonationAlerts nunca aceitou pede um novo login na hora.

O que não pode fazer

• Não há campo para um token. Nem um token de acesso nem um token de atualização, nem um Client ID ou Client Secret de aplicativo, é solicitado em qualquer lugar desta página — o botão faz tudo isso. Conselhos que dizem para colar um token não correspondem a esta página.
• Nada aqui é digitado ou salvo manualmente. A página não tem botão de salvar, e Nome da Conta (login) é apenas para exibição — é preenchido pelo login.
• O indicador não pode ser dispensado, redefinido ou reconhecido. Ele relata o que o módulo encontrou, e muda apenas quando o que o módulo encontra muda.
• A conta conectada não pode ser trocada editando esse campo. Fazer login novamente é a única maneira de alterá-la.
• Desconectar não está nesta página: Desconectar e o ícone de lixeira, Remover conexão, ficam no cartão do DonationAlerts em Conexões → Monetização.
• Nenhuma doação, valor, histórico ou moeda é mostrado aqui — esta página é apenas sobre acesso.