MAILCHIMP Campaigns Create - Criar Campanha

O que é este Node?

O Mailchimp Campaigns Create é o node responsável por criar uma nova campanha de email com título, assunto, remetente e lista de destinatários.

Por que este Node existe?

Campanhas são a essência do email marketing. Este node existe para:

1. Automação: Criar campanhas dinamicamente baseado em eventos
2. Personalização: Gerar campanhas com dados variáveis
3. Escala: Criar múltiplas campanhas automaticamente
4. Integração: Conectar com outros sistemas
5. Eficiência: Eliminar criação manual

Como funciona internamente?

Código interno (mailchimp.executor.ts:236-255):

case 'create':
  const campaignData = {
    type: data.type || 'regular', // regular, plaintext, absplit, rss, variate
    recipients: {
      list_id: this.replaceVariables(data.listId || '', context.variables),
    },
    settings: {
      subject_line: this.replaceVariables(data.subject || '', context.variables),
      from_name: this.replaceVariables(data.fromName || '', context.variables),
      reply_to: this.replaceVariables(data.replyTo || '', context.variables),
      title: this.replaceVariables(data.title || '', context.variables),
    },
  };

  const createCampaignResponse = await axios.post(`${baseUrl}/campaigns`, campaignData, {
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
  });
  return createCampaignResponse.data;

Parâmetros

Campo	Tipo	Obrigatório	Descrição
type	string	Não	regular, plaintext, absplit, rss (padrão: "regular")
listId	string	Sim	ID da lista de destinatários
subject	string	Sim	Assunto do email
fromName	string	Sim	Nome do remetente
replyTo	string	Sim	Email de resposta
title	string	Sim	Título interno da campanha

Tipos de Campanha

• regular: Campanha padrão HTML
• plaintext: Apenas texto
• absplit: Teste A/B
• rss: Baseada em RSS feed
• variate: Teste multivariável

Exemplo: Criar Campanha de Lançamento

{
  "name": "Criar Campanha de Lançamento de Produto",
  "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": "Dados do Produto",
        "parameters": {
          "variable": "produto_nome",
          "value": "Curso Avançado de Marketing"
        }
      }
    },
    {
      "id": "mailchimp_1",
      "type": "mailchimp",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Criar Campanha",
        "resource": "campaigns",
        "operation": "create",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "type": "regular",
        "listId": "{{newsletter_list_id}}",
        "subject": "🚀 Lançamento: {{produto_nome}}",
        "fromName": "Equipe Lumina",
        "replyTo": "contato@lumina.com.br",
        "title": "Campanha Lançamento - {{produto_nome}} - 2025",
        "responseVariable": "campaign"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Sucesso",
        "parameters": {
          "message": "✅ Campanha criada!\n\n📋 {{campaign.settings.title}}\n🆔 ID: {{campaign.id}}\n📧 Assunto: {{campaign.settings.subject_line}}\n\n⚠️ Lembre-se de adicionar o conteúdo antes de enviar!"
        }
      }
    },
    {
      "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" }
  ]
}

Resposta do Node

{
  "id": "abc123campaign",
  "web_id": 123456,
  "type": "regular",
  "status": "save",
  "settings": {
    "subject_line": "🚀 Lançamento: Curso Avançado de Marketing",
    "title": "Campanha Lançamento - Curso Avançado de Marketing - 2025",
    "from_name": "Equipe Lumina",
    "reply_to": "contato@lumina.com.br"
  },
  "recipients": {
    "list_id": "abc123list",
    "recipient_count": 1500
  },
  "create_time": "2025-10-13T10:00:00+00:00"
}

Status da Campanha

• save: Criada mas não enviada
• sending: Sendo enviada
• sent: Enviada completamente

Próximos Passos Após Criar

1. Adicionar conteúdo: Configure HTML/texto no Mailchimp
2. Testar: Envie email de teste
3. Agendar ou Enviar: Use Campaigns Send ou Campaigns Schedule

Boas Práticas

✅ SIM: - Use títulos descritivos para organização - Configure reply_to com email monitorado - Teste assunto antes de enviar - Guarde campaign ID para envio posterior

❌ NÃO: - Não crie campanha e envie imediatamente - Não esqueça de adicionar conteúdo - Não use emails genéricos no fromName

Próximos Passos

→ Campaigns Send - Enviar campanha criada → Campaigns Schedule - Agendar envio → Campaigns Get - Verificar detalhes