Configuração do Twitch e EventSub

Escolha um modo de fonte do Twitch

Modo	Mais indicado para	Diferença importante
Standard	Captura básica do chat público a partir de uma página de chat do Twitch ou de chat em janela separada.	Lê o que a página disponibiliza. É simples, mas não fornece o conjunto completo de eventos do EventSub.
WebSocket / EventSub	Novos seguidores, inscrições, bits, recompensas, raids, status da transmissão, Trens do Hype, sincronização de moderação, envio de chat e detalhes do canal.	Exige OAuth do Twitch. Os eventos só são ativados quando a conta conectada, a função no canal, a elegibilidade do canal e o escopo concedido permitem.

Configuração do aplicativo para desktop

Selecione Adicionar fonte → Twitch.
Digite o login do canal do Twitch usado na URL. Para twitch.tv/examplechannel, digite examplechannel.
Deixe WebSocket selecionado para a fonte EventSub mais completa. Atualmente, o Twitch usa esse modo por padrão no aplicativo.
Selecione Ativar fonte (Activate source), depois Entrar no Twitch.
Autorize as permissões solicitadas e mantenha a janela da fonte do Twitch aberta.

Tela de login da fonte do Twitch com os métodos Navegador externo e Aplicativo local — A fonte para desktop oferece um fluxo OAuth em navegador externo e um fluxo no aplicativo local. O navegador externo costuma ser a opção mais fácil quando o Twitch já funciona no seu navegador normal.

Configuração do EventSub na extensão do navegador

Instale e ative a extensão atual do Social Stream Ninja.
Abra: Página da fonte Twitch EventSub.
Substitua examplechannel na URL pelo login do canal que deseja monitorar.
Selecione Entrar no Twitch e aprove o acesso solicitado.
Mantenha essa página aberta. Confirme que os campos User e Channel estão corretos antes de testar alertas.

https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN

Para usar a captura básica Standard, abra a página normal de chat do Twitch ou o chat em janela separada e mantenha o chat visível.

O que o Twitch solicita

O Social Stream solicita um token de usuário com as permissões necessárias aos controles e às assinaturas que suporta. Conceder um escopo não torna uma conta dona do canal ou moderadora; o Twitch ainda verifica a função da conta no canal selecionado.

Grupo de permissões	Usado para
Chat	Ler o chat, enviar mensagens e listar participantes.
Seguidores e inscritos	Eventos de seguidores, inscritos, inscrições presenteadas e mensagens de renovação.
Bits, recompensas e Trens do Hype	Cheers, resgates de recompensas personalizadas de Pontos do Canal e status do Trem do Hype.
Moderação	Exclusão de mensagens, banimentos/suspensões temporárias e sincronização de bloqueios quando a conta tem permissão para moderar o canal.
Gerenciamento do canal	Ler/atualizar título e categoria, ler/gerenciar anúncios e exibir métricas do canal.

Veja a documentação oficial do Twitch: referência de escopos e tipos de assinatura do EventSub.

Eventos tratados pela fonte atual

Seguidores: new_follower.
Inscrições: new_subscriber, resub, e subscription_gift.
Bits: cheer com um valor de doação.
Pontos do Canal: reward.
Raids: raid.
Status da transmissão e dos anúncios: stream_online, stream_offline, e ad_break.
Trem do Hype: hype_train atualizações de início, progresso e fim.
Moderação: atualizações de banimentos e exclusões de mensagens quando permitido.

Os eventos de inscritos do Twitch exigem um canal Afiliado/Parceiro elegível e acesso como dono do canal. As assinaturas de seguidores e moderação exigem que o usuário conectado seja o dono do canal ou um moderador autorizado, dependendo do evento.

Para os nomes de alertas usados pelos consumidores e os campos do payload, use o guia de compatibilidade de eventos e alertas e Referência de eventos.

Primeiras verificações quando um evento está ausente

Confirme que a página da fonte mostra os valores corretos de Usuário e Canal.
Mantenha a página/janela da fonte aberta e confirme que a conexão do chat está ativa.
Se o chat funcionar, mas seguidores/inscrições/recompensas não, saia e autorize novamente para conceder os escopos atuais.
Verifique se a conta conectada é a dona do canal ou uma moderadora com as permissões necessárias.
Verifique se o dock e a sobreposição de alertas usam o mesmo ID de sessão do Social Stream.
Use a mensagem de teste fictícia do popup ou a prévia do Multi Alerts para separar problemas de captura de problemas de sobreposição.

O EventSub pode entregar uma notificação mais de uma vez. O Twitch documenta a entrega pelo menos uma vez. O Social Stream inclui proteção contra duplicações, mas consumidores de API personalizados devem eliminar duplicatas pela identidade do evento/mensagem sempre que possível. Veja a documentação oficial visão geral do EventSub.