Notificações do YouTube

Para que serve

Não perde nada se alguém só o vir à noite, e é precisamente por isso que compensa um aviso que chega sempre em vez de um que às vezes consegues. O que conta no fim é um rasto sem falhas: cada vídeo do teu canal aparece no Discord, com título, miniatura e um botão que leva direto. Quem percorrer o canal mais tarde tem à frente meses de trabalho seguidos. À mão essa série nunca se forma, porque mais cedo ou mais tarde falta um e a falha já ninguém a preenche.

Como é no dia a dia

O que indicas é o canal do YouTube: o mais fiável é o ID de canal que começa por UC; um @identificador ou o URL do canal também servem, o bot resolve ambos sozinho. Depois decides duas coisas em separado: se os vídeos novos são anunciados e se os diretos o são, cada um com o seu canal de destino. Se deixares o canal dos diretos vazio, ambos vão para o mesmo sítio. A mensagem é tua: título teu, descrição tua, rodapé, cor e marcadores como {channel}, {video_title}, {url} e {publish_date}, com a data no formato do idioma definido para o servidor. Podes juntar dois botões: um abre o vídeo, o outro o canal com o pedido de subscrição. Na primeiríssima passagem o bot anota em silêncio o teu vídeo mais recente, para que meio canal não caia de uma vez no Discord.

Comandos deste módulo

• /social

O que podes configurar

• Canal YouTube
• Anunciar vídeos novos
• Anunciar lives
• Canal Discord para vídeos novos
• Canal Discord para lives
• Menção de cargo
• Texto acima do embed
• Título do embed
• Descrição do embed
• Rodapé
• Cor do embed
• Mostrar miniatura
• Imagem de pré-visualização grande (vídeo)
• Mostrar data e hora

A que deves prestar atenção

Há um ponto que merece ser dito às claras antes de estranhares: os vídeos novos o bot tira-os do feed público do teu canal e não precisa de mais nada. Os diretos só os reconhece se houver uma chave do YouTube guardada do lado do servidor; quem a põe é quem gere a instância, no painel não existe campo para isso. Sem ela, o interruptor dos diretos fica sem efeito, e /social status escreve exatamente isso. O segundo obstáculo é o limite de plataforma: sem Premium o bot serve apenas uma das duas. Se configuraste Twitch e YouTube ao mesmo tempo, ganha o Twitch e o YouTube cala-se. Visto de fora parece uma avaria, mas o limite está traçado assim. Quanto à indicação do canal: um @identificador tem de ser resolvido primeiro, e isso pode correr mal se o YouTube servir a página de outra maneira; o identificador UC, esse, aguenta sempre. E nada é anunciado duas vezes: um direto que já saiu como aviso em direto não volta mais tarde como vídeo novo.

Como funciona o módulo

ID do canal (UC…, o mais fiável), @handle ou o URL do canal. O bot resolve automaticamente os handles para o ID do canal.

A deteção fiável de diretos precisa de uma chave de API do YouTube (inserida no servidor pelo operador). As notificações de novos vídeos funcionam sem chave.

Deixar vazio = mesmo canal dos vídeos novos.

Texto livre acima do embed. Ver marcadores abaixo.

Marcadores: {channel} {video_title} {title} {publish_date}

Configurado em três passos

1. Ativa o módulo «YouTube» no painel e indica o ID de canal (UC…), o @identificador ou o URL do canal.
2. Decide se os vídeos novos são anunciados, se os diretos são anunciados ou se ambos.
3. Escolhe o canal de destino para os vídeos novos; preenche o dos diretos só se tiver de ser outro.
4. Ajusta a menção e o embed e dispara uma vez /social test → YouTube Video.

Perguntas frequentes

Para os vídeos novos não: o bot vai buscá-los ao feed público do teu canal. Para os diretos precisas: sem uma chave guardada ele não repara que estás a emitir e o aviso em direto nunca sai. A chave é posta pelo operador do lado do servidor; a partir do painel não há maneira de a introduzir.

Com Premium sim, os dois em paralelo. Sem Premium o bot serve só uma plataforma: se ambas estiverem configuradas, o Twitch tem prioridade e o YouTube fica mudo. Portanto, se um lado avisa e o outro nunca, é daí que vem e não de uma definição errada.

O YouTube não dá um toque ao bot; é ele que vai ver, de três em três minutos. Se o vídeo ainda não estiver no feed, encontra-o na passagem seguinte. Para um aviso de vídeo isso pouco importa: não perde nada por chegar dez minutos mais tarde.

O botão «Subscrever canal» leva ao teu canal e abre logo aí o pedido de subscrição. Liga-se em separado do botão que vai para o vídeo. São dois simples botões de ligação: dentro do Discord não acontece nada quando alguém carrega neles.

Preciso de uma chave de API do YouTube?

Para os vídeos novos não: o bot vai buscá-los ao feed público do teu canal. Para os diretos precisas: sem uma chave guardada ele não repara que estás a emitir e o aviso em direto nunca sai. A chave é posta pelo operador do lado do servidor; a partir do painel não há maneira de a introduzir.

O Twitch e o YouTube funcionam ao mesmo tempo?

Com Premium sim, os dois em paralelo. Sem Premium o bot serve só uma plataforma: se ambas estiverem configuradas, o Twitch tem prioridade e o YouTube fica mudo. Portanto, se um lado avisa e o outro nunca, é daí que vem e não de uma definição errada.

Porque é que o vídeo só chegou minutos depois do carregamento?

O YouTube não dá um toque ao bot; é ele que vai ver, de três em três minutos. Se o vídeo ainda não estiver no feed, encontra-o na passagem seguinte. Para um aviso de vídeo isso pouco importa: não perde nada por chegar dez minutos mais tarde.

Para que serve o segundo botão por baixo da mensagem?

O botão «Subscrever canal» leva ao teu canal e abre logo aí o pedido de subscrição. Liga-se em separado do botão que vai para o vídeo. São dois simples botões de ligação: dentro do Discord não acontece nada quando alguém carrega neles.