# Skill: Meta Ads API: Automação Segura e Estratégica

## Propósito da Skill

Olá, estrategista! Esta Skill foi criada para ser o seu **guia definitivo** na arte de automatizar o Meta Ads API com inteligência e segurança. Nosso objetivo é treinar tanto agentes de IA (como o Claude Code) quanto humanos a operar dentro das "quatro linhas" da Meta, minimizando drasticamente o risco de bloqueios e maximizando o potencial da automação. Afinal, queremos robôs que trabalhem como super-humanos, não como spam bots!

## Para o Claude Code (e Outros Agentes de IA): O Comportamento do Super-Humano

Agentes de IA, escutem com atenção! A Meta não bloqueia a automação, mas sim o **comportamento robótico e abusivo**. Para ser um "super-humano" na API, siga estas diretrizes:

### 1. Respeite os Limites de Taxa (Rate Limiting) como um Mestre Zen

*   **Não Seja Sedento:** Evite "rajadas" de requisições. Distribua suas chamadas de API uniformemente ao longo do tempo. Pense como um humano que respira e pensa antes de agir.
*   **Monitore os Cabeçalhos de Resposta:** A Meta envia informações cruciais nos cabeçalhos HTTP de cada resposta da API. Use-os para ajustar seu ritmo:
    *   `X-Ad-Account-Usage`: Indica o uso atual da quota para a conta de anúncios. Se estiver perto do limite, **PARE e espere**.
    *   `X-Business-Use-Case-Usage`: Detalha o uso por caso de negócio. Monitore este também.
*   **Lógica de "Sleep" Inteligente:** Se o uso estiver alto ou se receber um erro de `throttling` (códigos 17, 32, 80004), implemente um `delay` (pausa) exponencial. Comece com uma pequena pausa e aumente-a se o erro persistir. Nunca tente novamente imediatamente e repetidamente.

### 2. Tratamento de Erros: Aprenda com o Fracasso, Não Repita-o

*   **Identifique e Analise:** Quando um erro ocorrer, não apenas tente novamente. Analise o código do erro e a mensagem. A Meta fornece detalhes que podem indicar o problema (ex: violação de política, parâmetro inválido).
*   **Evite Loops Infinitos:** Se um erro persistir após algumas tentativas com `delay`, registre-o e pare a operação. Não continue batendo na mesma porta fechada. Escalone para um humano.
*   **Granularidade é Ouro:** Ao solicitar permissões, peça apenas o estritamente necessário. Menos permissões = menos superfície para problemas.

### 3. Comportamento de Escrita: O Toque Humano na Automação

*   **Ações Graduais:** Ao criar ou editar campanhas, adsets ou anúncios, não faça tudo de uma vez. Introduza pequenos `delays` entre cada operação de escrita. Simule o tempo que um gestor de tráfego levaria para revisar e publicar.
*   **Validação Prévia:** Antes de enviar dados para a API, valide-os localmente. Certifique-se de que criativos, textos e configurações estejam em conformidade com as políticas da Meta para evitar erros que sinalizem sua automação.

## Para os Humanos (Você e Seus Mentorados): O Controle do Estrategista

Vocês são os maestros dessa orquestra! A IA é uma ferramenta poderosa, mas o controle estratégico e a supervisão são indispensáveis. Aqui está seu checklist:

### 1. Configuração e Verificação do App no Meta for Developers

*   **App em Modo Live:** Certifique-se de que seu aplicativo esteja em modo "Live" e não "Development" para operações em contas reais. Apps em desenvolvimento têm limites mais restritos e são mais propensos a sinalizações.
*   **Verificação de Empresa (Business Verification):** Se suas operações exigem acesso a dados sensíveis ou permissões avançadas, a verificação de empresa é crucial. Mantenha-a sempre atualizada.
*   **Permissões Mínimas Necessárias:** Conceda ao seu aplicativo apenas as permissões que ele realmente precisa. Revise periodicamente e remova permissões desnecessárias.

### 2. Estratégia de Implementação: Comece Pequeno, Escalone com Inteligência

*   **Fase 1: IA Analista (Read-Only):** Inicie o Claude Code (ou qualquer IA) apenas com permissões de leitura. Use-o para extrair dados, gerar relatórios e identificar oportunidades. Ações de escrita são manuais.
*   **Fase 2: Teste em Sandbox:** Antes de qualquer automação de escrita em contas reais, teste exaustivamente em uma conta de anúncios de teste ou em uma Business Manager (BM) secundária. Valide o comportamento da IA e a conformidade com as políticas.
*   **Fase 3: Automação Híbrida Gradual:** Após validação em sandbox e um período de sucesso em modo read-only, comece a automatizar pequenas ações de escrita, sempre com `delays` e monitoramento. Aumente a complexidade gradualmente.

### 3. Monitoramento Ativo e Proativo

*   **Dashboard de Monitoramento:** Crie um dashboard para monitorar o uso da API, erros e o status das campanhas gerenciadas pela IA. Fique atento a qualquer anomalia.
*   **Alertas de Bloqueio/Throttling:** Configure alertas para ser notificado imediatamente se houver sinais de `throttling` ou tentativas de bloqueio.
*   **Revisão Periódica:** Revise o comportamento da IA e as políticas da Meta regularmente. O cenário digital muda, e sua automação precisa se adaptar.

## Conclusão: A IA como Extensão do seu Gênio Estratégico

Ao seguir estas diretrizes, você e seus mentorados não apenas evitarão bloqueios, mas transformarão a IA em uma extensão poderosa do seu gênio estratégico. A automação não é sobre substituir o humano, mas sobre amplificar sua capacidade, liberando tempo para o que realmente importa: a estratégia e a inovação. Faça o seu robô ser um super-humano, e a Meta vai amar o seu trabalho!

## Referências

*   [Marketing API Rate Limiting - Meta for Developers](https://developers.facebook.com/docs/marketing-api/overview/rate-limiting/) [1]
*   [Meta Advertising Standards and Community Standards](https://en-gb.facebook.com/business/learn/lessons/advertising-standards-best-practices) [2]
*   [Ad Policy Compliance: Ensuring Your Meta Ads Get Approved](https://lseo.com/blog/social-media-marketing/meta-ads/ad-policy-compliance-ensuring-your-meta-ads-get-approved/) [3]
