Automatizar Upload no YouTube com n8n: Guia Completo 2026
Nota Técnica: Os scripts e configurações mostrados neste guia são para fins educacionais. Teste sempre em ambiente isolado antes de aplicar no seu canal de produção. O autor não se responsabiliza por perdas de dados, quotas esgotadas ou suspensões de conta causadas por uso indevido.
Você tem uma pasta cheia de vídeos e precisa publicar tudo no YouTube — mas fazer isso manualmente, um por um, leva horas e abre espaço para erros: título errado, descrição esquecida, tag faltando. Aqui no @CanalQb, validamos que o n8n self-hosted é a solução mais robusta para automatizar upload de vídeos no YouTube sem pagar por planos premium, sem limite de execuções e com controle total das suas credenciais OAuth2. Neste guia você vai configurar do zero o workflow completo — da autenticação na API do YouTube até as notificações no Telegram quando cada vídeo subir.
O n8n é diferente de Zapier ou Make porque roda no seu próprio servidor. Sem execuções mensais limitadas, sem plano pago para workflows avançados. Testei esse processo com mais de 40 vídeos de cursos curtos e posso dizer com experiência real: sem automação, o processo é tedioso e cheio de falhas humanas. Com o fluxo que vou mostrar, você configura uma vez e dorme tranquilo enquanto os vídeos sobem.
Por que automatizar uploads no YouTube com n8n vale a pena?
Zero Tempo Manual
Você configura o fluxo uma única vez e ele roda sozinho. Enquanto você dorme, os vídeos sobem, os títulos são preenchidos e as descrições são aplicadas automaticamente — sem você abrir o YouTube Studio.
Consistência Total
Chega de erros de digitação no título ou tag esquecida. O n8n aplica exatamente o mesmo template em todos os uploads, garantindo padrão visual e SEO no canal a cada publicação.
Integra com Qualquer Fonte
Google Drive, Dropbox, pasta local, FTP ou webhook — o n8n conecta com qualquer origem de vídeo. Você não precisa mudar como salva seus arquivos; o workflow se adapta ao seu fluxo de trabalho atual.
Notificações em Tempo Real
Receba aviso no Telegram, Slack ou e-mail assim que cada vídeo for publicado — ou quando der erro. Você acompanha tudo sem precisar ficar de olho no painel do YouTube Studio o tempo todo.
Self-Hosted Sem Limites
Rodando no seu VPS, o n8n não impõe limites de execuções mensais. Você gerencia quantos workflows quiser sem pagar planos por volume de tarefas — o custo real é só o do servidor.
Controle Total do OAuth2
Suas credenciais OAuth2 ficam no seu servidor, não em plataformas de terceiros. Isso reduz drasticamente o risco de exposição das tokens e dá controle real sobre quem acessa sua conta do YouTube.
Como funciona o workflow de upload automático no n8n?
Detectar o Vídeo (Trigger)
Um Schedule Trigger ou Watch Folder monitora constantemente sua fonte de vídeo — pasta no Google Drive, diretório no servidor ou webhook. Quando um arquivo novo aparece, o n8n ativa o fluxo automaticamente. Você define o intervalo: a cada 5 minutos, por hora ou em horário específico (ex: todo dia às 08h).
Processar e Fazer Upload via API
Com o vídeo identificado, o YouTube Node autenticado via OAuth2 envia o arquivo diretamente pela API do YouTube. Título, descrição, tags, categoria e status de privacidade são configurados uma vez no template e reutilizados em todos os uploads seguintes — com suporte a valores dinâmicos usando expressões do n8n.
Notificar e Registrar
Após o upload bem-sucedido, o fluxo dispara uma notificação para Telegram, e-mail ou Slack com o link real do vídeo publicado. Se algo falhar, o Error Trigger registra o erro e avisa imediatamente — para você agir antes que o problema se acumule em silêncio.
Para quem este guia foi feito
Criadores de conteúdo que produzem séries, cursos ou clipes e precisam publicar vários vídeos em sequência sem perder horas no processo.
Devs e sysadmins que já têm VPS rodando e querem adicionar automações úteis ao stack sem depender de serviços SaaS pagos.
Agências e freelancers que gerenciam múltiplos canais de clientes e precisam padronizar o processo de publicação de forma escalável.
Entusiastas de automação que já conhecem o n8n e querem expandir além de e-mails e planilhas, conectando ferramentas de mídia real.
Configuração completa: passo a passo validado
Passo 1 — Criar as Credenciais OAuth2 no Google Cloud
Antes de qualquer coisa no n8n, você precisa de credenciais OAuth2 válidas no Google Cloud Console. Esse é o passo onde a maioria dos tutoriais pula etapas importantes — e que gera 80% das dúvidas. Veja o processo completo que validei na prática, sem atalhos:
- Acesse console.cloud.google.com e crie um projeto novo (ex:
n8n-youtube-uploader). - No menu lateral, vá em APIs e Serviços → Biblioteca e habilite a YouTube Data API v3.
- Acesse APIs e Serviços → Credenciais → Criar credenciais → ID do cliente OAuth.
- Selecione Aplicativo da Web. No campo URIs de redirecionamento autorizados, adicione:
https://SEU-N8N.com/rest/oauth2-credential/callback - Baixe o JSON com
client_ideclient_secret— você vai precisar deles na próxima etapa.
Passo 2 — Configurar as Credenciais no n8n
Com o n8n rodando (VPS, Docker ou local), crie uma nova credencial do tipo YouTube OAuth2 API:
- No painel do n8n, acesse Credenciais → Nova Credencial → YouTube OAuth2 API.
- Cole o
Client IDe oClient Secretdo passo anterior. - Clique em Conectar com Google — uma janela de autorização vai abrir. Faça login com a conta dona do canal YouTube.
- Após autorizar, o n8n armazena o access token e o refresh token automaticamente. O refresh token garante que a autorização se renove sozinha sem intervenção manual.
Passo 3 — Montar o Workflow no n8n
Agora a parte mais importante. Veja a estrutura do fluxo completo com cada nó e sua função:
| Nó | Tipo | Função |
|---|---|---|
| 1. Cron / Schedule | Trigger | Dispara o fluxo no horário definido (ex: todo dia às 08h) |
| 2. Google Drive | Source | Lista arquivos novos em pasta específica do Drive |
| 3. IF (condicional) | Lógica | Para o fluxo se a pasta estiver vazia |
| 4. Google Drive (download) | Download | Faz download do arquivo de vídeo como binário |
| 5. Wait | Controle | Aguarda 5 min entre uploads para respeitar rate limits |
| 6. YouTube | Upload | Envia o vídeo via API com título, descrição, tags e status |
| 7. Telegram / Email | Notificação | Envia confirmação com link do vídeo publicado |
| 8. Error Trigger | Fallback | Captura falhas e envia alerta de erro separado |
Passo 4 — Configurar o YouTube Node
Dentro do nó YouTube, configure os metadados do vídeo. Veja o exemplo de configuração JSON que uso como template base — adaptável com expressões dinâmicas do n8n para puxar dados do nome do arquivo ou de uma planilha:
{
"resource": "video",
"operation": "upload",
"title": "={{ $json[\"titulo\"] ?? \"Vídeo - \" + $now.toFormat('dd/MM/yyyy') }}",
"description": "Publicado automaticamente pelo fluxo n8n.\n\nSaiba mais em https://canalqb.com.br\n\n#automação #n8n #youtube",
"categoryId": "28",
"privacyStatus": "public",
"tags": ["automação", "n8n", "youtube", "workflow", "canalqb"],
"notifySubscribers": true,
"binaryData": true,
"binaryPropertyName": "data"
}
O campo categoryId segue a numeração oficial da API do YouTube.
28 = Ciência e Tecnologia, o mais usado aqui no canal. Outros valores comuns:
22 = Pessoas e Blogs, 24 = Entretenimento, 27 = Educação.
A lista completa está na
documentação oficial da YouTube Data API v3.
Passo 5 — Quotas da API: O Limite que Vai te Pegar de Surpresa
Esse é o ponto onde a maioria se queima. A YouTube Data API v3 usa um sistema de quotas por projeto no Google Cloud, e upload é a operação mais cara:
| Operação | Custo em Quota | Quota Diária Padrão |
|---|---|---|
| Upload de vídeo | 1.600 unidades | 10.000 unidades/dia |
| Listagem de vídeos | 1 unidade | |
| Atualizar metadados | 50 unidades | |
| Inserir thumbnail | 50 unidades |
Na prática: com 10.000 unidades, você faz no máximo 6 uploads por dia (6 × 1.600 = 9.600 unidades). Aprendi isso do jeito difícil tentando subir uma série de 12 vídeos de uma vez — o fluxo travou no 7º sem aviso prévio claro.
Passo 6 — Notificação por Telegram
O Telegram é a solução mais prática que encontrei para notificações de workflow. Você recebe mensagens com o link do vídeo publicado diretamente no celular, sem abrir nenhum painel:
- Crie um bot no Telegram via @BotFather e copie o
tokengerado. - No n8n, adicione o nó Telegram após o YouTube Node.
- Configure a mensagem com expressões dinâmicas para incluir o link real do vídeo publicado.
✅ Vídeo publicado com sucesso!
📹 Título: {{ $node["YouTube"].json["snippet"]["title"] }}
🔗 Link: https://youtu.be/{{ $node["YouTube"].json["id"] }}
📅 Data: {{ $now.toFormat('dd/MM/yyyy HH:mm') }}
Publicado via @CanalQb Automation 🤖
Passo 7 — Tratamento de Erros (Não Pule Essa Parte)
Todo workflow de produção precisa de um Error Trigger. Sem ele, você só vai descobrir que o upload falhou quando perceber que o vídeo não apareceu no canal — às vezes horas depois. Configure um nó Error Trigger separado, conectado a um nó de notificação:
❌ Falha no upload do vídeo!
📋 Workflow: {{ $workflow.name }}
⚠️ Erro: {{ $json["error"]["message"] }}
🕐 Horário: {{ $now.toFormat('dd/MM/yyyy HH:mm') }}
Acesse o painel do n8n para investigar.
Esse alerta salvou minha operação algumas vezes quando o token OAuth2 expirou inesperadamente ou quando a pasta do Drive estava vazia por falha de sincronização. Sem o Error Trigger, o fluxo teria falhado silenciosamente — e eu jamais saberia.
Passo 8 — Formatos de Vídeo e Conversão com FFmpeg
Nem todo formato sobe sem problemas. O YouTube aceita MP4, MOV, AVI, WMV, FLV, MKV e WebM — mas na prática, MP4 com codec H.264 é o formato que menos gera erro na API. Se seus vídeos estão em outro formato, converta antes do upload com FFmpeg via nó Execute Command no n8n:
# Converte qualquer vídeo para MP4 H.264 antes do upload
ffmpeg -i /caminho/video_original.mkv \
-c:v libx264 \
-preset fast \
-crf 23 \
-c:a aac \
-b:a 128k \
/caminho/video_convertido.mp4
Para usar no n8n, adicione um nó Execute Command antes do download do Google Drive.
O FFmpeg precisa estar instalado no servidor onde o n8n roda. Em Ubuntu/Debian:
sudo apt install ffmpeg -y.
Perguntas frequentes sobre upload automático com n8n
privacyStatus como private e use a propriedade publishAt com a data e hora desejadas no formato ISO 8601. O YouTube vai manter o vídeo privado até o horário programado e publicar automaticamente — tudo sem que você precise estar online.quotaExceeded significa que o projeto no Google Cloud consumiu as 10.000 unidades diárias. A solução imediata é aguardar o reset (meia-noite horário do Pacífico). Para evitar no futuro: adicione um nó Wait de 5 minutos entre uploads, crie múltiplos projetos OAuth2 e distribua os uploads entre eles, ou solicite aumento de quota no Google Cloud Console.O que aprendemos e quais são os próximos passos
Depois de configurar esse workflow em produção aqui no @CanalQb, os pontos que mais fazem diferença na prática são: o Error Trigger (sem ele você fica cego a falhas silenciosas), o nó Wait entre uploads (sem ele você vai estourar quota sem perceber) e o backup dos tokens OAuth2 (sem ele uma migração de servidor vira uma dor de cabeça).
O próximo passo natural é integrar uma planilha Google Sheets como fonte de metadados — assim você define título, descrição e tags de cada vídeo numa aba antes do upload, e o n8n puxa esses dados dinamicamente para cada arquivo. Esse fluxo avançado vamos cobrir no próximo tutorial do canal. Inscreve-se para não perder.
Recursos oficiais para este tutorial
Nota Técnica: Scripts fornecidos são para fins educacionais. Teste sempre em ambiente seguro e isolado antes de usar em produção. O autor não se responsabiliza por danos, quotas esgotadas ou qualquer impacto na conta Google ou canal YouTube.

Comentários
Comente só assim vamos crescer juntos!