Mailchimp

Descrizione

Connettore enterprise per Mailchimp — la piattaforma email marketing & marketing automation pioniere del settore (fondata 2001, acquisita da Intuit 2021 per $12B, 13M+ utenti registered + 2.5M+ paying customer business soprattutto SMB e creator) leader globale del consumer email marketing con feature rich per campagne ricorrenti, automation workflow, audience segmentation, analytics dettagliata, A/B testing — via Marketing API v3.0 ufficiale. Tre operazioni atomiche coprono il pattern di sync principale tra workflow business e Mailchimp audience: addMember (upsert idempotent del subscriber nella audience target — Mailchimp API richiede di passare il MD5 hash lowercase dell'email come identifier per le operazioni member-level, il nodo computa automatic questo hash e lo usa per accesso PUT che è naturally idempotent — pattern critico per evitare duplicati su re-run del workflow), getMember (fetch dello stato iscrizione di un subscriber: subscribed, unsubscribed, pending, cleaned, transactional + valori dei merge fields custom come FNAME, LNAME, COMPANY, BIRTHDAY), addTag (applicazione di tag al subscriber per segmentation downstream nelle campagne — i tag sono il modo principale di Mailchimp di categorizzare audience oltre alle group/list-level fields). Auth via API Key formato unique 32-hex con suffix -us17 / -us12 / -eu1 / etc. che identifica il datacenter geografico del account Mailchimp (il nodo parse il suffix e construct correttamente l'URL base API tipo https://us17.api.mailchimp.com/3.0/ — pattern Mailchimp che molti developer sbagliano), usato come HTTP Basic Auth username "anystring" + password=apiKey. Stored nel vault integration FlowForge. Multi-account supportato (un tenant FlowForge che gestisce 10 audience Mailchimp di N customer separati). Pipeline standard FlowForge: SSRF-safe gateway, circuit-breaker per-host dedicato (importante per multi-datacenter — un outage su us17 NON deve bloccare workflow di altro account su eu1), retry exponential backoff su 5xx + 429. Rate limit Mailchimp: 10 concurrent connection per API key + soft limit per minute (varies per account tier — Pro/Premium hanno cap più alti). Output: { memberId? (MD5 hash dell'email, sempre presente perché derivable), status? (subscription state), member? (object completo per getMember), tagged? (boolean per addTag), email, datacenterUsed }. Use case: aggiungi lead da form/scraping alla newsletter aziendale (trigger_form submit → community_mailchimp addMember nella audience "Newsletter generale" con FNAME/LNAME merge fields mapped); sincronizza CRM HubSpot bidirezionale con audience Mailchimp (cron nightly + paginate dei contact HubSpot + upsert in Mailchimp audience corrispondente); tagga automatic contatti per comportamento (es. ordine pagato Stripe webhook → addTag "customer_paid_2026" per uso in trigger di campagna post-acquisto); double opt-in GDPR-compliant da workflow (subscriber status=pending → email di confirmation con link signed → su click → updateMember status=subscribed); nurturing automatico post-evento (webinar attendee → addTag "webinar_xyz_attended" che triggera drip campaign 7-day follow-up); sync iscritti bidirezionale con database tenant per analytics consolidata.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-community_mailchimp-1",
  "defId": "community_mailchimp",
  "label": "Mailchimp",
  "config": {
    "operation": "addMember",
    "listId": "a1b2c3d4e5",
    "email": "[email protected]",
    "status": "subscribed"
  }
}

🔗 Nodi correlati nella stessa categoria