Integração com YouTube

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

A página conecta um canal do YouTube ao aplicativo — como sua descrição diz, "Configure a integração com o YouTube para receber mensagens do chat e gerenciar transmissões." Existe em duas variantes: o próprio canal, e uma conta separada da qual o bot responde.

Como configurar

1. Abra Conexões → Canais e abra a página do YouTube. Seu cabeçalho diz Canal do YouTube (Lê eventos, transmissão).
2. Status da Conexão mostra onde você está: Desconectado enquanto nenhum canal está conectado, Conectado como {username} uma vez que o canal esteja configurado, Entre novamente em amarelo quando o YouTube deixou de aceitar o seu login, e O Google recusou as chaves do app em vermelho, no caso raro descrito abaixo. A dica ao lado nomeia o que está sendo solicitado: "Requer autorização para verificar transmissões ativas e enviar mensagens para o chat do YouTube."
3. 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á.
4. Faça login na conta do Google que possui o canal e concorde com as permissões. Deixe todas as caixas marcadas. O Google lista suas permissões uma por uma e permite que você as desmarque, e desmarcar uma é a razão mais comum para o YouTube acabar conectado e silencioso: sem a permissão para ver suas transmissões, o aplicativo nunca descobre que você está ao vivo, e um chat que não consegue encontrar é um chat que não consegue ler. Desde a versão 0.9.2, o aplicativo recusa tal login e avisa nessa página; antes disso, a conexão simplesmente ficava verde e nada chegava. Em caso de sucesso, a página do navegador diz Autorização bem-sucedida! — "A conta {nome de usuário} foi conectada com sucesso ao YouTube", e abaixo, "Você pode fechar esta janela. Ela será fechada automaticamente em alguns segundos." Enquanto isso, a página do módulo diz "Conclua o login na janela do navegador — esta página vai atualizar sozinha.", depois de dois minutos "Ainda esperando o navegador…", e depois de quinze minutos desiste com "O login não foi concluído. A janela do navegador foi fechada ou o acesso foi negado — aperte o botão para tentar de novo."
5. A página do módulo relata Configuração do YouTube salva com sucesso! e se fecha um momento depois. Nome da Conta (login) agora mostra o canal conectado; o campo é somente leitura.
6. O chat chega junto com uma transmissão: o módulo lê o chat ao vivo de uma transmissão que está em andamento. Sem nada ao vivo, não há nada para ler. Uma transmissão pública é detectada em até um minuto; uma não listada pode levar até meia hora, porque não é mostrada na página do canal e o aplicativo tem que perguntar ao Google sobre ela — raramente, para permanecer dentro de um limite de solicitações compartilhado por todos usando strAImer. Pressionar Autorizar via Navegador a encontra imediatamente. Para saber se o chat de uma transmissão em andamento realmente começou, olhe a etiqueta do YouTube em Conexões → Canais, não esta página: o guia "Entrar em plataformas", seção "YouTube: o chat chega junto com a transmissão", diz o que cada etiqueta significa.
7. Se o login parar de funcionar depois, o selo fica amarelo, Entre novamente, e o nome do canal continua na página. Pressione Autorizar via Navegador novamente: o mesmo botão o renova. Desconectado nunca significa um login expirado, só que nenhum canal está conectado.
8. A seta no canto superior esquerdo, Voltar, sai da página.

A conta do bot

A mesma página em Conexões → Bots tem o cabeçalho Conta do Bot do YouTube (Envia respostas para o chat), e funciona de forma diferente da página do canal acima: um botão, não dois.

1. Pressione Conectar o bot. Uma janela abre dentro do aplicativo: "faça login na conta do Google do bot, então escolha o canal do YouTube no qual ele escreve. Uma conta pode ter vários canais, e o aplicativo não pode saber qual você quer."
2. Faça login como a conta da qual o bot deve responder — não a própria conta do canal.
3. Escolha o canal na página que segue. Essa escolha é o que os espectadores verão como o autor das mensagens do bot.

Uma vez conectado, o botão muda para Fazer login novamente ou trocar de canal e a linha abaixo explica por que o login existe afinal: "O bot escreve da maneira que um navegador faz, então suas respostas e moderação não gastam o limite compartilhado de solicitações do YouTube." Pressione o mesmo botão para mover o bot para outro canal da mesma conta.

Torne o bot um moderador do seu canal. Sem isso, o YouTube recusa bans, time-outs e exclusão de mensagens, não importa o que o aplicativo faça — moderação é um direito que a plataforma concede, não uma configuração aqui.

Se o login salvo parar de funcionar, a página avisa: "O login salvo parou de funcionar, então o bot não está escrevendo. Pressione o botão para fazer login novamente." Logins expiram — esta é a forma normal de renovar um.

Se o seu próprio login parar de funcionar, a transmissão continua sendo lida. O status mostra Entre novamente, e a página explica o que para de funcionar: "O YouTube não aceita mais o seu login. O app continua encontrando suas transmissões públicas e lendo o chat delas, mas até você entrar novamente ele não vai conseguir enviar mensagens em seu nome nem encontrar transmissões que só podem ser vistas pelo link, e só vai conseguir moderar o chat pela conta de bot." Isso só funciona quando o app já identificou o seu canal. Se ainda não identificou, a página diz que não consegue encontrar a sua transmissão, e o único jeito é entrar novamente antes de entrar ao vivo.

Entrar com o bot não é uma otimização: sem isso o aplicativo fica calado no YouTube. Esta é a parte que vale ler duas vezes. Temporizadores, respostas de comandos e o agente de IA são mensagens automáticas, e uma mensagem automática sem um login de bot por trás não é enviada de jeito nenhum: o motivo vai para o console de logs e para lugar nenhum além disso. Suas próprias mensagens, digitadas à mão no bloco do chat, são a exceção: elas saem tendo ou não um bot configurado, desde que haja uma transmissão ao vivo.

Quando o login existe mas para de funcionar, a mensagem não é descartada. Ela sai pela via oficial sob o nome do seu próprio canal, então os espectadores a veem de você e não do bot. É um remendo deliberado: o silêncio significaria temporizadores, respostas de comandos e o agente calando todos de uma vez. O aplicativo escreve um aviso no log toda vez, então um bot que de repente escreve com o seu nome é sinal de que o login dele precisa ser renovado.

Os dois casos precisam de uma transmissão de fato ao vivo. Sem nada no ar não há chat para escrever, e a mensagem é recusada por esse motivo.

Se a página disser "O Google recusou as chaves do app"

Esse selo vermelho é outra coisa que não um login expirado: o Google não aceita mais as chaves com que o próprio aplicativo faz login, e entrar de novo não resolve. A página explica com um código: "O Google não aceita mais as chaves com que o strAImer faz login (código: {code}). Fazer login de novo não vai resolver enquanto o strAImer não for atualizado: atualize e faça login de novo. Se ele já estiver na versão mais recente, escreva para nós em Ajuda e Feedback → Contatar." Então: atualize o aplicativo e depois pressione Autorizar via Navegador; se o aplicativo já estiver na versão mais recente, escreva por Ajuda e Feedback → Contatar e informe o código.

Até lá, uma transmissão pública continua sendo encontrada e o chat dela continua sendo lido, desde que o aplicativo já conheça o seu canal. Enviar mensagens em seu nome, transmissões que só podem ser vistas pelo link e a moderação que não passa pelo bot não funcionam.

Super Chats, stickers e assinaturas de canal

Eles chegam só durante uma transmissão ao vivo, pelo chat que o módulo está lendo.

• Super Chats e Super Stickers entram como doações, na moeda em que o espectador pagou, e são convertidos para a sua moeda base como qualquer outra doação. Nas listas que escolhem quais doações contam, como Contar doações de em uma meta de arrecadação, eles são a fonte YouTube Super Chat: se uma meta ignora os Super Chats, confira se essa fonte está marcada ali.
• Se o aplicativo não reconhece a moeda escrita em um Super Chat, o valor chega com moeda desconhecida, o console de logs diz "Superchat currency not recognised", e uma meta de arrecadação não consegue convertê-lo, então ele não move a meta.
• Assinaturas de canal (memberships), incluindo as de presente, entram como inscrições, não como doações, então não movem uma meta em dinheiro.

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 forma de entrada, e também é como um login expirado é renovado.
• Nome da Conta (login) não pode ser digitado. Para conectar um canal diferente, faça login com a conta que o possui.
• A página não mostra uma lista de permissões por recurso — o YouTube entrega seu conjunto no login e a página relata apenas se a conta está conectada.
• As chaves do app que o Google recusou não podem ser trocadas nesta página: não há campos para elas.
• Não há campos Google Client ID e Google Client Secret — como o módulo diz, "a autorização passa pelo próprio aplicativo strAImer, nenhuma chave necessária".
• A página não tem botão Salvar: tudo é armazenado no final do login do navegador.
• Uma transmissão não pode ser escolhida aqui, e nada na página inicia uma. A página não tem campo para um endereço de transmissão ou um link de vídeo.
• A página não desconecta a conta nem exclui a conexão, e não desliga o módulo.
• O canal e a conta do bot são configurados separadamente: um login não preenche o outro, e eles usam janelas diferentes — o canal faz login através do navegador, o bot dentro do aplicativo.
• O canal do bot não pode ser digitado. É escolhido da lista que a janela de login mostra, e apenas canais da conta com a qual você fez login estão nela.
• Nada na página avisa que as mensagens automáticas estão sendo recusadas. O selo do canal continua verde: ele informa a conexão do canal, não a do bot. Só o console de logs diz por que o YouTube ficou calado.