Configurações do StreamElements

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 → StreamElements é onde o StreamElements recebe o seu token JWT para que as doações cheguem ao aplicativo. A página contém o token e um crachá que indica se o StreamElements confirmou a conexão.

Como configurar

1. O StreamElements não vem com o aplicativo. Se o cartão estiver faltando em Conexões → Monetização, instale-o primeiro a partir de Catálogo de Módulos → Extensões.
2. Pressione Conectar StreamElements no cartão. Em um cartão já conectado, a mesma página abre com Configurar. A seta no canto superior esquerdo, Voltar, regressa à lista.
3. A página tem o título Configurações do StreamElements, com "Configure a integração com o StreamElements para receber notificações de doações." por baixo.
4. Pressione Abrir conta StreamElements. O seu navegador normal abre streamelements.com na página de canais. A dica descreve o percurso: "O token está na sua conta StreamElements: ícone da conta → nome do canal → ative "Mostrar segredos" na linha do canal → copie o JWT."
5. Copie esse token e cole-o em Token JWT do StreamElements. O campo esconde o que escreve; quando vazio, solicita "Inserir Token JWT (disponível nas Configurações do Canal do StreamElements)".
6. Pressione Salvar Configurações no canto superior direito. O botão reporta sobre si mesmo — Salvando…, depois Salvo, ou Erro se o token não foi armazenado. Após uma gravação bem-sucedida, a página se fecha sozinha e regressa à lista de serviços.
7. Salvar um campo vazio quando nenhum token está ainda armazenado é recusado com "Por favor, insira o seu token JWT."
8. Reabra a página para verificar. O campo está vazio de propósito — um token armazenado nunca é mostrado novamente. A sua existência é indicada pela mensagem dentro do campo: "Token salvo — deixe em branco para mantê-lo". Deixá-lo vazio e pressionar Salvar Configurações mantém o token armazenado; para substituí-lo, escreva o novo por cima.
9. Estado da Conexão no topo contém o crachá: Desconectado (nenhum token salvo), Conectando…, Erro de conexão (a conexão caiu, ou o StreamElements recusou o JWT várias vezes seguidas), Login necessário (o JWT precisa ser trocado), ou o estado conectado nomeando a conta. Atualiza-se sozinho a cada poucos segundos enquanto a página está aberta.
10. Um crachá verde significa que o StreamElements confirmou a conexão, não apenas que um token está armazenado. Um JWT que nunca foi aceito, porque foi colado o errado, mostra Login necessário na hora; um expirado ou revogado chega lá passando pelas pausas descritas abaixo. Aqui não há onde fazer login: copie um token novo e salve-o por cima do antigo.

Uma recusa não é tomada como definitiva na hora. Se o StreamElements já aceitou este JWT antes, o aplicativo responde a uma recusa com uma pausa e uma nova conexão: 5 segundos, depois 10, 20 e assim por diante, até cinco minutos, e o crachá só passa para Erro de conexão a partir da terceira recusa seguida. Login necessário aparece depois de dez minutos de recusas, ou depois de dois a três minutos se o StreamElements ainda não aceitou o JWT desde que o aplicativo foi aberto ou as configurações foram salvas. Mesmo assim o JWT é testado de novo a cada cinco minutos. Para um JWT que o StreamElements nunca aceitou, o aplicativo pede outro na hora.

O que chega do StreamElements

• Só gorjetas. Cada gorjeta chega como uma doação comum, então os alertas, as metas, o leilão e a voz sintetizada a recebem. Todo o resto que o StreamElements informa, como novos seguidores, inscrições, cheers ou vendas da loja, é ignorado aqui. Seguidores, inscrições e cheers chegam ao aplicativo pelas conexões das plataformas em Conexões → Canais, e uma segunda cópia os contaria duas vezes.
• Alertas de teste não são gorjetas. O aplicativo escuta as gorjetas de verdade do seu canal, e um teste disparado no editor de overlays do StreamElements não chega até ele. Confira a conexão pelo crachá desta página, e a aparência de um alerta por Reproduzir na aba Teste do editor de alertas.

O que não pode fazer

• O token não pode ser lido de volta a partir do aplicativo: o campo não mostra nada e não tem controle de revelação.
• Não há login no navegador — o JWT é transportado manualmente. O botão apenas abre a página do StreamElements, não busca nada.
• O nome da conta não é digitado. O StreamElements o informa, junto com o avatar do canal, logo depois de aceitar o JWT, então nenhuma doação é necessária. Se esse único pedido falhar, o cartão na lista mostra "Nome da conta aparece após a primeira doação", mas no StreamElements uma doação não traz o nome: quem traz é a próxima conexão aceita, por exemplo depois de reiniciar o aplicativo.
• Não há um interruptor separado de "aceitar doações" nesta página.
• Desconectar e Remover conexão (o ícone da lixeira) estão no cartão do StreamElements em Conexões → Monetização, não aqui.
• Nenhuma doação, valores ou histórico são mostrados — esta página é apenas sobre acesso.