Notificações do Twitch

Para que serve

Quem o lê quando a transmissão já acabou não clica e, da próxima vez, nem sequer lê. É aí que anunciar à mão falha: estás no jogo, na conversa, concentrado, e nesse momento ninguém se lembra de escrever uma linha no Discord. O bot fica com esse gesto e cumpre-o sempre. Verifica se o teu canal de Twitch está no ar e publica a mensagem enquanto ela ainda vale alguma coisa, com o título e o jogo do momento.

Como é no dia a dia

Guardas o teu nome de Twitch, escolhes o canal do Discord para o aviso e indicas quem deve ser mencionado ao entrares em direto: um ID de cargo, @everyone, @here ou ninguém. A partir daí corre sem ti. De três em três minutos o bot pergunta ao Twitch e, assim que há emissão, a mensagem está no canal. Título, jogo e espetadores entram no embed através de marcadores: {streamer}, {title}, {game}, {viewers}. Juntam-se o avatar do streamer como imagem pequena, a pré-visualização do direto como grande e um botão que leva direto ao canal. Se mudares de jogo ou de título a meio, o bot atualiza a mensagem já publicada em vez de enviar outra.

Comandos deste módulo

• /social

O que podes configurar

• Canal Twitch
• Canal Discord para aviso de live
• Menção de cargo
• Texto acima do embed
• Título do embed
• Descrição do embed
• Rodapé
• Cor do embed
• Miniatura (avatar do streamer)
• Imagem de pré-visualização grande (stream)
• Mostrar data e hora
• Botão «Ver no Twitch»
• Atualização automática ao mudar título/jogo

A que deves prestar atenção

O ponto mais importante não está no painel: o Twitch só responde se houver credenciais da sua interface guardadas do lado do servidor. Se faltarem, o bot não encontra nada e cala-se; /social status diz-te sem rodeios se existem. Segundo, a menção: um @everyone a cada direto é o caminho mais curto para as pessoas silenciarem o canal. Um cargo que cada um escolhe chega exatamente a quem quer saber. Terceiro, o ritmo: a verificação corre de três em três minutos, portanto o aviso pode chegar alguns minutos depois de ligares. É assim de propósito e não é uma falha; não anuncies também à mão ou ficam os dois lá. E quarto: se a ligação cair a meio e voltares a arrancar, o Twitch conta isso como um direto próprio. O bot avisa então uma segunda vez, porque vê um identificador de emissão novo. Por fim um pormenor de grande peso: se faltar um dos dois campos obrigatórios (nome de Twitch ou canal de destino), o módulo não faz rigorosamente nada, e também não se queixa disso.

Como funciona o módulo

O teu nome de utilizador na Twitch (ou o URL do canal). O bot verifica a cada poucos minutos se este canal está em direto.

Escolhe o canal onde a notificação de direto é publicada (menu suspenso assim que os canais forem carregados).

Texto livre acima do embed (a menção do cargo é adicionada automaticamente antes). Ver marcadores abaixo.

Vazio = título automático. Marcadores: {streamer} {title} {game} {viewers}

Marcadores: {streamer} {title} {game} {viewers} {url} {thumbnail}

Configurado em três passos

1. Ativa o módulo «Twitch» no painel e indica o teu nome de Twitch ou o URL do canal.
2. Escolhe o canal do Discord para o aviso: um de texto ou de anúncios onde o bot possa escrever.
3. Define a menção: escreve um ID de cargo, @everyone ou @here e confirma com Enter, ou deixa vazio.
4. Ajusta o embed a teu gosto e faz um teste com /social test → Twitch Live.

Perguntas frequentes

Corre /social status. Se disser que faltam as credenciais do Twitch, o bot nem sequer consegue perguntar ao Twitch: essas são postas do lado do servidor por quem gere a instância, não por ti no painel. Se, pelo contrário, aparecerem o teu nome e o canal de destino, confirma que é um canal de texto ou de anúncios e que o bot pode escrever lá.

O bot pergunta ao Twitch de três em três minutos. No pior caso passam pouco menos de três minutos entre o arranque e o aviso. Mais depressa não dá, mas acontece sempre e sem tu fazeres nada.

Podes. Título, descrição, rodapé e o texto acima do embed são livres; com {streamer}, {title}, {game}, {viewers}, {url} e {thumbnail} trazes para dentro os dados reais da emissão. Cor, data e hora, avatar, imagem de pré-visualização e o botão ligam-se em separado. Se deixares título e descrição vazios, o bot mete a versão dele.

Não acontece nada. O bot desarma as menções nos valores que vêm de fora, e o título da emissão é um deles. Um @everyone aí continua legível mas não dispara notificação nenhuma. Só toca aquilo que tu próprio indicaste como menção.

Porque não chega mensagem nenhuma se estou em direto?

Corre /social status. Se disser que faltam as credenciais do Twitch, o bot nem sequer consegue perguntar ao Twitch: essas são postas do lado do servidor por quem gere a instância, não por ti no painel. Se, pelo contrário, aparecerem o teu nome e o canal de destino, confirma que é um canal de texto ou de anúncios e que o bot pode escrever lá.

Quanto tempo demora a mensagem depois de ligar?

O bot pergunta ao Twitch de três em três minutos. No pior caso passam pouco menos de três minutos entre o arranque e o aviso. Mais depressa não dá, mas acontece sempre e sem tu fazeres nada.

Posso escrever o texto todo à minha maneira?

Podes. Título, descrição, rodapé e o texto acima do embed são livres; com {streamer}, {title}, {game}, {viewers}, {url} e {thumbnail} trazes para dentro os dados reais da emissão. Cor, data e hora, avatar, imagem de pré-visualização e o botão ligam-se em separado. Se deixares título e descrição vazios, o bot mete a versão dele.

E se alguém puser uma menção no título da emissão?

Não acontece nada. O bot desarma as menções nos valores que vêm de fora, e o título da emissão é um deles. Um @everyone aí continua legível mas não dispara notificação nenhuma. Só toca aquilo que tu próprio indicaste como menção.