MAILCHIMP Campaigns Schedule - Agendar Campanha

O que é este Node?

O Mailchimp Campaigns Schedule é o node responsável por agendar envio futuro de uma campanha em data e hora específicas.

Por que este Node existe?

Timing é crucial no email marketing. Este node existe para:

1. Horário ideal: Enviar no melhor momento
2. Planejamento: Programar campanhas com antecedência
3. Fusos horários: Considerar audiência global
4. Automação: Agendar baseado em eventos
5. Organização: Preparar múltiplas campanhas

Como funciona internamente?

Código interno (mailchimp.executor.ts:266-278):

case 'schedule':
  const scheduleCampaignId = this.replaceVariables(data.campaignId || '', context.variables);
  const scheduleTime = this.replaceVariables(data.scheduleTime || '', context.variables);

  const scheduleResponse = await axios.post(`${baseUrl}/campaigns/${scheduleCampaignId}/actions/schedule`, {
    schedule_time: scheduleTime,
  }, {
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
  });
  return { success: true, message: 'Campaign scheduled' };

Parâmetros

Campo	Tipo	Obrigatório	Descrição
campaignId	string	Sim	ID da campanha a agendar
scheduleTime	string	Sim	Data/hora em formato ISO 8601 (UTC)

Formato de Data

O scheduleTime deve estar em ISO 8601 (UTC):

Formato: YYYY-MM-DDTHH:MM:SS+00:00

Exemplos: - 2025-10-15T14:00:00+00:00 (15 out 2025, 14h UTC) - 2025-12-25T09:30:00+00:00 (25 dez 2025, 9h30 UTC)

Exemplo: Agendar para Próxima Semana

{
  "name": "Agendar Campanha para Próxima Semana",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "variable_campaign",
      "type": "variable",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Campaign ID",
        "parameters": {
          "variable": "campaign_id",
          "value": "abc123campaign"
        }
      }
    },
    {
      "id": "variable_date",
      "type": "variable",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Data de Envio",
        "parameters": {
          "variable": "send_date",
          "value": "2025-10-20T10:00:00+00:00"
        }
      }
    },
    {
      "id": "mailchimp_1",
      "type": "mailchimp",
      "position": { "x": 700, "y": 100 },
      "data": {
        "label": "Agendar Campanha",
        "resource": "campaigns",
        "operation": "schedule",
        "config": {
          "apiKey": "{{mailchimp_api_key}}",
          "server": "{{mailchimp_server}}"
        },
        "campaignId": "{{campaign_id}}",
        "scheduleTime": "{{send_date}}",
        "responseVariable": "scheduled"
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 900, "y": 100 },
      "data": {
        "label": "Confirmação",
        "parameters": {
          "message": "📅 Campanha agendada com sucesso!\n\n🕐 Envio programado para:\n{{send_date}}\n\n✅ A campanha será enviada automaticamente no horário programado."
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 1100, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "variable_campaign" },
    { "source": "variable_campaign", "target": "variable_date" },
    { "source": "variable_date", "target": "mailchimp_1" },
    { "source": "mailchimp_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Resposta do Node

{
  "success": true,
  "message": "Campaign scheduled"
}

Melhores Horários para Envio

📊 Estatísticas gerais:

Dias da semana: - ✅ Terça, Quarta, Quinta: Melhor taxa de abertura - ⚠️ Segunda: Caixa cheia (evite) - ❌ Sábado/Domingo: Menor engajamento

Horários: - ✅ 10h-11h: Alto engajamento - ✅ 14h-15h: Bom para B2B - ⚠️ 6h-8h: Disputa com outros emails - ❌ Após 18h: Menor abertura

Sempre teste seu público específico!

Cancelar Agendamento

Para cancelar campanha agendada, use a API do Mailchimp:

POST /campaigns/{campaign_id}/actions/unschedule

Boas Práticas

✅ SIM: - Agende com 24h+ de antecedência - Considere fuso horário da audiência - Teste melhores horários para seu público - Agende em horários comerciais - Evite feriados

❌ NÃO: - Não agende muito próximo (< 1h) - Não ignore fuso horário - Não envie em madrugadas - Não agende sem testar

Próximos Passos

→ Campaigns Send - Envio imediato (alternativa) → Campaigns Get - Verificar agendamento