Publicação automática de novos clipes da Twitch no Discord via EventSub
Para quem é indicada a postagem automática de clipes da Twitch no Discord
A integração nativa entre Twitch e Discord ajuda a exibir o status da live, atribuir cargos e avisar sobre o início da transmissão. Normalmente, ela não publica novos clipes automaticamente em um canal de texto. Para isso, é necessário um bot pronto, um serviço de automação ou uma integração própria entre Twitch EventSub e Discord webhook.
Soluções prontas são adequadas quando não é preciso desenvolver: você conecta a Twitch e o Discord, escolhe o canal e configura um modelo. Antes de iniciar, verifique se o serviço reage especificamente à criação do clipe, e não apenas ao início da transmissão. A desvantagem das soluções prontas é a dependência de planos, filtros disponíveis e formatação das mensagens.
Escolha o esquema de publicação antes de configurar a Twitch
Para um teste rápido, crie um canal privado no Discord e teste alguns clipes manualmente. Isso ajuda a observar atrasos, verificar o cartão do link e entender se chegam mensagens sobre clipes que não deveriam ser publicados na comunidade.
- Um bot pronto se conecta mais rápido, mas pode não oferecer suporte às condições de publicação necessárias e ao formato de embed desejado.
- Um construtor de automações permite adicionar ramificações e filtros, mas parte dos gatilhos e ações pode ser limitada pelo plano do serviço.
- Um manipulador EventSub próprio oferece controle sobre a fila, o modelo, os logs e a proteção contra duplicatas, mas exige servidor, OAuth e manutenção do código.
Defina antecipadamente a regra: publicar todos os clipes, apenas clipes do proprietário do canal, clipes de moderadores ou links após aprovação manual. A desvantagem da filtragem rigorosa é que um momento bom criado por um espectador pode ficar sem publicação.
Crie um Discord webhook para o canal de clipes
O webhook é criado nas configurações do canal de texto desejado no Discord. Para isso, são necessárias permissões de gerenciamento de webhooks. Ele envia mensagens com o nome e o avatar definidos, portanto, uma conta separada no Discord não é necessária para a publicação básica.
- Abra as configurações do canal de texto para onde os clipes serão enviados.
- Vá para a seção de integrações e localize o webhook.
- Crie um novo webhook, defina um nome claro e, se necessário, faça upload de um avatar.
- Copie a URL e salve-a em uma variável de ambiente ou em um armazenamento seguro.
- Envie uma mensagem de teste para o canal privado.
A URL do webhook é um segredo. Quem obtiver esse link poderá enviar mensagens ao canal em nome do webhook. Não adicione o endereço a um repositório público, a capturas de tela do painel ou ao código do cliente. Em caso de vazamento, exclua o webhook e crie um novo: alterar a URL do endereço antigo não é suficiente.
Conecte o evento de criação de clipe via Twitch EventSub
No esquema próprio, a Twitch envia o evento channel.clip.created para o endereço HTTPS do seu manipulador. O manipulador valida a requisição, salva os dados do clipe, monta a mensagem e a encaminha ao Discord webhook. A conta da Twitch, nesse caso, não obtém acesso ao servidor do Discord.
Para a assinatura, será necessário um aplicativo da Twitch, o ID do canal, a callback URL e uma autorização adequada ao tipo de evento escolhido. Os requisitos de token e permissões devem ser conferidos na documentação atual do EventSub: eles podem mudar. Não use parâmetros de autorização de exemplos antigos sem verificar.
O token de usuário do proprietário do canal pode expirar ou ser revogado. A desvantagem desse esquema é que o refresh token precisa ser armazenado com segurança e o acesso renovado a tempo. Se a renovação não funcionar, a assinatura ou a criação de novas assinaturas pode parar de funcionar sem um erro visível no Discord.
Prepare um endereço HTTPS para as notificações da Twitch
A callback URL deve estar acessível pela internet via HTTPS. Ao criar a assinatura, a Twitch envia uma requisição de verificação com o tipo webhook_callback_verification. O servidor deve confirmar a autenticidade da requisição e retornar o valor challenge em texto simples. Enquanto essa etapa não for concluída, a assinatura não ficará ativa.
Os eventos reais chegam com o tipo notification. É melhor responder rapidamente com um HTTP de sucesso e encaminhar a publicação para uma fila ou um manipulador separado. Se você esperar a resposta do Discord dentro da requisição EventSub, o atraso de rede aumenta o risco de reenvio da notificação.
Para desenvolvimento local, é possível usar um túnel HTTPS. A desvantagem é que o endereço público pode mudar após uma reinicialização. O túnel é útil para testes, mas não substitui um endpoint permanente para uma automação em produção.
Verifique a assinatura com base no corpo original da requisição
A assinatura do EventSub é construída a partir do ID da mensagem, do horário de envio e do corpo original da requisição HTTP. Primeiro, obtenha os bytes do body, salve-os sem alterações e só então verifique o HMAC. Não é possível analisar o JSON e montá-lo novamente antes de verificar a assinatura. A ordem dos campos, os espaços ou a codificação podem mudar, e a assinatura calculada não coincidirá.
Para a verificação, são necessários os cabeçalhos Twitch-Eventsub-Message-Id, Twitch-Eventsub-Message-Timestamp e Twitch-Eventsub-Message-Signature. A string para o HMAC SHA-256 é montada assim: messageId + timestamp + rawBody. Como chave, usa-se o segredo definido na criação da assinatura. O resultado em formato hexadecimal é comparado com o valor do cabeçalho, que começa com sha256=.
No Node.js, a lógica é a seguinte: crie um HMAC SHA-256 com o segredo da assinatura, passe messageId + timestamp + rawBody, adicione o prefixo sha256= ao hash e compare com Twitch-Eventsub-Message-Signature usando crypto.timingSafeEqual. Antes da comparação, verifique se as strings têm o mesmo comprimento, caso contrário a comparação segura retornará erro.

Verifique o tipo de mensagem e o horário de envio
A verificação HMAC é necessária para cada requisição EventSub, incluindo callback verification, notification e revocation. Somente após a verificação bem-sucedida, leia o JSON e determine o tipo de mensagem pelo cabeçalho Twitch-Eventsub-Message-Type. Para a verificação de callback, retorne o challenge; para notification, crie uma tarefa de publicação; para revocation, registre no log o motivo da desativação da assinatura.
Além disso, compare o horário de Twitch-Eventsub-Message-Timestamp com o horário atual do servidor. Uma janela de recebimento limitada ajuda a descartar requisições antigas reenviadas por terceiros. Essa verificação não substitui o HMAC: o timestamp pode ser lido da requisição, mas sem o segredo não é possível criar uma assinatura válida.
Armazene o segredo da assinatura separadamente do código e da URL do Discord webhook. A desvantagem de trocar o segredo com frequência sem um procedimento de atualização é que a assinatura existente deixará de passar na verificação. Primeiro, crie ou atualize a assinatura; depois, troque o segredo no manipulador.
Não publique o mesmo clipe duas vezes
O EventSub pode entregar a mesma notificação novamente se o endpoint demorou a responder, se a conexão caiu ou se ocorreu um erro de rede. Salve o Twitch-Eventsub-Message-Id em um banco de dados persistente com índice único. Se esse ID já foi processado, não crie uma segunda tarefa e retorne uma resposta de sucesso.
Adicione uma segunda chave única baseada no ID do clipe dos dados do evento. Isso protege contra publicação duplicada quando o mesmo vídeo chega em notificações diferentes ou quando a tarefa foi reiniciada após uma falha. Primeiro, tente gravar o clip_id na tabela de clipes publicados e só depois de gravar com sucesso envie a mensagem ao Discord.
Esse esquema tem uma desvantagem: uma falha entre a gravação do clip_id e o envio do webhook pode deixar o clipe marcado como publicado sem mensagem no Discord. Para esses casos, armazene o status da tarefa: criada, enviando, publicada, erro. Tarefas com status de erro podem ser repetidas manualmente ou conforme as regras da fila.
Monte a mensagem embed para o Discord
Na mensagem, é útil incluir o título do clipe, o nome do autor, o nome do canal, a categoria e o link direto. Não insira o texto da Twitch no JSON manualmente por concatenação de strings: aspas e caracteres especiais podem quebrar a requisição. Monte o objeto com os recursos da linguagem e envie-o como JSON.
O modelo de embed pode ser assim: título «Novo clipe no canal», descrição «Autor: {creator_name}», URL «{clip_url}», campo «Título» com o valor «{clip_title}», campo «Categoria» com o valor «{game_name}». Se o evento não tiver categoria ou nome do autor, deixe o campo vazio ou não o adicione.
É possível adicionar uma menção de cargo, mas não a envie em cada clipe sem restrições. A desvantagem das notificações constantes é que os membros do servidor começarão a silenciar o canal ou o cargo. Para um canal ativo, é melhor publicar clipes sem ping ou mencionar o cargo apenas por uma regra específica.
Teste o cenário antes de publicar no canal principal
Primeiro, use um canal de teste no Discord e crie alguns clipes com títulos, autores e categorias diferentes. Verifique se o callback verification passa, se a assinatura é validada antes da análise do JSON, se aparece um único cartão por clip_id e se a mensagem não é publicada quando o EventSub entrega novamente.
- Verifique se o servidor lê o raw body antes do parser JSON ou salva os bytes originais da requisição.
- Confirme se o challenge é retornado somente após a verificação bem-sucedida de Twitch-Eventsub-Message-Signature.
- Teste o tratamento de erro do Discord webhook e a repetição da tarefa sem criar uma segunda mensagem.
- Confira os logs por message ID, clip_id, tipo de mensagem EventSub e status de envio.
Não registre nos logs o segredo da assinatura, os tokens OAuth e a URL completa do Discord webhook. Para diagnóstico, basta o ID do evento, o ID do clipe, o código de resposta do Discord e o texto do erro técnico sem cabeçalhos confidenciais.
Last Articles
O que mudou no design e na funcionalidade Atualizamos o site para que trabalhar com ele seja mais rápido e prático. As principais mudanças envolvem a..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. Use o código promocional "December2025" para 15% de desconto para todos os nossos espectadores2. Reduzimos até 1º de janeiro os preços básicos do n..
Os Serviços Twitch são trabalhando estavelmente, assim que nós estamos prontos para cooperar com os esquadrões, revendedores, proprietários de ser..
Nós atualizamos completamente nossos serviços de visualizador do Twitch, e eles estão agora trabalho estável. Usamos apenas endereços IP de alta q..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
Devido à enorme popularidade dos serviços de parceria e programa de indicação, fizemos uma tabela de cooperação. A essência é muito simples: mais públ..
Nossos Serviços para Streamers
Nossos Serviços para Criadores de Conteúdo










