n8n-nodes-alicia-gt

Community node para n8n que permite gerenciar campanhas, conjuntos de anuncios e anuncios na Meta (Facebook/Instagram Ads).

Recursos

Campaign (Campanha)

• Criar: Cria nova campanha com objetivos pre-mapeados
• Atualizar: Atualiza nome, status, orcamento
• Obter: Retorna dados de uma campanha
• Listar: Lista todas campanhas da conta
• Deletar: Remove campanha
• Duplicar: Shallow (so campanha) ou Deep (campanha + adsets + ads)

AdSet (Conjunto de Anuncios)

• Criar: Cria conjunto com targeting, orcamento, otimizacao
• Atualizar: Atualiza configuracoes do conjunto
• Obter: Retorna dados de um conjunto
• Listar: Lista conjuntos de uma campanha
• Deletar: Remove conjunto
• Duplicar: Shallow (so conjunto) ou Deep (conjunto + ads)

Ad (Anuncio)

• Criar: Cria anuncio vinculado a criativo
• Atualizar: Atualiza nome, status, criativo
• Obter: Retorna dados de um anuncio
• Listar: Lista anuncios de um conjunto
• Deletar: Remove anuncio
• Duplicar: Copia anuncio existente

AdCreative (Criativo)

• Criar: Cria criativo (post existente, imagem, video, carrossel)
• Obter: Retorna dados de um criativo
• Listar: Lista criativos da conta

Midia

• Upload Imagem: Envia imagem e retorna image_hash
• Upload Video (Simples): Envia video via URL e retorna video_id
• Upload Video Completo: Upload + aguarda processamento + retorna thumbnail

Insights

• Relatório Completo: Extração em massa com todos os parâmetros avançados (level, time_increment, action_types, etc)
• Obter por ID: Metricas de objeto específico (campanha/conjunto/anúncio)

Audience (Publico)

• Criar: Cria publico personalizado com regra JSON
• Listar Salvos: Publicos salvos da conta
• Listar Personalizados: Custom audiences
• Buscar Interesses: Pesquisa de interesses disponiveis
• Buscar Localizacao: Pesquisa de localizacoes

Objetivos de Campanha Disponiveis

| Nome | Valor API | |------|-----------| | Reconhecimento | OUTCOME_AWARENESS | | Trafego Site | OUTCOME_TRAFFIC | | Impulsionar Perfil | OUTCOME_TRAFFIC | | Engajamento Post | OUTCOME_ENGAGEMENT | | Visualizacao de Video | OUTCOME_ENGAGEMENT | | WhatsApp | OUTCOME_ENGAGEMENT | | Leads Site | OUTCOME_LEADS | | Formulario Nativo | OUTCOME_LEADS | | Vendas | OUTCOME_SALES |

Instalacao

Instalacao local para desenvolvimento

1. Clone ou copie este projeto
2. Execute npm install
3. Execute npm run build
4. Link simbolico:

npm link
cd ~/.n8n/custom
npm link n8n-nodes-alicia-gt

Iniciar n8n

N8N_CUSTOM_EXTENSIONS="$HOME/.n8n/custom" n8n start

Configuracao de Credenciais

1. No n8n, va em Credentials > New
2. Procure por Alicia GT API
3. Preencha:
   • Access Token: Token de acesso da Meta API
   • Ad Account ID: ID da conta de anuncios (formato: act_123456789)

Como obter o Access Token

1. Acesse Meta for Developers
2. Crie um App tipo Business
3. Adicione o produto Marketing API
4. Gere um token com permissoes:
   • ads_management
   • ads_read
   • business_management

Regras de Negocio

• Budget: Inserir em Reais, convertido automaticamente para centavos
• Datas: Formato ISO 8601
• Status inicial: Recomendado usar PAUSED
• Duplicacao Deep: Copia toda a estrutura (campanha + adsets + ads)

Versao da API

Este node usa a API v23.0 do Facebook/Meta.

Licenca

MIT