MAILCHIMP Lists Get - Buscar Lista Específica

O que é este Node?

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

Por que este Node existe?

Obter informações detalhadas de uma lista é crucial. Este node existe para:

Validação: Verificar se lista existe antes de usar
Estatísticas: Obter métricas detalhadas da lista
Configurações: Consultar configurações atuais
Auditoria: Verificar dados de uma lista específica
Decisões: Usar stats para lógica condicional

Como funciona internamente?

Quando o Lists Get é executado, o sistema:

Valida credenciais e List ID
Substitui variáveis no listId
Faz requisição GET para /lists/{listId}
Recebe dados completos da lista
Salva na variável especificada
Continua o flow

Código interno (mailchimp.executor.ts:94-101):

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

Quando você DEVE usar este Node?

Use Lists Get quando precisar detalhes de uma lista específica:

Casos de uso:

Validação: Confirmar que lista existe
Stats: Verificar número de assinantes
Decisões: "Se lista tem > 1000 membros, faça X"
Informações: Mostrar link de inscrição
Auditoria: Verificar configurações da lista

Parâmetros Detalhados

listId (string, obrigatório)

O que é: ID único da lista no Mailchimp.

Formato: String alfanumérica (ex: "abc123def456")

Onde encontrar: No resultado de Lists Create ou Lists List

Flow completo para testar:

{
  "name": "Teste Mailchimp Lists Get",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "variable_1",
      "type": "variable",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Definir List ID",
        "parameters": {
          "variable": "my_list_id",
          "value": "abc123def456"
        }
      }
    },
    {
      "id": "mailchimp_1",
      "type": "mailchimp",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Buscar Lista",
        "resource": "lists",
        "operation": "get",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "listId": "{{my_list_id}}",
        "responseVariable": "listDetails"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Mostrar Detalhes",
        "parameters": {
          "message": "📋 {{listDetails.name}}\n\n👥 Assinantes: {{listDetails.stats.member_count}}\n📧 Taxa de abertura: {{listDetails.stats.open_rate}}%\n🔗 Link: {{listDetails.subscribe_url_short}}"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 900, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "variable_1" },
    { "source": "variable_1", "target": "mailchimp_1" },
    { "source": "mailchimp_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Teste: Substitua "abc123def456" por um List ID real da sua conta!

Parâmetros

Campo	Tipo	Obrigatório	Descrição
listId	string	Sim	ID único da lista no Mailchimp

Exemplo 1: Verificar Tamanho da Lista

Objetivo: Verificar quantos assinantes tem uma lista antes de enviar campanha.

JSON para Importar

{
  "name": "Verificar Tamanho da Lista",
  "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 Lista",
        "resource": "lists",
        "operation": "get",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "listId": "{{target_list_id}}",
        "responseVariable": "list"
      }
    },
    {
      "id": "condition_1",
      "type": "condition",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Verificar Tamanho",
        "parameters": {
          "condition": "{{list.stats.member_count}} > 100"
        }
      }
    },
    {
      "id": "message_yes",
      "type": "message",
      "position": { "x": 700, "y": 50 },
      "data": {
        "label": "Lista Grande",
        "parameters": {
          "message": "✅ Lista tem {{list.stats.member_count}} assinantes. Pode prosseguir com campanha!"
        }
      }
    },
    {
      "id": "message_no",
      "type": "message",
      "position": { "x": 700, "y": 150 },
      "data": {
        "label": "Lista Pequena",
        "parameters": {
          "message": "⚠️ Lista tem apenas {{list.stats.member_count}} assinantes. Considere aguardar mais inscrições."
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 900, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "mailchimp_1" },
    { "source": "mailchimp_1", "target": "condition_1" },
    { "source": "condition_1", "target": "message_yes", "label": "true" },
    { "source": "condition_1", "target": "message_no", "label": "false" },
    { "source": "message_yes", "target": "end_1" },
    { "source": "message_no", "target": "end_1" }
  ]
}

Saída esperada:

Sistema: ✅ Lista tem 1500 assinantes. Pode prosseguir com campanha!

Exemplo 2: Mostrar Link de Inscrição

Objetivo: Buscar e compartilhar link de inscrição da lista.

JSON para Importar

{
  "name": "Compartilhar Link de Inscrição",
  "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 Lista",
        "resource": "lists",
        "operation": "get",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "listId": "{{newsletter_list_id}}",
        "responseVariable": "newsletter"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Compartilhar Link",
        "parameters": {
          "message": "📧 INSCREVA-SE NA NOSSA NEWSLETTER!\n\n📋 {{newsletter.name}}\n👥 Já somos {{newsletter.stats.member_count}} inscritos\n\n🔗 Link: {{newsletter.subscribe_url_short}}\n\nClique para se inscrever!"
        }
      }
    },
    {
      "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" }
  ]
}

Saída esperada:

Sistema: 📧 INSCREVA-SE NA NOSSA NEWSLETTER!

📋 Newsletter Semanal
👥 Já somos 1500 inscritos

🔗 Link: http://eepurl.com/xyz

Clique para se inscrever!

Resposta do Node

{
  "id": "abc123def456",
  "web_id": 123456,
  "name": "Newsletter Principal",
  "contact": {
    "company": "Minha Empresa",
    "address1": "Rua Teste, 123",
    "city": "São Paulo",
    "state": "SP",
    "zip": "01000-000",
    "country": "BR"
  },
  "permission_reminder": "Você se inscreveu no site",
  "campaign_defaults": {
    "from_name": "Equipe",
    "from_email": "contato@empresa.com",
    "subject": "Novidades",
    "language": "pt"
  },
  "email_type_option": true,
  "subscribe_url_short": "http://eepurl.com/xyz",
  "subscribe_url_long": "https://empresa.us1.list-manage.com/subscribe?u=...",
  "date_created": "2025-01-15T10:00:00+00:00",
  "list_rating": 4,
  "stats": {
    "member_count": 1500,
    "unsubscribe_count": 45,
    "cleaned_count": 12,
    "member_count_since_send": 120,
    "unsubscribe_count_since_send": 5,
    "cleaned_count_since_send": 2,
    "campaign_count": 25,
    "campaign_last_sent": "2025-10-01T14:30:00+00:00",
    "merge_field_count": 5,
    "avg_sub_rate": 15,
    "avg_unsub_rate": 0.8,
    "target_sub_rate": 20,
    "open_rate": 23.5,
    "click_rate": 4.2
  }
}

Estatísticas Disponíveis

A resposta inclui stats detalhados:

Stat	Descrição
member_count	Total de assinantes ativos
unsubscribe_count	Total de descadastros
cleaned_count	Emails inválidos removidos
campaign_count	Total de campanhas enviadas
open_rate	Taxa média de abertura (%)
click_rate	Taxa média de cliques (%)
avg_sub_rate	Taxa média de inscrições
avg_unsub_rate	Taxa média de descadastros

Boas Práticas

✅ SIM: - Valide listId antes de usar em outras operações - Use stats para decisões inteligentes - Guarde subscribe_url para compartilhar - Verifique list_rating (qualidade da lista)

❌ NÃO: - Não assuma que lista existe - Não ignore erros 404

Dicas

💡 List Rating: 1-5 estrelas, indica qualidade da lista 💡 Stats: Use para métricas de desempenho 💡 Subscribe URL: Use subscribe_url_short (mais curto) 💡 Validação: Sempre verifique se lista existe antes de usar

Próximos Passos

→ Lists Update - Atualizar configurações da lista → Members Add - Adicionar assinantes → Campaigns Create - Criar campanha para esta lista