🟣 Hospedagem & Deploy

Scripts que rodam na internet por conta própria, por agenda (cron) ou disparados por evento (webhook), sem um humano presente para iniciar ou observar.

Automação disparada por humano só escala na velocidade em que alguém aparece para clicar; hospedar é o salto para a autonomia.

Local → hospedado; cron vs webhook; Trigger.dev como motor; GitHub como armazenamento.

A lacuna que surge quando a tarefa roda sozinha: a IA não está mais ali para ler o erro e se auto-curar, então o sistema executa mas não se adapta.

Em produção, uma falha pode passar despercebida; é preciso fechar a lacuna com recursos da plataforma e prompts melhores.

Fim do loop de auto-cura; entradas fixas, saídas estruturadas; erro e log embutidos desde o início.

Um padrão de temporização de 5 campos (minuto, hora, dia-do-mês, mês, dia-da-semana). Exemplo: 0 7 * * * = 7h todo dia.

É a linguagem universal de agendamento; saber lê-la deixa você no controle de quando a automação dispara.

Cinco campos; * = qualquer; agenda recorrente; o palavra-chave "roda sozinho".

GitHub é armazenamento de código na nuvem: o deploy puxa de lá (não de uma máquina local), com histórico de versões para rollback e troubleshooting.

É a fonte única do código que vai para produção, acessível de qualquer computador.

Repositório = pasta do projeto; commit (snapshot) e push (envio); repo privado + README.

A ferramenta de linha de comando (gh) autentica e conecta o projeto local ao repositório; o .gitignore lista o que nunca deve subir.

A regra de ouro: o arquivo .env com as chaves NUNCA vai para o GitHub.

gh auth login; .gitignore automático; segredos fora do controle de versão.

O motor de execução na nuvem: sem timeouts, retries automáticos, traces completos de cada passo, suporte a agendas e webhooks, e alertas de falha.

É o que torna a automação confiável — como um assistente firme, não um lembrete colado na geladeira.

TypeScript (a IA escreve); MCP oficial; dashboard como janela da produção.

Instalar o MCP do Trigger.dev, rodar o init (cria trigger.config.ts e a pasta de tasks), subir o worker de dev e conhecer a anatomia do dashboard.

Sem o projeto inicializado e o worker rodando, as tarefas não se registram nem executam.

Project ID; init interativo; dev vs produção; runs, traces, payload e output.

Variáveis de ambiente armazenadas no dashboard do Trigger.dev e injetadas em runtime, com um .env.example seguro de versionar.

O Trigger.dev não lê o .env local; sem secrets na nuvem, a tarefa quebra em produção.

Injeção em runtime; nunca colar chave no chat; checar dev e prod separadamente.

Uma tarefa agendada que roda toda manhã: cron dispara, Firecrawl pesquisa um tópico fixo, a IA sintetiza e uma linha é escrita no Google Sheets.

É o build agendado completo, do prompt ao deploy, rodando sem ninguém olhando.

Tarefa não-supervisionada; tópico hard-coded; arquivo único; trigger de teste no dashboard.

A configuração única do refresh token do Google (OAuth); quando o Playground falha ("access blocked"), o fallback é um script no terminal que imprime a URL e devolve o token.

Sem o refresh token a tarefa não consegue escrever no Sheets de forma autônoma.

Client ID + secret; refresh token; OAuth (não service account); .env + env vars da nuvem.

Uma falha real: a API retorna um formato inesperado (resultados em web, não em data); copia-se o trace para a IA diagnosticar e corrigir o parsing.

Alguns erros só aparecem com dados reais em produção — saber lê-los e devolvê-los à IA é a habilidade central.

Shape de resposta diferente; trace vermelho; redeploy + retrigger; erro como insumo.

Uma tarefa disparada por webhook: um payload JSON com campos (empresa, setor, meta, desafio) gera um relatório .docx salvo no Google Drive.

É o build orientado a evento — o complemento do agendado, disparado por dados que chegam.

Normalizar campos do formulário; folder ID opcional; teste local antes do formulário.

Um webhook é uma URL que escuta dados que chegam e acorda a tarefa, passando o payload adiante — uma "campainha digital".

Sem autenticação, qualquer um chama sua tarefa; o header Authorization: Bearer protege o endpoint.

URL com o ID da task; corpo JSON; Bearer + chave da API; URL compartilhável.

Iterar no editor empurra o código pro GitHub, que faz o deploy automático no Trigger.dev — os arquivos mais recentes estão sempre no ar.

Fecha o ciclo de iteração: você muda, dá push, e a produção se atualiza sozinha.

Repository Secret (TRIGGER_ACCESS_TOKEN); GitHub Actions; commit → push → deploy.

Uma abordagem em camadas: log significativo em cada passo, try/catch em volta de cada chamada externa, retries com backoff e alertas por e-mail/Slack.

Sem auto-cura em produção, o tratamento de erro é o que fecha o agentic gap.

Log específico (não "task failed"); retries para falhas transitórias, não bugs; alertas configurados.

O ciclo em produção: abrir o trace vermelho no dashboard, copiar o erro, colar na IA, deixá-la diagnosticar, corrigir e redeployar.

A IA ainda depura, mas não mais sozinha — um humano precisa levar o erro até ela.

Trace + IA = diagnóstico rápido; humano como ponte; iterar até passar.