Visão geral

🇺🇸 Read in English

O Media Ops é o criador de campanhas Meta Ads da Infotráfego. Tudo o que a equipe faz pela interface — escolher cliente/BM/conta, consultar públicos, montar e publicar campanhas, estender campanhas e conjuntos, reexecutar falhas, criar públicos de engajamento, gerenciar modelos de segmentação, clientes, saldos e usuários — também pode ser feito por:

Uma regra, três canais

As regras de negócio vivem apenas no servidor. A interface, a API e o MCP chamam os mesmos serviços, então:

• a validação de uma campanha é a mesma nos três (campos obrigatórios, objetivos de conversão permitidos, botões (CTA) por objetivo, confirmação de UTMs, limites de carrossel etc.);
• a seleção de cliente/BM/conta é sempre reconferida no servidor: cliente arquivado, conta de outra BM, conta desativada manualmente ou inativa na Meta são recusados com 403;
• a orquestração da criação (campanha → conjuntos → mídias → criativos → anúncios), o pré-voo de públicos, a espera automática quando a Meta limita a conta e a reexecução inteligente são idênticos;
• tudo é criado PAUSADO. A ativação continua sendo feita no Gerenciador de Anúncios.

Endereços

Modelo assíncrono

Criar uma campanha leva de segundos a vários minutos (upload de vídeos, limites da Meta). Por isso:

1. POST /campaigns responde 202 com um job_id;
2. o servidor executa a criação em segundo plano — fechar a conexão não interrompe nada;
3. acompanhe por GET /executions/{job_id}/progress até o status ser success, partial ou error.

O mesmo vale para POST /audiences/engagement e POST /executions/{job_id}/retry.

Convenções

• Corpo e respostas em JSON (UTF-8). Nomes de campos em inglês; mensagens em português (user_message).
• Orçamentos em reais (50 = R$ 50,00).
• Datas de veiculação no horário de São Paulo, formato AAAA-MM-DDTHH:mm.
• IDs da Meta são strings numéricas; ad_account_id aceita com ou sem act_.
• Toda resposta traz o cabeçalho x-request-id — informe-o ao reportar um problema.

Por onde seguir