---
title: "Vídeos no horário: o Worker vira o despertador"
description: "Por que a rotina das páginas de vídeo deixou de depender do agendamento do GitHub e passou a ser acordada pelo Worker do site, minutos depois do vídeo sair."
url: "https://williandsantos.com/build-log/videos-no-horario-o-worker-vira-o-despertador/"
published: "2026-11-17"
updated: "2026-11-17"
language: "pt-BR"
---

Build log · 17 nov 2026 [● williandsantos.com](https://williandsantos.com/projetos/williandsantos-com/)

# Vídeos no horário: o Worker vira o despertador

Por que a rotina das páginas de vídeo deixou de depender do agendamento do GitHub e passou a ser acordada pelo Worker do site, minutos depois do vídeo sair.

Projeto: [williandsantos.com](https://williandsantos.com/projetos/williandsantos-com/) Willian D. Santos 3 min de leitura

commit

`bdf6e1e` (**williandsantos.com**)

Author:

Willian D. Santos

Date:

17 nov 2026

Vídeos no horário: o Worker vira o despertador

registro 5 de 8 no ramo williandsantos.com

## Contexto

Cada vídeo longo do canal ganha uma página no site, criada por uma rotina no GitHub Actions. Ela olha o canal, pega a legenda, escreve a página com IA e publica. Funcionava, mas o horário não era confiável. O agendamento do GitHub atrasa quando a fila está cheia, e em 17/11 a rotina marcada para as 8h só rodou às 16h27.

Os meus vídeos longos saem às 19h15\. Com esse atraso, a página do vídeo podia aparecer no dia seguinte, justamente quando o movimento vindo do YouTube já tinha passado.

## O que mudou

Quem acorda a rotina agora é o Worker da Cloudflare, o mesmo que serve o site. Ele dispara a rotina do GitHub por um comando que começa em segundos, em vez de esperar o agendamento.

- Às 19h20 e às 19h30 ele dispara sempre. A segunda tentativa cobre o caso de o YouTube demorar a publicar.
- Das 8h às 23h30, a cada 30 minutos, ele lê o feed público do canal, sem gastar cota da API, e só dispara se aparecer um vídeo longo novo que ainda não tem página.
- O agendamento do próprio GitHub ficou às 21h07, como rede de segurança.

## A decisão

Mantive a rotina inteira no GitHub e passei para o Worker só o papel de despertador. A parte que decide o que vira página (Shorts ficam de fora, lives também, a legenda precisa existir) continua num lugar só, com os testes que já tinha.

Descartei ficar só com o agendamento do GitHub, apertando os horários: o atraso não é previsível, então não há horário que garanta a página no ar. Também não levei a rotina para dentro do Worker. Ela já funcionava e já passa pelos checks do repositório; o problema era só a hora de começar.

Para não disparar à toa, o Worker guarda no mesmo banco do Agora cada vídeo que viu e quantas vezes tentou. Um vídeo só ganha nova tentativa depois de duas horas sem página, até três vezes, e nada dispara se houve um disparo nos últimos 20 minutos.

## Por que importa

A página do vídeo é onde o vídeo encontra o resto do site: o artigo do mesmo tema, os materiais e os cursos. Ela precisa estar no ar enquanto as pessoas ainda estão chegando, não horas depois. Com o Worker, assim que o token estiver cadastrado, a página deve sair poucos minutos depois do vídeo.

## Pendências e próximo passo

- Cadastrar no Worker o token do GitHub que permite disparar a rotina. Sem ele, o despertador só registra que falta configurar e não gasta tentativas.
- Acompanhar os primeiros dias e conferir se a página sai entre 19h20 e 19h30.

_Registro escrito depois da decisão, a partir dos commits e da documentação da rotina._

[Ver o projeto williandsantos.com →](https://williandsantos.com/projetos/williandsantos-com/)
