Pular para conteúdo

MAILCHIMP Campaigns List - Listar Campanhas

O que é este Node?

O Mailchimp Campaigns List é o node responsável por listar todas as campanhas da conta com filtros e paginação.

Por que este Node existe?

Consultar campanhas é essencial para gestão. Este node existe para:

  1. Auditoria: Ver todas as campanhas criadas
  2. Relatórios: Gerar relatórios de campanhas
  3. Filtros: Buscar campanhas por status
  4. Integração: Sincronizar com dashboards
  5. Monitoramento: Acompanhar envios

Como funciona internamente?

Código interno (mailchimp.executor.ts:280-291):

case 'list':
  const listCampaignsResponse = await axios.get(`${baseUrl}/campaigns`, {
    headers: {
      'Authorization': `Bearer ${apiKey}`,
    },
    params: {
      count: data.count || 100,
      offset: data.offset || 0,
      status: data.status,
    },
  });
  return listCampaignsResponse.data;

Parâmetros

Campo Tipo Obrigatório Descrição
count number Não Quantidade por página (padrão: 100, máx: 1000)
offset number Não Itens a pular (padrão: 0)
status string Não Filtro: save, sending, sent, paused

Status de Campanhas

  • save: Salva mas não enviada
  • sending: Sendo enviada agora
  • sent: Enviada completamente
  • paused: Pausada
  • schedule: Agendada

Exemplo: Listar Campanhas Enviadas

{
  "name": "Listar Últimas Campanhas Enviadas",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "mailchimp_1",
      "type": "mailchimp",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Buscar Campanhas",
        "resource": "campaigns",
        "operation": "list",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "count": 10,
        "offset": 0,
        "status": "sent",
        "responseVariable": "campaigns"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Mostrar Total",
        "parameters": {
          "message": "📊 CAMPANHAS ENVIADAS\n\n✅ Total: {{campaigns.total_items}}\n📄 Mostrando: {{campaigns.campaigns.length}} últimas"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "mailchimp_1" },
    { "source": "mailchimp_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Resposta do Node

{
  "campaigns": [
    {
      "id": "abc123",
      "web_id": 123456,
      "type": "regular",
      "status": "sent",
      "settings": {
        "subject_line": "Oferta Especial",
        "title": "Campanha Outubro 2025",
        "from_name": "Equipe Lumina"
      },
      "recipients": {
        "list_id": "xyz789",
        "recipient_count": 1500
      },
      "send_time": "2025-10-13T14:00:00+00:00"
    }
  ],
  "total_items": 45
}

Próximos Passos

Campaigns Get - Detalhes de campanha específica → Campaigns Create - Criar nova campanha