Cum abonezi automat respondenții la audience-ul Mailchimp cu consimțământ explicit

Pe scurt

Conectezi Megaforms cu Mailchimp prin API Key (sau OAuth) și mapezi audience-ul țintă plus tag-urile aplicate. Critic pentru conformitate GDPR: bifa de consimțământ marketing din formular trebuie să fie un câmp distinct, non-pre-bifat. Megaforms trimite la Mailchimp doar respondenții care au bifat explicit, cu status `subscribed` (sau `pending` dacă vrei double opt-in nativ Mailchimp). Pentru ceilalți, respondenții fără bifă, nu se trimite niciun apel API — datele rămân doar în Megaforms ca lead intern. Jurnalul de consimțământ (text exact + marcă de timp + IP) e păstrat 5 ani conform recomandării CNIL și e exportabil pentru audit. Pentru Moldova, conformitate analogică cu Legea 133/2011 privind protecția datelor cu caracter personal.

Caz de utilizare tipic

Pași de implementare (pe baza setup-ului Mailchimp)

Scenariul refolosește configurarea de bază a integrării Mailchimp, cu ajustări specifice descrise mai jos. Dacă nu ai configurat încă integrarea, parcurge întâi pașii standard:

1. 1
   Obține API Key Mailchimp

   În Mailchimp → Account → Extras → API Keys → Create A Key. Copiază cheia (format `xxxxxxxxxxxxxx-us21`, ultimele 5 caractere = data center).

2. 2
   Identifică Audience (List) ID

   În Mailchimp → Audience → Settings → Audience name and defaults → vei vedea Audience ID în partea dreaptă. Copiază-l.

3. 3
   Adaugă consent marketing în formular

   În Megaforms → formular → adaugă un câmp tip Checkbox cu label „Vreau să primesc newsletter săptămânal de la ___”. OBLIGATORIU non-pre-bifat. Salvează.

4. 4
   Conectează în Megaforms

   Megaforms → Integrări → Mailchimp. Lipește API key și Audience ID. Setează „Trimite doar dacă consent_marketing == true” (referind la checkbox-ul de la pas 3).

5. 5
   Mapează merge fields și tags

   Maparea Megaforms email → Mailchimp EMAIL, first_name → FNAME etc. Adaugă tag-uri statice (ex. `megaforms`, `lead-magnet-2026q3`).

6. 6
   Activează double opt-in (recomandat EU)

   Setează status `pending` în loc de `subscribed`. Mailchimp trimite email confirmare la respondent; abia după click confirmare devine subscribed. Conformitate maximă GDPR.

Exemplu cod / payload

// Apel Megaforms → Mailchimp (POST member)
POST /3.0/lists/{audience_id}/members
Authorization: Bearer {mailchimp_api_key}
{
  "email_address": "{{submission.email}}",
  "status": "subscribed",  // sau "pending" pentru double opt-in
  "merge_fields": {
    "FNAME": "{{submission.first_name}}",
    "LNAME": "{{submission.last_name}}",
    "PHONE": "{{submission.phone}}"
  },
  "tags": ["megaforms", "{{form.slug}}"],
  "marketing_permissions": [
    { "marketing_permission_id": "perm_id_xyz", "enabled": true }
  ]
}

Variabilele între acolade duble (ex. `{{submission.email}}`) sunt înlocuite automat de Megaforms la fiecare submisie. Lista completă a variabilelor în Setări → Integrări → Documentație variabile.

Erori frecvente și depanare

• ⚠401 Unauthorized — credențialele sunt invalide sau au fost revocate. Regenerează în panoul Mailchimp și re-introdu în Megaforms.
• ⚠404 Not Found — endpoint-ul țintă (chat_id, database_id, webhook URL) nu există sau nu e accesibil. Verifică în panoul Mailchimp că destinația e validă.
• ⚠422 Unprocessable Entity — payload-ul nu respectă schema așteptată (ex. valoare Multiple Select care nu există ca opțiune predefinită). Verifică maparea câmpurilor.
• ⚠429 Too Many Requests — rate limit atins. Megaforms reîncearcă automat cu backoff. Pentru volume mari, considerează rutarea prin webhook generic + n8n self-hosted.
• ⚠500/502/503 — eroare temporară pe serverul Mailchimp. Megaforms reîncearcă automat. Verifică status page-ul Mailchimp dacă persistă.

Conformitate și securitate

• ✓Apelurile către Mailchimp sunt jurnalizate cu timestamp, status code și error message — fără date personale ale respondenților.
• ✓Credențialele sunt criptate AES-256 la rest. Nu apar în log-uri sau exporturi.
• ✓Apelurile către Mailchimp ies de pe servere Megaforms situate în UE (OVH Franța). Destinația finală depinde de provider — vezi pagina de bază a integrării pentru detalii.
• ✓Retry automat 3 încercări (2s, 8s, 30s). Dead-letter queue cu retry manual din panoul de control.

Următorii pași

După ce ai configurat scenariul, recomandăm să monitorizezi primele 50-100 apeluri în Setări → Integrări → Istoric apeluri pentru a confirma că rata de succes e peste 99% și că payload-ul ajunge formatat corect la destinație. Pentru ajustări fine (filtre adiționale, mapare câmpuri, șabloane custom), editarea se face direct în conectorul integrării fără a re-configura tot scenariul.

Pentru scenarii compuse (ex. același formular trimite la Slack + Notion + Mailchimp în paralel), poți activa mai multe integrări per formular și folosi logica condițională pentru a alege care se declanșează la fiecare submisie. Vezi documentația despre rutare condițională în articolele de ajutor.