Pra que servem rotinas
Rotinas são tarefas que se repetem em uma cadência fixa — toda segunda às 9h, todo dia útil às 18h, todo primeiro dia do mês. Em vez de você lembrar de fazer + executar manualmente, uma rotina dispara automaticamente no momento configurado e executa o que você definiu — podendo envolver um agente, uma criação de task, um envio outbound, ou uma combinação.Quando usar rotina vs task
| Cenário | Use |
|---|---|
| ”Tenho que fazer X uma vez, semana que vem” | Task com data |
| ”Tenho que fazer X toda semana, indefinidamente” | Rotina |
| ”Quero que o agente revise leads parados toda terça” | Rotina + agente |
| ”Vou disparar uma campanha agora pros leads novos” | Outbound (one-shot) |
| “Quero relatório semanal por e-mail toda sexta 18h” | Rotina + Marcus |
Anatomia de uma rotina
Cadência
Quando dispara — diária / semanal / mensal / cron expression
custom. Suporta fuso horário da org.
Ação
O que executa no momento do disparo — chamar um agente, criar
uma task, enviar uma mensagem, rodar um pipeline outbound.
Contexto
Inputs que a rotina passa pra ação (ex.: “leads que não tiveram
atividade nos últimos 7 dias”). Pode ser estático ou dinâmico.
Histórico
Cada execução fica registrada — quando rodou, o que executou,
se deu certo, quanto gastou em Stars.
Padrões comuns
Relatório semanal pro time
Relatório semanal pro time
Cadência: toda sexta às 18h
Ação: Athena consulta atividade da semana + monta resumo em
documento
Output: doc novo numa pasta compartilhada + notificação no
chat dos ownersÚtil pra: visibility recurring sem trabalho manual.
Re-engajamento de leads parados
Re-engajamento de leads parados
Cadência: toda terça às 10h
Ação: Marcus revisa leads sem atividade nos últimos 14 dias
e propõe rascunhos de follow-up (HITL ligado, você aprova)
Output: drafts aguardando aprovação no chatÚtil pra: evitar que oportunidade morra por falta de toque.
Limpeza mensal do pipeline
Limpeza mensal do pipeline
Cadência: primeiro dia do mês às 8h
Ação: Athena arquiva leads em estado terminal há mais de 90
dias + identifica duplicatas
Output: task de revisão pro owner do pipelineÚtil pra: pipeline não ficar inflado com lixo histórico.
Importação automática de leads
Importação automática de leads
Cadência: todo dia útil às 7h
Ação: roda um actor Apify (Maps lead search com query
pré-definida) e adiciona resultados novos no pipeline
“Outbound novo”
Output: N leads novos prontos pra o Marcus trabalharÚtil pra: manter o funil sempre alimentado sem trabalho manual.
Configurar uma rotina
Sidebar → Rotinas → Nova rotina
Abre o configurador.Resultado esperado: painel com 4 abas (Cadência / Ação /
Contexto / Notificação).
Defina a cadência
Opções:
- Diária (escolhe hora)
- Semanal (dias da semana + hora)
- Mensal (dia do mês + hora)
- Custom (cron expression — pra cenários complexos)
Escolha a ação
O que vai executar:
- Chamar agente — passa prompt pré-definido pro Scout / Marcus / Athena
- Criar task — task nova num board específico
- Disparar outbound — rodar campanha existente em audiência filtrada
- Executar tool — ex.: rodar
maps_lead_searchdireto
Defina notificação (opcional)
Quando a rotina termina, quem é notificado:
- Ninguém (silenciosa)
- Você (notificação no inbox)
- Pessoas específicas (mention)
- Canal externo (Slack via Composio)
Limites e gotchas
Cap diário do agente vale
Se a rotina dispara um agente que tem cap diário, e a rotina
estoura o cap, a execução é bloqueada. Você é notificado pra
decidir: subir o cap ou aceitar a falha pontual.
Skip em janelas sensíveis
Configurações da org podem definir janelas sensíveis (fim de
semana, feriado, after-hours) onde rotinas não disparam outbound
pra clientes. Internal-only continua rodando.
Idempotência por execução
Se uma rotina falha e tenta de novo, ela usa Idempotency-Key
pra evitar duplo-disparo. Você não corre risco de mandar a
mesma mensagem duas vezes.
Backfill desligado por default
Se a rotina ficou pausada por 3 dias e você reativa, não roda
as 3 execuções perdidas. Roda só a próxima agendada. Pra
backfill explícito, use “Rodar agora” manualmente.
Auditoria
Cada execução de rotina gera entrada no histórico:| Campo | O que registra |
|---|---|
executed_at | Timestamp da execução |
routine_id + routine_name | Qual rotina |
action_type | Tipo de ação (agent / task / outbound / tool) |
status | success / failed / skipped |
cost_stars | Quanto gastou em Stars |
output_ref | Link pro recurso criado (task, draft, etc.) |
Próximos passos
Outbound
Como o Marcus opera as campanhas que rotinas podem disparar.
Agentes
Quem você pode chamar de dentro de uma rotina.
Caps
Como travar gasto de rotinas que ficaram em loop.
Composio
Pra integrações externas que rotinas acionam (Slack notify,
Calendar, Notion).