Gestor de Canais

Um funcionário que acompanha seus canais do YouTube todo dia e só chama você quando algum vídeo foge do padrão do próprio canal.

Pra que serve

O Gestor de Canais lê os números dos canais conectados pela API oficial do YouTube, guarda tudo no YouFlow e compara cada vídeo com os outros vídeos do mesmo formato no mesmo canal. Quando um vídeo fica bem abaixo do padrão (título e thumbnail não convencem, a audiência abandona cedo, as views despencam, a descrição está incompleta), ele abre um achado com a evidência e a ação recomendada.

Ele ajuda de três formas:

Você não precisa abrir o YouTube Studio todo dia. A home mostra a saúde de cada canal e o que precisa de você.
Ele compara com o padrão do seu canal, não com a média do YouTube. Um Short é comparado com os outros Shorts do canal; um vídeo longo com os longos.
Ele explica. Todo número diz de quando é, toda cor diz por quê, todo achado traz a evidência.

Quem pode acessar

Plano necessário: o módulo é liberado por workspace (fale com a Y4Y).
Perfis: dono e administrador fazem tudo (inclusive enviar alterações pro YouTube); gerente vê, opera (analisar agora, bloquear vídeo, vincular, dispensar) e usa IA; colaborador só vê.

Como chegar

Menu lateral, seção Gestão de Canais: Canais (o cadastro e o Gerenciar de cada canal, pra todo mundo) e, com o módulo ligado, Painel, Vídeos e Histórico. O Gestor é um serviço dentro da gestão de canais: a configuração do agente fica em Canais > Gerenciar > aba Agente, e a conexão com o Google, na aba Geral ou no card do canal.

O Gestor não tem seletor de canal próprio: quem manda é o seletor de canal do topo do sistema, o mesmo de todo o YouFlow. Com "Todos os canais" no topo, o Painel é a visão geral do workspace; com um canal escolhido, é o painel daquele canal, e Vídeos e Histórico seguem o mesmo canal. Clicar no card de um canal no Painel escolhe o canal no topo.

Telas

Como as telas se organizam (Como está, O que fazer, Números)

Toda tela do Gestor responde três perguntas, nessa ordem:

Como está. Frases com semáforo, sem número solto. Na home, um card por canal: a frase geral (verde, amarelo ou vermelho) e uma linha por tipo de conteúdo ("Vídeos longos no normal: nenhum pedindo ação", "1 Short com poucos cliques na thumbnail", "Ainda sem base: 2 de 3 lives com dado"). No vídeo, três linhas: Mostrado (quantas vezes o YouTube mostrou), Clicam (quantos clicaram, contra o normal dos vídeos do mesmo tipo) e Assistem (quanto assistem, mesma comparação).
O que fazer. O que pede sua decisão: cada achado com a ação em destaque e um botão (Dispensar, Aprofundar com IA), os lançamentos em andamento e, na home, a lista com filtro por tipo e por categoria. "Nada pendente de você" quando está tudo no normal.
Números. Recolhido por padrão (clique em "Números" pra abrir; a escolha fica lembrada): cards do período, gráfico, "Por tipo de conteúdo", vídeo mais recente, a tabela de vídeos e a Inteligência do canal.

As palavras da tela são as do dia a dia, com o termo técnico entre parênteses: cliques na thumbnail (CTR), quanto assistem (retenção), vezes que o YouTube mostrou (impressões), o normal dos seus Shorts (mediana), certeza (confiança). As categorias de achado são Thumbnail e título, Quanto assistem, Perdendo força, Descrição e Lançamento. Os modos do agente são Só me avisar, Propor e enviar com minha aprovação e Agir sozinho (em breve).

Painel (home)

Com "Todos os canais" no topo:

Indicadores do topo (no mesmo estilo do dashboard): canais conectados, vídeos monitorados, hora da última análise e quantas coisas precisam de você (clique nele pra descer até elas). São números do agente, nunca a soma de views de canais diferentes (a política da API do YouTube proíbe somar canais de donos diferentes).
Precisam de atenção / Últimos publicados: uma área só, em abas. A primeira lista os achados abertos, do mais grave pro menos grave, com o que fazer e quando foi encontrado; a segunda, os vídeos mais recentes do workspace, com data, views 28d, retenção e status (vídeo com menos de 48 h mostra o estado do lançamento no lugar do status, veja abaixo). As duas têm miniatura, a foto do canal (passe o mouse pra ver nome, inscritos e o link pro painel dele), busca, filtro de categoria ou de status, ordenação pelo cabeçalho e paginação de 6 em 6.
Canais conectados: um card por canal (deslize ou use as setas quando não couberem): avatar, inscritos, o selo de saúde (passe o mouse pra ver os motivos), a linha de views do período com a variação contra o período anterior, o motivo principal quando não está verde, e o botão Agente ligado / pausado. Pausar o agente para as análises daquele canal (e os alertas dele) sem desconectar nada; dono e administrador mexem, os outros só veem o estado. Clicar no card escolhe o canal no topo e abre o painel dele.
Relatórios prontos: os relatórios automáticos em rascunho, pra revisar e enviar.

Com um canal escolhido no topo, o Painel mostra direto o painel daquele canal (veja "Canal" abaixo) e os relatórios em rascunho dele. Canal cadastrado que ainda não foi conectado mostra o botão pra conectar em Gerenciar.

O que é um canal saudável

Cor	Significa
Verde (Saudável)	Dados em dia (chegaram nos últimos 3 dias), nenhum achado crítico aberto e views em pelo menos 80% do período anterior
Amarelo (Atenção)	1 achado crítico aberto, ou views caíram entre 20% e 50%, ou os dados pararam há 4 dias ou mais, ou o Analytics não respondeu
Vermelho (Crítico)	Precisa reconectar, ou 2 ou mais achados críticos, ou views caíram mais de 50%, ou os dados pararam há 10 dias ou mais
Cinza (Aguardando dados)	Canal recém-conectado, o agente ainda não guardou a série diária

A comparação de views usa o período escolhido no seletor (7, 28 ou 90 dias). Os limiares completos estão em docs/agente/regras-e-indicadores.md.

Por que os dados terminam 2 ou 3 dias antes de hoje

O YouTube não fecha os números do dia na hora: entrega cada dia com 1 a 3 dias de atraso e ainda revisa os 2 mais recentes. O agente pede até ontem, mostra o que já chegou e pinta esses dias tracejados no gráfico, avisando "os últimos N dias ainda são parciais". "Dados consolidados até DD/MM" é o último dia que não muda mais. O YouTube Studio faz a mesma coisa.

O CTR e as impressões vêm de outra fonte (Reporting API), que chega com 2 a 3 dias de atraso e só começa ~48 horas depois de conectar o canal. Por isso o card de CTR diz "de DD/MM a DD/MM": é o intervalo que realmente tem dado.

Lançamentos (primeiras 48 h e fechamento)

O YouTube só entrega rápido as views do vídeo. Então, nas primeiras 48 h, o agente lê as views 3 vezes por dia (6h10, 11h e 17h) e compara com o que os lançamentos anteriores do canal, do mesmo formato, fizeram na mesma idade. Não existe uma lista separada: enquanto o vídeo está na janela, o status dele nas tabelas (home, painel do canal e Vídeos) vira o estado do lançamento: Lançamento: acima do padrão, no padrão, abaixo do padrão, muito cedo (menos de 6 h) ou ainda sem base. Passe o mouse na pílula pra ver a frase completa ("1.240 views em 25 h. Mediana dos lançamentos do mesmo formato nessa idade: 900 (+38%)"). O cabeçalho da tabela resume: "2 lançamentos em andamento: 1 no padrão, 1 ainda sem base".

Ainda sem base: o agente precisa de 3 lançamentos anteriores do mesmo formato com dados naquela idade; a pílula diz quantos já contam ("base em 2 de 3"). A base se completa sozinha a cada rodada da manhã, com o histórico do canal.
Abaixo do padrão (menos de 80% da mediana) é só o estado. O alerta em "Precisa da sua atenção" abre abaixo de 50%, com a ação "confira CTR e thumbnail no Studio", porque CTR e thumbnail nas primeiras horas só existem lá. Se quiser e-mail na hora, ligue "Alerta de lançamento por e-mail" nas configurações do canal (vem desligado).
Atualizar views: no detalhe do vídeo, lê o YouTube agora (dá pra clicar de novo depois de 10 minutos). Não usa IA.
Fechamento: com 72 h no ar, quando CTR e retenção chegam, o agente fecha o lançamento: views em 48 h, CTR dos 2 primeiros dias e retenção, cada um contra a mediana dos lançamentos anteriores, com um veredito (Lançamento forte, no padrão ou fraco) e uma lição em texto. Fica no detalhe do vídeo e, por 7 dias, vira o status do vídeo nas tabelas.
Onde ver todos: em Vídeos, o chip Lançamentos lista os vídeos nas primeiras 48 h e os fechados nos últimos 7 dias.

Os 3 primeiros lançamentos de um canal saem como "Primeiros lançamentos": ainda não há base. Lives (vídeo sem duração) ficam fora da comparação.

Canal

Escolha o canal no seletor do topo do sistema (o mesmo de todo o YouFlow) ou clique no card dele no Painel. Pra voltar à visão geral, escolha "Todos os canais" no topo ou o link acima do título.

Frase-título: "Seu canal teve N visualizações nos últimos X dias", com as datas do período e o aviso de dias parciais.
Cards: Visualizações, Tempo de exibição, Inscritos (líquidos: ganhos menos perdidos, por isso fecha com o total do canal) e CTR, todos no período escolhido, comparados com o período imediatamente anterior.
Gráfico: um ponto por dia, com marcadores nos dias em que saiu vídeo (passe o mouse). Troque entre Visualizações, Tempo de exibição e Inscritos.
Precisa da sua atenção: os achados deste canal.
Analisar agora: roda uma análise completa fora do horário (leitura do YouTube, métricas, regras). Use quando acabou de publicar algo ou mudou uma thumbnail.
Gráfico com referências: os chips "pico", "mediana" e "tendência" acima do gráfico ligam e desligam as linhas; os picos do período ficam marcados com bolinhas e o tooltip diz "pico do período". É a mesma conta dos Relatórios.
Receita: só aparece quando há um CSV do YouTube Studio importado com receita (aba Dados de Gerenciar, "Completar com receita"). O agente não lê receita.
Inteligência do canal: no fim do painel, a curva de vida dos vídeos, o melhor dia pra publicar e o benchmark de CTR, calculados sobre os dados do canal sem gastar créditos de IA. Recalcula sozinho a cada rodada e a cada import.

Este painel é a única tela de números do canal: é o mesmo que aparece em Gestão de Canais > Canais > Gerenciar, aba Desempenho. Canal ainda não conectado mostra ali os números do CSV, quando há.

Vídeos

Lista dos vídeos monitorados, seguindo o canal do topo (em "Todos os canais", todos os vídeos do workspace com a foto do canal em cada linha; com um canal escolhido, só os dele): busca pelo título e dropdown de status (com Lançamentos: primeiras 48 h e fechados nos últimos 7 dias), cada opção com a contagem. Clique no cabeçalho "Publicado em", "Views 28d" ou "Retenção" pra ordenar (o padrão é do mais recente pro mais antigo); a lista vem de 20 em 20 com paginação no rodapé. Os status:

Status	Significa
Saudável	Tem dados e nenhum achado aberto
Embalagem	Cliques na thumbnail (CTR) abaixo de 70% do normal dos vídeos do mesmo tipo neste canal: título ou thumbnail não convencem
Retenção	Quanto assistem (retenção) abaixo de 75% do normal dos vídeos do mesmo tipo neste canal: o problema está dentro do vídeo
Tração	Views da última semana caíram mais de 50% contra a semana anterior (só em vídeo com 30+ dias)
Descrição	Descrição curta, sem capítulos ou sem link
Lançamento	Vídeo novo abaixo de 50% do que o canal costuma fazer na mesma idade: confira CTR e thumbnail no Studio
Em alta	Views da última semana 50% acima da semana anterior: o vídeo está subindo e o agente não mexe
Não mexer	Você bloqueou o vídeo: o agente não analisa
Aguardando dados	O YouTube ainda não entregou as métricas deste vídeo

A coluna Retenção mostra com quem o vídeo foi comparado e com quantos ("normal dos seus Shorts 74,3% · 5 vídeos"). Sempre do mesmo tipo: Shorts com Shorts, longos com longos, lives com lives. Com menos de 3 vídeos do tipo com dado aparece "sem base: 2 de 3 vídeos longos com dado", e o agente não abre achado de cliques nem de retenção pra esse vídeo. Nunca cai na mediana do canal inteiro.

Tipo de conteúdo em toda parte. Cada linha (vídeo ou achado) traz o chip do tipo, o mesmo do kanban e do portal: Longo, Shorts ou Live (pela duração que o YouTube informa: até 3 minutos é Short). O filtro Todos os tipos / Longos / Shorts / Lives (com contagem) está na home, em Vídeos e no histórico, e vale junto com a busca e o filtro de status. No painel do canal, o bloco Por tipo de conteúdo mostra, para cada tipo, quantos vídeos são acompanhados (e quantos saíram no período), views 28d, cliques na thumbnail e quanto assistem; visualizações, tempo e inscritos do canal continuam juntos porque o YouTube só entrega assim. O e-mail e o relatório automático também dizem o tipo, e o relatório traz o melhor vídeo por tipo (um Short nunca "vence" um longo).

Detalhe do vídeo

Cards: views totais, views 28d (com a data do snapshot), retenção e CTR 28d comparados com o normal dos vídeos do mesmo tipo neste canal ("Normal dos seus vídeos longos: 41,2% (7 vídeos)"; com menos de 3 do tipo com dado aparece "Sem base: 2 de 3 vídeos longos com dado"), duração média vista.
Views desde a publicação: gráfico por dia, lido do YouTube ao abrir a tela; trecho tracejado ainda em revisão.
Retenção do vídeo: barra com a curva de retenção.
O que o agente encontrou: o achado aberto com resumo, confiança, ação recomendada, categoria e evidências. O resumo diz com quem o vídeo foi comparado e com quantos ("contra 41,2% do normal dos seus vídeos longos (7 vídeos)"), e cada evidência traz a comparação ao lado do número. Shorts, vídeos longos e lives nunca se misturam; sem 3 vídeos do mesmo tipo com dado, o agente não abre achado de cliques nem de retenção. Botões: Aprofundar com IA (3 créditos: leitura do título e do contexto) e Dispensar (o vídeo entra em cooldown de 7 dias).
Controles do dono: "Não mexer neste vídeo" (o agente para de analisar) e "Vincular ao YouFlow", que abre uma janela com busca: digite parte do título e a lista filtra na hora. Começa só com os cards livres do canal do vídeo, na etapa Publicado (o filtro de etapa é multisseleção: dá pra somar Agendado, Revisão etc. ou "Todas"), sempre do mais recente pro mais antigo, carregando mais conforme você rola; "Buscar em todos os canais" amplia. Um clique no card vincula. Depois de vinculado aparecem "Trocar" (escolher outro card) e "Desvincular" (com confirmação; nada é apagado). A maioria dos vídeos vincula sozinha pelo link do YouTube no card; isso é pros que sobram.

Histórico

Três abas: Achados abertos, Rodadas (uma linha por análise, cron ou manual: canal, vídeos avaliados, achados criados, créditos gastos) e Ações no YouTube (cada envio feito pelo card do vídeo: o que foi, quem enviou, quando, o antes e o depois, com Reverter pra dono e administrador). Segue o canal do topo: em "Todos os canais" mostra o workspace inteiro; com um canal escolhido, só o dele.

Enviar o card pro YouTube (Copiloto)

Com o canal conectado com permissão de edição e o agente em modo Copiloto, o card do vídeo (Meus Vídeos > aba Detalhes > faixa "Publicar no YouTube") ganha o botão Enviar pro YouTube: uma comparação "YouTube hoje × YouFlow" de título, descrição, tags e thumbnail, você marca o que vai e envia. Nada é enviado sozinho, campo igual não é enviado, e tudo pode ser revertido (a thumbnail anterior fica guardada). Limites: os do YouTube (título 100, descrição 5.000, tags 500 caracteres; thumbnail JPG ou PNG até 2 MB, e o canal precisa ter thumbnails personalizadas liberadas no Studio) e o teto de envios por dia da configuração do canal.

Liberar a edição: em Gerenciar > Geral (ou em Conexões), o botão Liberar edição no YouTube pede ao Google só a permissão nova; o dono autoriza de novo e a conexão passa a "leitura e edição". Pra canal de cliente, gere o convite marcando "pedir também permissão de edição".
Disponibilidade: liberada por workspace (fale com a Y4Y) enquanto a verificação do escopo no Google não sai.

Conexões e Configurações

Conexões (tela técnica, sem item no menu): o lugar normal de conectar é o card do canal em Gestão de Canais > Canais ("Conectar com Google" ou "Convidar dono") ou a aba Geral de Gerenciar. A tela Conexões continua acessível pelo link "Gerenciar conexões" na home do Gestor: lista as autorizações, o e-mail que consentiu, os convites pendentes, e deixa escolher o canal antes de conectar (ou "Criar a partir do canal autorizado", e o cadastro nasce sozinho). Se o plano estiver no limite de canais, a conexão fica guardada "aguardando vaga" e o agente não lê nada até você vincular a um canal existente ou liberar uma vaga. Desconectar (aqui ou na aba Geral de Gerenciar) apaga tudo que foi espelhado; o cadastro do canal continua. Excluir o canal em Canais desconecta junto.
Dentro de Gerenciar (Gestão de Canais > Canais > Gerenciar): com o Gestor liberado no workspace, o canal ganha duas abas a mais: Agente (a mesma configuração do agente, só deste canal) e Desempenho (o mesmo painel do Gestor, com o seletor de período). Sem conexão, as duas abas mostram o botão de conectar. No painel do Gestor, o botão "Gerenciar canal" leva pra lá.
Configurações do agente (Canais > Gerenciar > aba Agente, do canal escolhido no topo; a engrenagem do painel leva pra lá): três decisões à vista e o resto em Avançado. Visíveis: o que o agente pode fazer (Só me avisar nunca altera nada; Propor e enviar com minha aprovação libera o envio do card pro YouTube depois do seu OK; Agir sozinho ainda não existe), o resumo por e-mail (quando, pra quem), quantos vídeos acompanhar (até 50; a comparação é sempre entre vídeos do mesmo tipo) e o relatório automático. Em Avançado (recolhido): ações permitidas no YouTube (título, descrição e tags, thumbnail) e envios por dia, primeira análise de um vídeo novo, quando o agente analisa (todo dia ou semanal), o que o agente vigia (poucos cliques, assistem pouco, título fora do padrão, descrição incompleta, alerta de lançamento por e-mail), tempo até analisar de novo um vídeo dispensado, limite de créditos de IA por dia e "só me avisar com certeza". O agente ativo/pausado fica no rodapé, ao lado de Salvar.

Relatório automático

Sem importar CSV: o agente monta o relatório do canal com os números que ele já lê do YouTube e grava no módulo Relatórios, igual a um relatório feito na tela (Histórico, link público, editar, enviar).

Ligar: Configurações do agente, "Relatório automático", escolha 7, 15 ou 28 dias. O primeiro sai na próxima análise da manhã; os próximos quando o período seguinte fechar (o YouTube consolida os números com 3 dias de atraso).
Rascunho (padrão): aparece em "Relatórios prontos" na home do Gestor e no Histórico de Relatórios com a etiqueta "Gerado pelo agente". Você revisa o parecer, ajusta o que quiser e envia pela tela, como sempre.
Enviar automaticamente: vai pros destinatários da Config. de Email do módulo Relatórios daquele canal. Sem destinatários cadastrados, fica como rascunho. Nem todo cliente precisa receber: ligue só onde faz sentido.
O que vem dentro: views, horas, inscritos líquidos e a variação contra o período anterior, impressões e CTR, os vídeos do período com views e CTR, gráfico diário, parecer e plano de ação em texto (saúde do canal, achados abertos, lançamentos fechados). Espectadores únicos e receita ficam vazios: a API não entrega. O parecer com IA continua sendo o botão da tela Relatórios.
Plano: vale a mesma regra do módulo Relatórios (plano Agency e a cota de relatórios do plano).

Perguntas frequentes

Os números batem com o YouTube Studio? Sim, para o mesmo intervalo de datas. O Studio inclui o dia de hoje (parcial); o agente termina em ontem. O card de inscritos é líquido (ganhos menos perdidos), como o total do Studio.

Por que um vídeo está vermelho na tabela e não tem achado? A tabela pinta quando a retenção está abaixo da mediana; o achado só abre quando está abaixo de 75% da mediana e com amostra suficiente (50 views). Entre uma coisa e outra, é variação normal.

Por que "Aguardando dados" em vídeo antigo? O snapshot do Analytics só existe para vídeos com atividade nos 28 dias consolidados. Vídeo sem view no período não tem snapshot.

O agente muda alguma coisa no meu canal? Sozinho, não. Ele lê e recomenda. Só altera título, descrição, tags ou thumbnail quando uma pessoa (dono ou administrador) clica em "Enviar pro YouTube" no card do vídeo, com a comparação na frente, num canal conectado com permissão de edição e em modo Copiloto. Tudo fica registrado e pode ser revertido.