Integração com Twitch
- onde eu conecto meu canal da Twitch
- o chat da Twitch não chega no aplicativo
- o bot escreve da minha própria conta, eu quero uma separada
- enquetes e clipes na Twitch não funcionam
- diz que faltam algumas permissões
- diz para entrar novamente para reconectar
O que é esta página
A página conecta uma conta da Twitch ao aplicativo — como sua descrição diz, "Configure a integração com a Twitch para receber mensagens do chat, recompensas e gerenciar seu canal." Ela existe em duas variantes: o próprio canal do streamer e uma conta separada da qual o bot escreve.
Como configurar
- Abra Conexões → Canais e abra a página da Twitch. Seu cabeçalho diz Conta do Streamer (Lê eventos, EventSub).
- Status da Conexão mostra uma de quatro frases. A dica ao lado nomeia o que está sendo solicitado: "Requer permissões máximas (ler chat, gerenciar stream, enquetes, previsões e pontos do canal)."
- Pressione Autorizar via Navegador. A página tem um botão e nenhum campo para um token — o login abre no seu navegador usual e termina lá.
- Entre na Twitch no navegador e concorde com as permissões. Em caso de sucesso, a página do navegador diz Autorização bem-sucedida! — "A conta {username} foi conectada com sucesso ao strAImer", e abaixo, "Você pode fechar esta janela. Ela será fechada automaticamente em alguns segundos."
- A página do módulo relata Configuração da Twitch salva com sucesso! e fecha-se um momento depois. Nome da Conta (login) agora mostra o login conectado; o campo é somente leitura.
- Permissões concedidas aparece — "Quais recursos funcionam com o token atual". Cada recurso está marcado ou riscado: Ler e enviar mensagens no chat, Recompensas de pontos do canal, Eventos de assinatura paga, Alterar título e categoria da stream, Criar clipes, Enquetes, Previsões, Gerenciar anúncios.
- Se algo estiver riscado, um aviso é exibido: "Algumas permissões estão faltando — os recursos relacionados não funcionarão. Reautorize para concedê-las." O botão Reautorizar ao lado inicia o mesmo login no navegador, e é isso que adiciona os direitos faltantes.
- A seta no canto superior esquerdo, Voltar, sai da página.
O que as quatro frases de status significam
- Conectado como {username} — verde. A conta está salva e nem a Twitch nem o módulo a recusaram. É isso que certifica: o login está bom. Não é um teste ao vivo de se os eventos estão fluindo neste segundo.
- Entre novamente para reconectar — amarelo. A conta ainda está aqui e seu nome ainda é mostrado abaixo, porque você precisa saber qual conta reparar — mas a Twitch recusou o acesso salvo e não o renovará em segundo plano. Nada chega do canal até você entrar novamente, e entrar novamente é o único reparo; não há botão que o atualize de fora.
- Erro de conexão — vermelho. A conta está boa e a conexão não está: o fluxo de eventos caiu, ou o módulo não conseguiu finalizar sua configuração. O módulo tenta novamente sozinho, então este muitas vezes se resolve sem você tocar em nada.
- Desconectado — vermelho, e o único dos quatro que oculta a linha Nome da Conta (login), porque não há conta salva nesta página ainda. É isso que uma instalação nova mostra.
O selo é lido quando a página abre, então uma frase que mudou enquanto você estava na página aparece depois que você sai com Voltar e a abre novamente.
A conta do bot
A mesma página em Conexões → Bots é intitulada Conta do Bot (Envia respostas ao chat), e sua dica é mais curta: "Requer permissões para ler e enviar mensagens no chat." O login é o mesmo botão, Autorizar via Navegador — entre lá sob a conta da qual o bot deve escrever, não a sua própria. Sua lista Permissões concedidas tem três linhas: Ler e enviar mensagens no chat, Moderação: banir e excluir mensagens, Anúncios no chat.
As duas contas são julgadas separadamente, e o bot relata apenas três das quatro frases — ele nunca diz Erro de conexão. Um login do bot que a Twitch recusou não arrasta a própria conexão do streamer para Entre novamente para reconectar junto.
Se o navegador relatar um erro
Em vez da página de sucesso, a Twitch pode retornar Erro de Autorização — "Falha ao trocar código de autorização por tokens: {error}". A conta permanece como estava; pressione Autorizar via Navegador novamente.
O que não pode fazer
- Não há lugar para colar um token, uma chave de acesso ou uma chave de atualização. Autorizar via Navegador é a única entrada, e também é como um login expirado é renovado.
- Nome da Conta (login) não pode ser digitado. Para conectar uma conta diferente, entre como essa conta.
- As permissões não podem ser escolhidas uma a uma. A lista de marcações apenas relata o que o login atual carrega; Reautorizar entrega todo o conjunto novamente.
- Não há campos de Client ID e Client Secret, e nenhum é necessário: o login passa pelo próprio aplicativo strAImer.
- A página não tem botão Salvar: tudo é armazenado ao final do login no navegador.
- A página não desconecta a conta nem exclui a conexão, e não desliga o módulo.
- A conta do streamer e a conta do bot são configuradas separadamente: um login não preenche o outro.