Automação

A Automação do PostClaw permite encadear skills de IA em pipelines que são executados em um agendamento — publicação de conteúdo totalmente automática.

Conceitos

Criando um Workflow

1. Acesse Configurações → Automação → Workflows
2. Clique em Novo Workflow
3. Adicione etapas em ordem:

[Fonte: Feed RSS]
  → Skill: Resumir Artigo
  → Skill: Reescrever no tom do LinkedIn
  → Skill: Gerar imagem de cabeçalho
  → Saída: Post no LinkedIn (agendado)

As skills podem passar contexto para a próxima etapa via variáveis {{output}}.

Tipos de Fonte

Agendamento Cron

Use expressões cron padrão de 5 campos:

# Todo dia útil às 9h UTC
0 9 * * 1-5

# Toda segunda e quinta às 12h UTC
0 12 * * 1,4

# A cada hora
0 * * * *

A interface inclui um construtor visual de cron, se preferir configuração gráfica.

Anexar um agendamento a um workflow existente registra o trabalho imediatamente. Se o agendamento em si estiver desativado, o trabalho fica desativado — agendar um workflow desativado nunca o inicia em segundo plano.

As Execuções Agendadas Correspondem ao que Você Testou

Um workflow agora é executado da mesma forma, independentemente de como é iniciado.

Anteriormente não era assim. Pressionar Executar no Studio sempre seguia seu gráfico exatamente. Em um tick cron, apenas workflows contendo ramificação (if/else ou loop) faziam o mesmo — um workflow em linha reta era entregue à IA como uma descrição do que você queria, e o modelo decidia quais etapas chamar. A ordem das etapas, as configurações por etapa e a escolha do modelo por etapa eram vinculantes ao testar e apenas consultivas quando o agendamento era executado.

Ambos os caminhos agora são idênticos. Se você verificar um workflow com Executar, o disparo do cron fará o mesmo.

Histórico de Execução

Toda execução é registrada, incluindo as que anteriormente não deixavam rastro: disparos cron, Gerar no compositor, a gaveta de geração de blog e Executar agora no painel. Apenas as execuções do Studio costumavam aparecer no histórico de execução.

Duas regras importantes:

• Uma execução que é pulada — porque outro run mantém o bloqueio, ou você ficou sem créditos, ou atingiu o limite de execução do seu plano — não é registrada. Nunca foi executada, portanto contá-la relataria mal seu uso.
• Uma execução que termina sem produzir conteúdo é registrada como erro, não como sucesso silencioso.

Gate de Aprovação

Adicione uma etapa de Aprovação para pausar o pipeline e aguardar revisão humana antes de publicar:

1. A automação é executada e para no gate de aprovação
2. Você recebe uma notificação (e-mail ou no aplicativo)
3. Revise o rascunho — aprove ou rejeite com feedback
4. Após aprovação, o pipeline continua até a publicação

Recomendado para contas de marca ou conteúdo de alto impacto.

Configurações por Etapa

Cada etapa tem suas próprias configurações, aplicadas apenas àquela etapa:

• Modelo — escolha um modelo diferente para esta etapa
• Sua própria chave de API (BYOK) — use a chave do seu provedor para esta etapa
• Parâmetros de geração — controles de criatividade e comprimento
• Prompt — digite-o diretamente na etapa na tela ou no painel lateral
• Repetição — quantas vezes repetir, quanto tempo esperar e o que vale a pena repetir

Esses controles costumavam ser coletados e ignorados. A consequência prática era de faturamento: se você escolhesse seu próprio modelo BYOK para uma etapa, a execução usava silenciosamente o modelo integrado em seu lugar e ainda debitava seus créditos PostClaw. Agora a configuração é respeitada.

Um prompt digitado diretamente em uma etapa na tela também costumava ser perdido ao salvar — a etapa parecia vazia quando você a reabrisse, e a execução usava a saída da etapa anterior. Isso foi corrigido.

Os dropdowns de etapa agora oferecem apenas valores que a etapa realmente aceita. Algumas opções listadas anteriormente falhariam, e uma configuração necessária foi renderizada como caixa de texto livre e silenciosamente padronizada.

Repetição e Prazos

Repetição agora está disponível em toda etapa de ferramenta. Costumava aparecer apenas em alguns tipos de etapas, deixando as etapas apoiadas por IA — aquelas mais expostas a um provedor lento — como as que você não podia proteger.

Cada etapa tem permissão para 120 segundos. Uma carga de trabalho que normalmente termina logo abaixo falhará intermitentemente em vez de consistentemente, então a repetição vale a pena ativar em etapas que chamam um modelo externo.

As etapas que publicam ou alteram algo fora do PostClaw são excluídas da repetição, portanto uma repetição nunca pode fazer publicação dupla.

Webhook e Variáveis

Os corpos de Webhook agora substituem variáveis antes de enviar:

• {{input}} — a entrada do workflow
• {{prev.text}} — a saída da etapa anterior
• {{step.<id>.output}} — a saída de uma etapa específica

Anteriormente, o corpo era enviado exatamente como escrito, portanto um payload Slack como {"text":"{{prev.text}}"} chegava com as chaves literais nele.

Duas correções relacionadas: o campo Entrada de uma etapa de transformação agora funciona (anteriormente sempre lia a etapa imediatamente anterior, independentemente do que você escolhesse), e a caixa de seleção “truncar se ultrapassar limite” da etapa de formato agora é respeitada.

Falhas são Reportadas como Falhas

Um problema recorrente: uma etapa falhou, algo a cobriu e a execução foi registrada como bem-sucedida. Agora essas interrompem a execução.

Rastrear múltiplos URLs ainda mantém resultados parciais: se alguns forem bem-sucedidos, a execução continua com aqueles. Apenas um rastreamento completamente falhado se torna um erro.

A mesma resposta “nada encontrado” ainda é uma resposta normal no chat — esse tratamento mais rigoroso se aplica apenas a workflows.

Etapas Disponíveis

Três etapas de origem agora funcionam que não poderiam antes:

As etapas de notícias também falham em voz alta quando o item mais recente é mais antigo que a janela de frescura, em vez de republicar silenciosamente notícias de um mês atrás.

Etapas que você não pode mais adicionar

Montar vídeo, Gerar legendas e Referência foram removidas do seletor de etapas porque nada em um workflow pode fornecer o que precisam — adicionar uma garantiu uma execução com falha. Os workflows existentes que já as usam continuam renderizando e executando. Elas retornarão quando as peças faltantes chegarem.

Imagens Geradas Chegam ao Rascunho

Um workflow que gera uma imagem e cria um rascunho costumava perder a imagem quando executado do Studio — ela era gerada, faturada e depois descartada, portanto o rascunho chegava sem mídia. O mesmo workflow anexava sua imagem corretamente quando o agendamento era executado. Ambos os caminhos agora se comportam igual.

Modelos e Salvamento

Modelos de workflow agora vêm com conteúdo inicial, e o prompt inicial de um modelo é visível na primeira vez que você o abre.

Salvar e reabrir um workflow não descarta mais configurações — conexões de etapas, canais de saída e configuração de origem sobrevivem à viagem de ida e volta.

Catálogo de Skills

Skills disponíveis nos workflows:

O PostClaw vem com mais de 66 skills de IA integradas cobrindo chat (escrever legendas, threads, hashtags, traduzir, ajustar tom, SEO, variantes…), geração de imagens e geração de vídeos. Todas as skills estão disponíveis para todos os planos — Free, Pro e Business têm acesso completo ao catálogo. Apenas os créditos mensais de IA e o número de slots de skills personalizadas (criadas pelo usuário) variam conforme o plano.

Cotas e Limites

Cada execução de skill desconta créditos de IA com base nos tokens utilizados — não há restrição de acesso por nível de plano.

Usuários BYOK não têm limite de execuções — você paga o provedor de IA diretamente.

Acionamento via API (Em Breve)

O acionamento via API faz parte da futura API pública. Consulte a Referência de API para os endpoints planejados.