meta-campaign-launcher

Cria campanha Meta ADS em DRAFT (PAUSED) via MCP oficial. Aluno só conversa em linguagem comercial — skill descobre IDs (página FB, pixel, audiência) automaticamente.

Fluxo

0. Garantir campanhas-mãe (Reconhecimento / Engajamento / Vendas)

Toda campanha nova é criada como conjunto de anúncios dentro de uma das 3 campanhas-mãe fixas. Nunca cria uma campanha do zero por pedido do aluno — só na primeira vez, para inicializar a estrutura.

1. Lê ~/.operacao-ia/config/campaigns_master.json. Formato:

   {
     "act_<ad_account_id>": {
       "reconhecimento": "<campaign_id>",
       "engajamento": "<campaign_id>",
       "vendas": "<campaign_id>"
     }
   }

2. Se a conta de anúncios atual (META_AD_ACCOUNT_ID) não tem entrada, ou falta algum dos 3 IDs:
   • Cria as campanhas que faltarem via mcp__meta-official__ads_create_campaign, status ACTIVE no nível de campanha (o status ACTIVE aqui só significa "não travada" — quem controla gasto real são os ad sets, que continuam sempre nascendo PAUSED):
     • "[Reconhecimento] {nome do cliente/conta}" — objective OUTCOME_AWARENESS
     • "[Engajamento] {nome do cliente/conta}" — objective OUTCOME_ENGAGEMENT
     • "[Vendas] {nome do cliente/conta}" — objective OUTCOME_SALES
   • Grava os IDs retornados em campaigns_master.json, sob a chave da conta atual.
3. Essas 3 campanhas nunca são recriadas depois disso — só lidas do arquivo.

1. Lookup automático de contexto

ANTES de pedir input ao aluno, descobre:

1. Conta de anúncios: lê META_AD_ACCOUNT_ID de ~/.operacao-ia/config/meta.env. Se vazio, pede pro aluno rodar setup_meta_oauth.py --set-account.
2. Páginas FB do Business: chama mcp__meta-official__ads_get_pages_for_business(business_id). business_id vem de mcp__...__ads_get_ad_accounts → business.id. Se >1, mostra lista numerada.
3. Pixel: lê META_PIXEL_ID de meta.env. Se vazio, chama GET /act_<id>/adspixels?fields=id,name (via mcp__meta-official ou curl direto). Se >1, lista pra aluno escolher e grava no meta.env.
4. Audiência: pergunta tipo:
   • Interesse (segmentação fria): aluno digita interesses (ex: "marketing digital, agências")
   • Lookalike (parecido com compradores): chama GET /act_<id>/customaudiences?fields=id,name,subtype filtra LOOKALIKE
   • Custom (lista do seu CRM): lista customaudiences filtra CUSTOM

2. Perguntas ao aluno (linguagem comercial)

Vamos criar sua campanha. Te pergunto o essencial e monto tudo.

1) O QUE você quer? (escolha o objetivo — sempre um dos 3)
   [1] Reconhecimento — alcance máximo, mostrar pra mais gente
       Indicador-chave: CPM / alcance
       → entra em: campanha-mãe Reconhecimento

   [2] Engajamento — impulsionar uma postagem que já existe (foto/vídeo já publicado na página)
       Indicador-chave: curtidas, comentários, compartilhamentos
       → entra em: campanha-mãe Engajamento
       → NÃO pede criativo novo: pede pra escolher um post existente (etapa 3-B)

   [3] Vendas — manda direto pro WhatsApp pra fechar a venda
       Indicador-chave: custo por conversa iniciada / ROAS
       → entra em: campanha-mãe Vendas

2) QUANTO investir POR DIA? (mín. R$10)

3) PRA QUEM mostrar?
   [1] Por interesse (você define)
   [2] Lookalike (parecido com seus compradores)
   [3] Custom (sua lista do CRM)

4) QUAL CRIATIVO?
   (pula esta pergunta se objetivo == Engajamento — vai direto pra etapa 3-B)
   - Cole URL pública (ex: https://...)
   - OU caminho de arquivo local (ex: ~/Desktop/criativo.mp4)
   - OU diga "pular" pra criar com placeholder

3-B. Seleção de post existente (só quando objetivo == Engajamento)

Em vez de criativo novo, impulsiona um post que já está publicado na página:

1. Chama mcp__meta-official__ads_get_ig_media(ig_account_id) (posts do Instagram) e/ou lista posts da Página FB via GET /{page_id}/posts?fields=id,message,full_picture,created_time&limit=10.
2. Mostra os últimos 10 posts numerados (com preview do texto/data) pro aluno escolher.
3. Usa o post_id/media_id escolhido no creative.object_story_id do anúncio (em vez de montar object_story_spec do zero) — isso "impulsiona" o post original, mantendo curtidas/comentários existentes.

3. Suporte a criativo local (imagem ou vídeo)

Só se aplica quando objetivo != Engajamento (Reconhecimento ou Vendas, com criativo novo). Detecta extensão:

• .png/.jpg/.jpeg: upload via curl POST /act_<id>/adimages -F filename=@path -F access_token=$TOKEN (token de meta.env). Pega image_hash do response.
• .mp4/.mov: curl POST /act_<id>/advideos -F source=@path -F access_token=$TOKEN. Pega video_id. Auto-extrai thumbnail:

  ffmpeg -i <video> -ss 00:00:02 -vframes 1 -y /tmp/thumb.jpg

  Upload thumb como image (passo anterior). Monta creative.object_story_spec.video_data = {video_id, image_hash}.
• URL pública (http/https): passa direto em image_url ou link do creative spec.
• "pular": usa placeholder image_hash do BM (ou cria sem creative — campanha em DRAFT exige só estrutura).

4. Image-from-chat (limitação clara)

Se aluno disser "essa imagem aqui no chat" / "use a foto que mandei":

"Salve a imagem no chat (clique direito → Salvar imagem) em ~/Desktop/criativo.png e me diga o caminho. Ou cole URL pública."

NÃO tente automatizar — instrua aluno a fornecer caminho/URL.

5. Criação no Meta

campaign_id NÃO é criado aqui — vem da etapa 0 (campaigns_master.json), de acordo com o objetivo escolhido na etapa 2.

Checagem obrigatória de CBO antes de definir orçamento: antes do ads_create_ad_set, consulta a campanha-mãe (GET /{campaign_id}?fields=campaign_budget_optimization,daily_budget,lifetime_budget via mcp__meta-official ou curl direto).

• Se a campanha-mãe tem CBO ativo (campaign_budget_optimization = true ou possui daily_budget/lifetime_budget própria): NÃO envia daily_budget no ad set — o orçamento é gerenciado no nível da campanha. Enviar orçamento duplicado no ad set gera erro ou conflito de budget.
• Se a campanha-mãe é ABO (sem CBO, cada ad set tem orçamento próprio): envia daily_budget normalmente no ad set, com o valor que o aluno informou na etapa 2.

Sequência de tool calls:

1. mcp__meta-official__ads_create_ad_set(campaign_id=<id da campanha-mãe correspondente>, daily_budget=<omitir se CBO>, audience_spec, page_id, optimization_goal, billing_event, status="PAUSED")
2. mcp__meta-official__ads_create_ad(adset_id, creative={...}, status="PAUSED")

6. Output ao aluno

✅ Conjunto de anúncios criado em PAUSED!

Campanha-mãe: [{Reconhecimento|Engajamento|Vendas}] {nome da conta} (Campaign ID: {campaign_id})
Nome do conjunto: {name}
Ad Set ID: {adset_id}
Ad ID: {ad_id}

Tudo PAUSADO — não vai gastar até você ativar.

Revise no Ads Manager: https://business.facebook.com/adsmanager/

Salva IDs em ~/.operacao-ia/config/setup6_progress.json campo demo_campaign_ids.

Glossário (linka aqui ao mencionar termo técnico)

docs/glossario.md — termos como CPL/CPA/ROAS/Pixel/CBO/ABO/Lookalike traduzidos.