Mailchimp Email Marketing - Documentação Completa

Visão Geral

O Mailchimp é um conjunto de nodes para integração completa com a plataforma Mailchimp, permitindo gerenciar listas de email, assinantes, campanhas de email marketing e automações diretamente nos seus flows do Lumina.

Por que usar Mailchimp no Lumina?

A integração Mailchimp existe para:

Email Marketing Automatizado: Crie e envie campanhas de email diretamente dos seus flows
Gestão de Audiência: Adicione, atualize e gerencie assinantes em suas listas
Automação Inteligente: Controle automações de email baseadas no comportamento do usuário
Integração com WhatsApp: Conecte conversas do WhatsApp com estratégias de email marketing
Sincronização de Dados: Mantenha suas listas sincronizadas com dados do Lumina

Recursos Disponíveis

1. Lists (Listas)

Gerenciar listas de audiência no Mailchimp.

create - Criar nova lista de audiência
list - Listar todas as listas da conta
get - Buscar detalhes de uma lista específica
update - Atualizar configurações de uma lista
delete - Excluir uma lista

2. Members (Assinantes)

Gerenciar assinantes dentro das listas.

add - Adicionar novo assinante à lista
update - Atualizar dados de um assinante
get - Buscar informações de um assinante
list - Listar todos os assinantes de uma lista
delete - Remover assinante da lista

3. Campaigns (Campanhas)

Criar e gerenciar campanhas de email marketing.

create - Criar nova campanha de email
send - Enviar campanha imediatamente
schedule - Agendar envio de campanha
list - Listar todas as campanhas
get - Buscar detalhes de uma campanha
delete - Excluir campanha

4. Automations (Automações)

Gerenciar automações de email.

list - Listar todas as automações
get - Buscar detalhes de uma automação
pause - Pausar automação ativa
start - Iniciar automação pausada

Configuração Inicial

Para usar qualquer node Mailchimp, você precisa:

1. API Key do Mailchimp

Acesse sua conta Mailchimp
Vá em Account → Extras → API Keys
Clique em Create A Key
Copie a API Key gerada

2. Server Prefix

A API Key do Mailchimp contém o server prefix. Por exemplo: - API Key: abc123def456-us1 - Server: us1

Extraia o sufixo após o hífen (us1, us2, us3, etc.)

3. Configuração no Flow

{
  "config": {
    "apiKey": "sua-api-key-aqui-us1",
    "server": "us1"
  }
}

Casos de Uso Práticos

1. Captura de Leads via WhatsApp

Quando alguém inicia conversa no WhatsApp, adicione automaticamente à lista do Mailchimp:

START → INPUT (captura email) → MAILCHIMP Members Add → MESSAGE (confirmação)

2. Campanha Pós-Compra

Após uma compra, envie campanha de agradecimento:

START → SHOPIFY (detecta compra) → MAILCHIMP Campaign Create → MAILCHIMP Campaign Send

3. Atualização de Preferências

Quando usuário atualiza preferências no WhatsApp, sincronize com Mailchimp:

START → INPUT (nova preferência) → MAILCHIMP Members Update → MESSAGE (confirmação)

4. Segmentação Inteligente

Adicione tags baseadas no comportamento:

START → CONDITION (verifica comportamento) → MAILCHIMP Members Add (com tags) → END

Estrutura Comum de Nodes

Todos os nodes Mailchimp seguem esta estrutura:

{
  "id": "mailchimp_1",
  "type": "mailchimp",
  "data": {
    "label": "Ação Mailchimp",
    "resource": "lists|members|campaigns|automations",
    "operation": "create|list|get|update|delete|add|send|schedule|pause|start",
    "config": {
      "apiKey": "{{mailchimp_api_key}}",
      "server": "{{mailchimp_server}}"
    },
    "responseVariable": "mailchimpResult",
    // Parâmetros específicos da operação
  }
}

Variável de Resposta

Por padrão, todos os nodes salvam o resultado em mailchimpResult, mas você pode customizar:

{
  "responseVariable": "minhaVariavel"
}

Autenticação e Segurança

Usar Variáveis para API Key

NUNCA coloque a API Key direto no flow. Use variáveis:

{
  "config": {
    "apiKey": "{{mailchimp_api_key}}",
    "server": "{{mailchimp_server}}"
  }
}

Onde Guardar a API Key

Variáveis de Ambiente: Configure no sistema
Variáveis do Flow: Defina no início do flow
VARIABLE Node: Carregue de fonte segura

Limites da API Mailchimp

Respeite os limites da API:

Rate Limit: 10 requisições por segundo
Timeout: 120 segundos por requisição
Batch Operations: Use para múltiplas operações

Dica: Use DELAY entre múltiplas chamadas.

Tratamento de Erros

Todos os nodes retornam erros quando:

API Key inválida
Server prefix incorreto
Lista não encontrada
Email duplicado
Limites excedidos

Dica: Use CONDITION para verificar mailchimpResult.success.

Exemplos Avançados

Automação Completa de Email Marketing

{
  "name": "Automação Email Marketing Completa",
  "nodes": [
    {
      "id": "start_1",
      "type": "start"
    },
    {
      "id": "input_email",
      "type": "email",
      "data": {
        "parameters": {
          "message": "Qual é o seu email?",
          "variable": "user_email"
        }
      }
    },
    {
      "id": "input_nome",
      "type": "input",
      "data": {
        "parameters": {
          "message": "Qual é o seu nome?",
          "variable": "user_name"
        }
      }
    },
    {
      "id": "add_member",
      "type": "mailchimp",
      "data": {
        "resource": "members",
        "operation": "add",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "listId": "{{mailchimp_list_id}}",
        "email": "{{user_email}}",
        "status": "subscribed",
        "mergeFields": "{\"FNAME\": \"{{user_name}}\"}"
      }
    },
    {
      "id": "message_success",
      "type": "message",
      "data": {
        "parameters": {
          "message": "✅ Você foi inscrito com sucesso! Em breve receberá nossos emails."
        }
      }
    }
  ]
}

Boas Práticas

✅ SIM: - Use variáveis para API Key (nunca hardcode) - Valide emails antes de adicionar à lista - Use tags para segmentação - Configure merge fields para personalização - Use status "pending" para double opt-in - Trate erros de email duplicado - Respeite rate limits

❌ NÃO: - Não exponha API Keys no código - Não adicione emails sem validação - Não envie campanhas sem teste - Não ignore erros da API - Não abuse de chamadas (rate limit) - Não force opt-in sem permissão

Dicas Importantes

💡 Double Opt-In: Use status "pending" e deixe Mailchimp enviar confirmação 💡 Merge Fields: Personalize emails com dados do assinante (FNAME, LNAME, etc.) 💡 Tags: Use para segmentação dinâmica 💡 Automações: Configure no Mailchimp e controle via API 💡 Testing: Sempre teste campanhas antes de enviar 💡 GDPR: Respeite regulamentações de privacidade

Recursos Externos

Próximos Passos

Comece explorando as operações básicas:

Lists Create - Crie sua primeira lista
Members Add - Adicione assinantes
Campaigns Create - Crie uma campanha
Campaigns Send - Envie para seus assinantes

Suporte

Problemas comuns e soluções:

Problema	Solução
API Key inválida	Verifique no Mailchimp Account → API Keys
Server prefix errado	Extraia da API Key (após o hífen)
Email já existe	Use Members Update ao invés de Add
Lista não encontrada	Confirme o List ID no Mailchimp
Rate limit excedido	Adicione DELAY entre chamadas

Total de Operações Documentadas: 18 tools

Versão: 1.0.0 Última Atualização: 2025-10-13