subir-campanha

name	subir-campanha
description	Sobe uma campanha completa no Meta Ads via uma única frase em linguagem natural. Cria estrutura, conjunto, anúncio, configura segmentação e orçamento.

Subir Campanha

Você é a skill subir-campanha. A skill JÁ ESTÁ IMPLEMENTADA em Python — você invoca via Bash, não precisa escrever código.

Como invocar (instrução pro Claude)

Quando o usuário pedir algo como "sobe campanha do com " ou similar:

1. Identifica os 4 inputs com o usuário (peça os que faltarem):

   • Cliente (nome da pasta em clientes/<nome>/, ex: acme, joao-silva)
   • Budget diário em reais (ex: 500)
   • Objetivo — CONVERSIONS, TRAFFIC ou LEADS (aceita CONV/TRAF como atalho)
   • Modo — --abo (orçamento por conjunto, default) ou --cbo (orçamento na campanha)

2. Sempre roda primeiro com --dry-run pra mostrar a estrutura. Comando único (Bash, em uma linha):

   cd /Users/isaacsantos/Documents/bravo-skills/_drafts/subir-campanha && source .venv/bin/activate && python scripts/main.py --client "<nome>" --budget <valor> --objetivo <CONVERSIONS|TRAFFIC|LEADS> --abo --dry-run
   

3. Se imprimir "✗ Variáveis ausentes no .env", peça ao usuário pra preencher e tenta de novo. O .env fica em /Users/isaacsantos/Documents/bravo-skills/_drafts/subir-campanha/.env.

4. Mostra o resumo do dry-run pro usuário e pergunta confirmação ANTES de remover --dry-run. Algo como: "vou criar essa campanha PAUSED, posso seguir?"

5. Após confirmação, roda o mesmo comando sem --dry-run. A campanha sai PAUSED — usuário ativa manualmente no Ads Manager.

6. Mostra o link do Ads Manager (impresso no final) pro usuário revisar.

O que você faz

Quando o gestor disser algo tipo:

"sobe campanha do acme com 500 reais em ABO"

Você:

1. Identifica o cliente (acme) no vault Obsidian (clientes/acme/)
2. Lê o histórico do cliente (criativos que rodaram, públicos, ângulos)
3. Pergunta o que falta: objetivo (CONVERSIONS / TRAFFIC / LEADS), público (frio/morno/quente), criativos (quais usar)
4. Monta a estrutura: 1 campanha (ABO ou CBO) + 1-3 conjuntos + 1-3 anúncios
5. Sobe via Meta Marketing API (modo PAUSED por segurança)
6. Confirma com link da Ads Manager
7. Atualiza historico.md do cliente

Convenções importantes

• Sempre subir PAUSED — gestor revisa e ativa manualmente
• Nomenclatura padrão Bravo:

  Campanha: [Cliente] · [Objetivo] · [Data]
  Conjunto: [Público] · [Idade] · [Localização]
  Anúncio: [Criativo-ID] · [Hook]
  

• Sempre confirmar antes de gastar: mostrar resumo (orçamento total, públicos, criativos) antes de subir
• Modo dry-run primeiro: se for primeira vez, mostrar JSON da estrutura sem subir

Setup

Veja README.md na pasta da skill.

Variáveis de ambiente

• META_ACCESS_TOKEN — token long-lived com ads_management
• META_AD_ACCOUNT_ID — conta de anúncios (formato act_XXX)
• OBSIDIAN_VAULT_PATH — caminho do vault local

Limitações

• Só Meta Ads por enquanto (Google Ads em outra skill futura)
• Não cria criativos novos — usa os que já existem no vault do cliente (precisa do creative_id)
• Validação de público é feita via Audience Insights, não cria custom audience
• Targeting default é genérico (BR, 25-55, feed/story) — gestor refina no Ads Manager ou edita o JSON antes de subir
• Sem creative_id preenchido, o anúncio é pulado mas a campanha + conjunto sobem (gestor anexa criativo no Ads Manager)

TODO (preencher antes do evento)

• Implementar scripts/main.py com chamadas à Marketing API
• Ler clientes/<nome>/contexto.md pra puxar contexto do cliente
• Atualização automática do historico.md
• Modo --dry-run com preview JSON
• Backup do JSON da estrutura em clientes/<nome>/campanhas/
• Templates de campanha por objetivo (templates/conversions.json, etc)
• Validação de criativos (formato, dimensões, política)
• Resolução automática de creative_id a partir do contexto.md