Pular para conteúdo

MAILCHIMP Campaigns Get - Buscar Campanha

O que é este Node?

O Mailchimp Campaigns Get é o node responsável por buscar detalhes completos de uma campanha específica usando seu ID.

Por que este Node existe?

Consultar dados de campanhas é crucial. Este node existe para:

  1. Verificar status: Checar se campanha foi enviada
  2. Estatísticas: Ver opens, clicks, etc.
  3. Validação: Confirmar agendamento
  4. Relatórios: Gerar relatório de campanha
  5. Decisões: Lógica baseada em métricas

Como funciona internamente?

Código interno (mailchimp.executor.ts:293-300):

case 'get':
  const getCampaignId = this.replaceVariables(data.campaignId || '', context.variables);
  const getCampaignResponse = await axios.get(`${baseUrl}/campaigns/${getCampaignId}`, {
    headers: {
      'Authorization': `Bearer ${apiKey}`,
    },
  });
  return getCampaignResponse.data;

Parâmetros

Campo Tipo Obrigatório Descrição
campaignId string Sim ID da campanha

Exemplo: Verificar Resultados de Campanha

{
  "name": "Verificar Resultados de Campanha",
  "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 Campanha",
        "resource": "campaigns",
        "operation": "get",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "campaignId": "{{campaign_id}}",
        "responseVariable": "campaign"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Mostrar Resultados",
        "parameters": {
          "message": "📊 RESULTADOS DA CAMPANHA\n\n📧 {{campaign.settings.subject_line}}\n✅ Status: {{campaign.status}}\n📅 Enviado em: {{campaign.send_time}}\n\n👥 Enviados: {{campaign.emails_sent}}\n📨 Abertos: {{campaign.report_summary.opens}} ({{campaign.report_summary.open_rate}}%)\n🔗 Cliques: {{campaign.report_summary.clicks}} ({{campaign.report_summary.click_rate}}%)"
        }
      }
    },
    {
      "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

{
  "id": "abc123",
  "web_id": 123456,
  "type": "regular",
  "status": "sent",
  "settings": {
    "subject_line": "Oferta Especial",
    "title": "Campanha Outubro",
    "from_name": "Equipe Lumina",
    "reply_to": "contato@lumina.com.br"
  },
  "recipients": {
    "list_id": "xyz789",
    "recipient_count": 1500
  },
  "send_time": "2025-10-13T14:00:00+00:00",
  "emails_sent": 1500,
  "report_summary": {
    "opens": 375,
    "unique_opens": 320,
    "open_rate": 21.3,
    "clicks": 78,
    "subscriber_clicks": 65,
    "click_rate": 4.3
  }
}

Métricas Disponíveis

  • emails_sent: Total enviado
  • opens: Total de aberturas
  • unique_opens: Aberturas únicas
  • open_rate: Taxa de abertura (%)
  • clicks: Total de cliques
  • click_rate: Taxa de cliques (%)

Próximos Passos

Campaigns List - Listar todas → Campaigns Delete - Excluir campanha