Mensagem automática sobre o início da stream no Discord com menção ao cargo
Do que é composto o anúncio automático de stream
O anúncio automático é composto pela fonte do evento, pela ferramenta de entrega e pelo canal do Discord. A plataforma ou serviço registra que o canal entrou ao vivo. O bot ou o script de automação coleta o link, o título e outros dados da transmissão. Em seguida, o Discord recebe uma mensagem no canal e menciona o cargo dos espectadores que se inscreveram para receber notificações.
O próprio Discord não monitora o início de transmissões em nenhuma plataforma sem uma integração externa. Um bot pronto serve para a integração padrão com um serviço compatível. O webhook é indicado quando você precisa de um modelo próprio, de condições adicionais ou de uma plataforma que o bot não oferece. A desvantagem do webhook é que ele ainda precisa de uma fonte do evento.
Crie um cargo separado para as notificações
Não use para os pings o cargo de moderadores, parceiros, boosters ou de todos os membros do servidor. Crie um cargo separado com um nome claro: por exemplo, «Streams» ou «Notificações de transmissão». Ele deve ser atribuído apenas aos espectadores que concordam com os anúncios. Assim, uma transmissão iniciada por acaso não vai virar um ping em massa no servidor.
Nas configurações do cargo, você pode escolher a cor e o ícone, mas para a automação o mais importante é o identificador dele. Ative o modo desenvolvedor do Discord, clique com o botão direito no cargo e copie o ID. Ele será necessário para o webhook e para alguns serviços. Não publique o ID como se fosse um segredo: por si só, ele não dá acesso ao servidor.
Configure a atribuição do cargo aos espectadores
Em um servidor pequeno e fechado, o cargo pode ser atribuído manualmente. Essa opção não exige configuração adicional, mas escala mal: será preciso responder a cada novo membro individualmente. Se o cargo for removido com pouca frequência, os moderadores também continuam recebendo pedidos extras para desativar as notificações.
Para um servidor aberto, é mais prático usar um botão, uma reação ou um menu de cargos por interesse. O próprio membro ativa e desativa as notificações. A desvantagem desse método é que é preciso um bot ou o sistema de cargos integrado, e as permissões dele devem ser restritas. A ferramenta de atribuição não deve permitir que o usuário obtenha um cargo de moderador ou administrativo.
Prepare um canal fechado para os anúncios
Crie um canal separado, por exemplo «anúncios-de-streams». Normalmente, os membros comuns mantêm a permissão de ver o histórico e reagir, mas não de enviar mensagens. Assim, o link da transmissão não se perde entre as discussões. Para perguntas, clipes e conversas, é melhor usar um canal de texto vizinho ou threads.
O bot ou o webhook precisa de permissões para ver o canal, enviar mensagens e inserir links. Se o anúncio tiver capas ou arquivos, será necessária a permissão para anexos. Verifique as permissões especificamente no canal de anúncios: elas podem ser diferentes das permissões do servidor por causa de substituições para o cargo ou a categoria.
Escolha um bot de notificações da plataforma de streaming
Para a Twitch, você pode usar o Streamcord: o bot monitora o status do canal escolhido e publica uma notificação no Discord. Nas configurações da notificação, indica-se o canal de destino, conecta-se a conta da Twitch e define-se o modelo da mensagem. Os campos disponíveis, comandos e aparência dependem da versão atual do bot e do plano dele.
Ao configurar o modelo, adicione a menção ao cargo no formato <@&123456789012345678>, em que o número deve ser substituído pelo ID do cargo de notificações. Não é o texto «@Streams», mas sim a menção interna do Discord. A desvantagem de um bot pronto é que você depende das plataformas compatíveis, dos modelos dele, dos limites e das condições de acionamento disponíveis.
Verifique as permissões do bot para mencionar o cargo
Uma mensagem com o formato <@&ID_DO_CARGO> pode chegar ao canal, mas não gerar ping se o bot não tiver permissão para mencionar cargos. Nas permissões do cargo do bot ou nas configurações do canal, verifique a permissão para mencionar everyone, here e todos os cargos. Não conceda essa permissão a um grande número de membros comuns.
A opção «Permitir menção» no próprio cargo o torna disponível para menções por usuários comuns. Às vezes isso é prático, mas cria o risco de spam manual. Se apenas o bot com as permissões necessárias envia os anúncios, normalmente não é preciso abrir o cargo para todos os usuários. A desvantagem de um esquema mais restrito é que, ao trocar de bot, as permissões terão de ser verificadas novamente.
Configure um webhook do Discord para o seu cenário
O webhook é criado nas configurações de integrações do canal do Discord desejado. Após a criação, o Discord mostrará a URL para a qual o serviço externo ou o seu handler envia uma requisição POST. A URL do webhook equivale ao acesso de publicação: não a inclua em capturas de tela, repositórios públicos, documentação e mensagens em chats abertos.
O webhook não monitora a Twitch, o YouTube ou outra plataforma por conta própria. Ele apenas recebe uma requisição pronta e a publica no Discord. Por isso, o esquema funciona assim: a plataforma envia o evento ao serviço de automação ou ao seu handler, e este chama o webhook. A desvantagem é que será preciso configurar o evento, a autorização e o tratamento de requisições repetidas.
Passe o cargo via content e allowed_mentions
Para o webhook, não basta indicar o cargo apenas no campo content. É preciso limitar separadamente as menções permitidas via allowed_mentions. Isso protege contra um ping acidental de @everyone, @here ou de outro cargo, caso um texto externo entre no título da transmissão, na descrição ou no modelo.
Exemplo de corpo JSON para o Discord webhook com menção a um cargo:
{"content":"<@&123456789012345678> A stream começou: montando o ranking ao vivo\\nhttps://twitch.tv/your_channel","allowed_mentions":{"parse":[],"roles":["123456789012345678"]}}
No content, o cargo é indicado como <@&ID_DO_CARGO>, e em allowed_mentions passa-se apenas o número, sem os símbolos. O valor "parse":[] proíbe a interpretação automática de todos os tipos de menção. O array roles permite o ping apenas do cargo específico. A desvantagem do JSON manual é que um erro em uma aspa, parêntese ou ID impedirá o envio ou desativará a menção.
Monte a integração entre Twitch, serviço e canal do Discord
Uma opção funcional sem servidor próprio: Twitch → Streamcord → canal «anúncios-de-streams». Conecte o canal da Twitch ao Streamcord, escolha o canal de destino, ative as notificações apenas para o início efetivo da transmissão e adicione <@&ID_DO_CARGO> ao modelo. Depois, conceda ao bot permissão para escrever nesse canal e mencionar o cargo necessário.
A opção com webhook funciona assim: Twitch EventSub → serviço de automação ou seu handler → Discord webhook → canal «anúncios-de-streams». O handler recebe o evento de início da transmissão, obtém o link atual e envia o JSON com content e allowed_mentions. A desvantagem do EventSub e de um handler próprio é que é preciso manter as inscrições em eventos, os tokens e a disponibilidade do endpoint.
Configure a condição para o início efetivo da transmissão
Não vincule o anúncio apenas ao horário da programação, à criação de um evento ou à mudança do título da transmissão. O streamer pode se atrasar, adiar a transmissão, fazer um teste técnico ou cancelar o início. O espectador receberá o ping, clicará no link e verá uma página offline, o que reduz a confiança nas notificações.
A condição deve se basear no status «ao vivo» ou em um evento específico de início da transmissão. Se o serviço enviar vários eventos, adicione um filtro: publicar o anúncio apenas na transição de offline para live. A desvantagem dessa verificação é que, com dados instáveis da plataforma, a notificação às vezes chega com atraso.
Proteja o canal contra anúncios repetidos
A repetição ocorre após a reinicialização do bot, uma falha temporária da API, uma nova entrega do webhook ou uma mudança de categoria durante a transmissão. Para um bot pronto, verifique se existe uma configuração de proteção contra duplicatas. Se for usada automação, salve o ID da transmissão atual ou a combinação do ID do canal com o horário da primeira notificação.
Não defina uma proteção baseada apenas em um intervalo de tempo muito curto. Se a transmissão cair e realmente for iniciada de novo, os espectadores podem precisar de um novo anúncio com um novo link. É mais confiável comparar o identificador da transmissão. A desvantagem dessa abordagem é que será preciso entender qual campo a plataforma considera o ID único da transmissão.
Deixe o modelo da mensagem curto e útil
No anúncio, basta o cargo, um sinal claro de início, o tema e o link. Se a integração enviar o nome do jogo, a categoria ou a capa, eles podem ser adicionados, mas não copie a descrição inteira do canal e o conjunto de hashtags. No Discord para celular, uma postagem longa ocupa a tela, e o link da transmissão fica menos visível.
Formato básico: <@&ID_DO_CARGO> A transmissão começou — [tema]. Assistir: [link da transmissão atual]. Pegue o link do evento da plataforma ou da variável da integração, e não o insira manualmente. O ping deve levar a uma transmissão ativa, e não a um VOD antigo, à página de programação ou a outro canal.
Verifique se o anúncio funcionou
- O participante de teste tem o cargo de notificações, e o segundo participante não tem.
- O bot ou o webhook vê o canal de anúncios e consegue enviar uma mensagem nele.
- A mensagem usa o formato <@&ID_DO_CARGO>, e o ID corresponde ao ID do cargo criado.
- Para o webhook, allowed_mentions contém o array roles com esse mesmo ID, e parse está vazio.
- O bot tem permissão para mencionar cargos no canal específico, e não apenas nas permissões gerais do servidor.
- O teste gera um único anúncio, o cargo recebe o ping, e o usuário sem o cargo não recebe a notificação.
- O link da mensagem abre a transmissão atual no computador e no aplicativo para celular.
Restrinja o acesso à integração e às chaves
Tokens de bots, chaves de API, segredos do EventSub e URLs de webhooks permitem ler dados ou enviar mensagens em nome do seu canal. Armazene-os nas configurações do serviço, em variáveis de ambiente ou em um gerenciador de segredos fechado. Se a URL do webhook cair em mãos erradas, exclua o webhook e crie um novo.
Deixe o acesso à edição da automação com o dono do servidor e com algumas pessoas responsáveis pela parte técnica. Um acesso amplo demais aumenta o risco de alterar por acidente o cargo, o canal ou a condição de envio. Uma restrição rígida demais também tem uma desvantagem: se não houver um administrador disponível, não haverá quem corrija uma falha.
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










