MAILCHIMP Lists Update - Atualizar Lista

O que é este Node?

O Mailchimp Lists Update é o node responsável por atualizar configurações de uma lista existente no Mailchimp, como nome, lembrete de permissão e outras configurações.

Por que este Node existe?

Listas evoluem e precisam de atualizações. Este node existe para:

Renomear listas: Atualizar nome conforme necessário
Atualizar textos: Modificar permission reminder
Manutenção: Corrigir informações desatualizadas
Compliance: Ajustar textos legais
Organização: Manter listas com informações corretas

Como funciona internamente?

Quando o Lists Update é executado, o sistema:

Valida credenciais e listId
Monta objeto apenas com campos a atualizar
Faz requisição PATCH para /lists/{listId}
Recebe lista atualizada
Salva na variável especificada
Continua o flow

Código interno (mailchimp.executor.ts:103-115):

case 'update':
  const updateListId = this.replaceVariables(data.listId || '', context.variables);
  const updateData: any = {};
  if (data.listName) updateData.name = this.replaceVariables(data.listName, context.variables);
  if (data.permissionReminder) updateData.permission_reminder = this.replaceVariables(data.permissionReminder, context.variables);

  const updateResponse = await axios.patch(`${baseUrl}/lists/${updateListId}`, updateData, {
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
  });
  return updateResponse.data;

Quando você DEVE usar este Node?

Use Lists Update quando precisar modificar lista existente:

Casos de uso:

Renomear: "Newsletter 2024" → "Newsletter 2025"
Corrigir textos: Atualizar permission reminder
Reorganização: Padronizar nomes de listas
Compliance: Atualizar textos legais
Manutenção: Corrigir erros de digitação

Quando NÃO usar Lists Update:

Adicionar assinantes: Use Members Add
Alterar configurações de campanha: Já enviadas não mudam
Mudar List ID: ID é imutável

Parâmetros Detalhados

listId (string, obrigatório)

O que é: ID da lista a ser atualizada.

Formato: String alfanumérica do Mailchimp

listName (string, opcional)

O que é: Novo nome para a lista.

Exemplo: "Newsletter Principal 2025"

Flow completo para testar:

{
  "name": "Teste Mailchimp Lists Update - Nome",
  "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": "Atualizar Nome",
        "resource": "lists",
        "operation": "update",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "listId": "{{my_list_id}}",
        "listName": "Newsletter Principal - Atualizado 2025",
        "responseVariable": "updatedList"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "✅ Lista atualizada!\n\nNovo nome: {{updatedList.name}}"
        }
      }
    },
    {
      "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" }
  ]
}

Teste: O nome da lista será atualizado no Mailchimp!

permissionReminder (string, opcional)

O que é: Novo texto do lembrete de permissão.

Exemplo: "Você está recebendo porque se inscreveu em nosso site."

Parâmetros

Campo	Tipo	Obrigatório	Descrição
listId	string	Sim	ID da lista a atualizar
listName	string	Não	Novo nome da lista
permissionReminder	string	Não	Novo texto de permissão

Exemplo 1: Renomear Lista para Novo Ano

Objetivo: Atualizar nome da lista automaticamente no início do ano.

JSON para Importar

{
  "name": "Renomear Lista para 2025",
  "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 Ano",
        "parameters": {
          "variable": "current_year",
          "value": "2025"
        }
      }
    },
    {
      "id": "mailchimp_1",
      "type": "mailchimp",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Atualizar Lista",
        "resource": "lists",
        "operation": "update",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "listId": "{{newsletter_list_id}}",
        "listName": "Newsletter Principal {{current_year}}",
        "responseVariable": "result"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Sucesso",
        "parameters": {
          "message": "🎉 Lista atualizada para {{current_year}}!\n\n✅ {{result.name}}"
        }
      }
    },
    {
      "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" }
  ]
}

Saída esperada:

Sistema: 🎉 Lista atualizada para 2025!

✅ Newsletter Principal 2025

Exemplo 2: Atualizar Permission Reminder

Objetivo: Atualizar texto legal do lembrete de permissão.

JSON para Importar

{
  "name": "Atualizar Permission Reminder",
  "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": "Atualizar Texto Legal",
        "resource": "lists",
        "operation": "update",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "listId": "{{my_list_id}}",
        "permissionReminder": "Você está recebendo este email porque se inscreveu em nosso site. Seus dados são protegidos conforme LGPD. Para cancelar, clique em descadastrar.",
        "responseVariable": "updated"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmação",
        "parameters": {
          "message": "✅ Texto legal atualizado com sucesso!\n\nLista: {{updated.name}}"
        }
      }
    },
    {
      "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: ✅ Texto legal atualizado com sucesso!

Lista: Newsletter Principal

Resposta do Node

{
  "id": "abc123def456",
  "web_id": 123456,
  "name": "Newsletter Principal 2025",
  "contact": {
    "company": "Minha Empresa",
    "address1": "Rua Teste, 123",
    "city": "São Paulo",
    "state": "SP",
    "zip": "01000-000",
    "country": "BR"
  },
  "permission_reminder": "Você está recebendo porque se inscreveu no site.",
  "campaign_defaults": {
    "from_name": "Equipe",
    "from_email": "contato@empresa.com",
    "subject": "Novidades",
    "language": "pt"
  },
  "date_created": "2025-01-15T10:00:00+00:00",
  "stats": {
    "member_count": 1500
  }
}

O que PODE ser atualizado

✅ Pode atualizar: - Nome da lista (name) - Lembrete de permissão (permission_reminder) - Informações de contato (contact) - Configurações padrão de campanha (campaign_defaults)

❌ NÃO pode atualizar: - List ID (imutável) - Data de criação - Estatísticas (calculadas automaticamente) - Web ID

Boas Práticas

✅ SIM: - Atualize apenas campos necessários - Use nomes descritivos e padronizados - Mantenha permission reminder claro e legal - Atualize em lote quando possível

❌ NÃO: - Não mude nomes drasticamente (confunde usuários) - Não remova informações legais - Não atualize desnecessariamente

Dicas

💡 Parcial: Só envie campos que quer atualizar 💡 Compliance: Sempre revise textos legais com jurídico 💡 Histórico: Mailchimp mantém histórico de mudanças 💡 Nomenclatura: Use padrão consistente para facilitar busca

Próximos Passos

→ Lists Get - Verificar lista após atualização → Lists Delete - Excluir lista → Members List - Ver assinantes da lista