Automações

Uma automação é um gatilho ligado a um fluxo de trabalho (competência). O fluxo diz o que fazer; a automação diz quando. Juntos, transformam um pedido que você antes digitava à mão em trabalho que acontece sem você.

Lembretes de agenda pedem que você faça o trabalho. Automações fazem o trabalho e depois avisam que está pronto.

Toda automação nomeia três coisas:

1. O fluxo de trabalho a executar
2. O agente que o executa — define o tom, o modelo e os conectores em jogo
3. O gatilho — um agendamento, um evento em uma das suas ferramentas ou um webhook de entrada

O que acontece em cada execução

Cada disparo abre um chat novo. O chat relê o contexto mais recente das suas ferramentas, chama os conectores de que precisa e produz o resultado.

Isso importa por dois motivos:

• Sem estado acumulado. A execução da segunda passada não vaza para a desta segunda. O procedimento é o mesmo; os dados são frescos.
• Toda execução é reproduzível. Abra o histórico da automação para ver exatamente o que a última execução fez, onde gastou créditos e o que produziu.

Se uma execução falha — queda de rede, token expirado, entrada ambígua —, o Zero registra a falha com o motivo e avisa você, em vez de descartá-la em silêncio.

Tipos de gatilho

Agendamentos

A família mais comum: a automação roda em uma cadência — diária, semanal, de hora em hora, por uma expressão cron própria, em intervalo fixo ou uma única vez em um momento definido.

Quatro formas de dizer quando. Você não precisa escrever cron:

• Linguagem natural. "Todo dia útil às 8h, horário de Los Angeles" — o Zero interpreta para você. Fusos horários, dias úteis, "no primeiro dia do mês", "a cada duas sextas": tudo funciona. É o que a maioria dos times escolhe.
• Expressão cron. 0 8 * * 1-5, para controle preciso. Informe o fuso IANA ao lado (America/Sao_Paulo, America/Los_Angeles).
• Intervalo. A cada 15m, 1h, 90s — um loop, para verificações de saúde e coletores em que alinhar com o relógio não importa.
• Uma vez só. Um disparo único na data e hora definidas — um once. Útil para um lembrete atrelado a um lançamento, um embargo ou um prazo.

Um agendamento sem fuso horário roda em UTC, que raramente é o que "9h" significa para quem lê. Nomeie o fuso.

Quase todo "eu deveria…" recorrente que fica na sua cabeça é candidato: um resumo matinal às 8h todo dia útil, um digest semanal de métricas toda segunda, uma limpeza da caixa de entrada toda noite, uma verificação de saúde da produção a cada 30 minutos, a preparação do conselho de fim de trimestre no dia 25 do terceiro mês.

Se o trabalho deve partir de um evento em vez de um relógio — chega um e-mail, um PR é aprovado, uma página é publicada —, um dos gatilhos abaixo se encaixa melhor e não desperdiça execuções fazendo polling.

E-mail

Ambos se estreitam com regras de texto em De, Para, Cc, Assunto e corpo — cada uma disponível como contém e não contém. Sem regras, uma automação do Gmail casa com toda mensagem recebida, então comece estreito.

Faça a triagem do e-mail de suporte sem vigiar a caixa: gmail-new-message filtrado em from-contains: @dominio-cliente.com, executando um fluxo customer-reply-draft que prepara um rascunho para você revisar.

GitHub

Os gatilhos do GitHub exigem o GitHub App instalado no seu espaço de trabalho. Filtros aceitam valores separados por vírgula; omita um para casar com qualquer coisa.

Feche o ciclo da CI: github-workflow-run-completed em conclusion: failure para main, executando um fluxo que lê os logs, identifica o passo que falhou e publica um diagnóstico no Slack.

Agenda

Cada um observa uma agenda — a principal, por padrão.

Nunca entre frio em uma reunião: google-calendar-event-created executando um fluxo que pesquisa os participantes externos e suas empresas e manda um resumo antes da reunião.

Notion

CMS

Webhook e chat

chat-run-finished é como você encadeia trabalho: a saída de uma automação vira a largada da seguinte.

Criar uma automação

A partir de um chat que funcionou. Rode a tarefa uma vez primeiro. Quando ela produzir o que você quer, diga:

"Rode isso todo dia útil às 8h, horário de Los Angeles, e me mande o resultado por DM."

O Zero confirma o fluxo, a cadência e o destino, salva o fluxo se ele ainda não existir e anexa a automação.

Explicitamente. Abra um fluxo no seu espaço de trabalho e adicione uma automação a ele, escolhendo o tipo de gatilho e seus filtros. Útil quando você já conhece o formato e não quer um ensaio.

Automações podem ser ativadas e desativadas individualmente sem apagá-las — o movimento certo antes das férias, ou enquanto você depura um gatilho barulhento.

Destinos

Uma automação precisa saber para onde vai o resultado. Diga isso na instrução do fluxo:

• Canal do Slack ou DM — o mais comum; chega ao canal como mensagem ou thread
• Feishu ou Microsoft Teams — mesma ideia para times que vivem lá
• Telegram ou mensagem de texto — para alertas pessoais, pensados primeiro no celular
• Uma página ou banco de dados do Notion — para o que deve ser arquivado, não divulgado
• Um Google Doc ou planilha — anexado ou sobrescrito
• Uma issue do GitHub ou comentário em PR — para fluxos de engenharia
• Um rascunho do Gmail — preparado na sua conta, para você revisar e enviar
• Uma página hospedada — para resultados que você queira compartilhar como URL pública
• Um arquivo do espaço de trabalho — quando o artefato é um vídeo, uma imagem ou um material para download

"Publique em #engineering" ou "me mande um DM" é mais claro do que "mande para algum lugar".

Dicas de operação

Vêm de rodar automações em produção:

• Acompanhe as três primeiras execuções. Automações são fáceis de montar; ficam mais fáceis de refinar depois que você vê o que o Zero realmente produz no seu ambiente.
• Mantenha cada tarefa pequena. Automações longas e de muitos passos são mais frágeis. Se uma só precisa atualizar cinco sistemas, considere dividi-la em duas.
• Fixe o destino. Canais são renomeados e pessoas saem. Nomeie o destino explicitamente na instrução do fluxo; o Zero avisa se não encontrá-lo na próxima execução.
• Delimite consultas longas no tempo. Se o prompt pede "os últimos 30 dias", repita isso a cada execução para a janela continuar fresca.
• Atenção ao fuso horário. Um agendamento sem fuso roda em UTC.
• Pause antes das férias. Especialmente automações que te mandam DM: voltar para 14 DMs de resumo não ajuda ninguém. Desative a automação e reative na volta; o fluxo permanece intacto.

Custos

Cada execução consome créditos, e toda execução é atribuída ao agente que a rodou. O histórico mostra o custo em créditos por execução, então dá para achar as caras. Um resumo matinal costuma ser barato — algumas centenas de créditos. Um pacote semanal de conteúdo com várias ferramentas pode custar um ou dois mil. Como isso se traduz em dólares está em Créditos e faturamento.

Intervalos loop curtos se multiplicam rápido: a cada 15 minutos são 96 execuções por dia.

Gatilhos de evento podem ser surpreendentemente falantes. Uma automação do Gmail sem filtros, ou uma do GitHub sobre um monorepo movimentado, vai disparar muito mais do que você espera. Filtre estreito primeiro, depois amplie.

Próximos passos

• Para o procedimento que uma automação executa, veja Fluxos de trabalho (competências).
• Para o que acontece dentro de cada execução, veja Chat.
• Para cinco combinações completas de fluxo e automação, veja Fluxos de trabalho de exemplo.