La Guida di Mokapen

MailerLite

Collega MailerLite ai contatti della tua organizzazione Mokapen. Importa iscritti e lead già nelle tue liste, mantieni allineati i dati tra email marketing e CRM, oppure esporta verso MailerLite i contatti creati in Mokapen — secondo direzione, filtri e mappatura campi che configuri.

Panoramica generale: Integrazioni.

Requisiti

• Account MailerLite attivo con almeno un iscritto o gruppo da sincronizzare.
• Chiave API MailerLite (Classic o nuova piattaforma MailerLite) con permessi sufficienti a leggere e gestire iscritti.
• Piano Mokapen che include l'integrazione marketing (Premium 3 — icona medaglia in pagina se non disponibile).
• Permessi Mokapen sui contatti in org (vedi Ruoli e permessi).

Collegare MailerLite

A differenza di Google Contacts o MailChimp, MailerLite si collega con la chiave API, non con login OAuth sul sito MailerLite.

1. Menu utente → Integrazioni → MailerLite.
2. Premi Sincronizza MailerLite (serve Premium 3).
3. Apri la sezione Chiave API.
4. Recupera la chiave dal pannello MailerLite (link guida in pagina).
5. Scegli il tipo di account:

• MailerLite Classic — account sulla versione precedente; usa la chiave API «classica».
• MailerLite — account sulla piattaforma attuale; usa il token API della nuova interfaccia.

Tipo sbagliato = connessione fallita anche con chiave valida.

6. Incolla la chiave nel campo e premi Collega.
7. Se la chiave è corretta, compare Account collegato con l'email dell'account MailerLite e le impostazioni di sync.

Se la chiave è errata o scaduta, Mokapen mostra un messaggio di errore in rosso: correggi tipo account o genera una nuova API key in MailerLite, poi disconnetti e ricollega.

Cosa consente la chiave API

La chiave autorizza Mokapen a comunicare con MailerLite via API: leggere iscritti, gruppi e campi personalizzati, creare o aggiornare iscritti quando la direzione sync lo prevede. Non apre una sessione web MailerLite sul tuo browser — conserva la chiave in modo sicuro e non condividerla fuori dal team autorizzato.

Revochi o rigeneri la chiave in MailerLite → la sync in Mokapen smette di funzionare finché non inserisci la nuova chiave (disconnetti e ricollega).

Impostazioni da configurare

Direzione sync

• Solo verso Mokapen — MailerLite → CRM (import iscritti).
• Solo verso MailerLite — CRM → MailerLite (export contatti).
• Entrambe — allineamento nei due sensi, con regole su duplicati e conflitti.

Cambiando direzione compaiono o scompaiono i blocchi filtri «da MailerLite» e «da Mokapen»: segui ciò che vedi in pagina.

Filtri import da MailerLite

Visibile con sync verso Mokapen o bidirezionale. Scegli quali iscritti importare:

• Iscritti attivi — solo iscritti attivi in MailerLite (consigliato per la maggior parte dei casi).
• Tutti gli iscritti — include anche disiscritti o stati non attivi, se presenti.
• Gruppi — limita a un gruppo MailerLite: «appartiene a» o «non appartiene a» il gruppo scelto.
• Campi — filtra per un campo personalizzato MailerLite con operatori (uguale, contiene, inizia con, vuoto, ha un valore, ecc.) e valore testuale.

Modificando i filtri compare un avviso: dopo il cambio conviene rilanciare la sync.

Filtri export verso MailerLite

Visibile quando la direzione sync è verso MailerLite o entrambe. Questi filtri definiscono quali contatti Mokapen possono uscire verso MailerLite — non solo al primo «Sincronizza», ma anche ogni volta che crei o modifichi un contatto in CRM.

In pratica: salvi un contatto in Mokapen → Mokapen controlla se rispetta tipo, tag e consensi privacy che hai impostato → solo se passa tutti i filtri lo crea o aggiorna su MailerLite. Un contatto fuori regola resta in Mokapen ma non viene inviato (e non compare in anteprima export). Se cambi i filtri dopo aver già sincronizzato, conviene rilanciare la sync: i contatti che non matchano più possono smettere di essere aggiornati verso MailerLite.

Tipo e Tipo 2 — restringono l'export a categorie anagrafica del CRM (es. solo «Cliente» o «Lead qualificato»). Utile se in MailerLite vuoi solo un segmento commerciale, non tutta la rubrica.

Tag — uno o più tag contatto: esporta solo chi li ha (es. tag «Newsletter» o «Evento 2026»). Combinabile con Tipo/Tipo 2: devono essere soddisfatti i criteri che hai scelto.

Permessi privacy / GDPR — elenco di caselle con i consensi configurati nella tua org (newsletter, trattamento dati, comunicazioni marketing, ecc.). Spunta solo quelli che devono essere già acquisiti sul contatto perché l'export sia lecito e coerente con il GDPR.

Esempio: spunti solo «Consenso newsletter» → Mokapen invia a MailerLite solo contatti che hanno quel consenso registrato in scheda. Un lead senza consenso marketing resta in CRM ma non finisce su MailerLite, anche se ha email e tag giusti. È il filtro più importante per non iscrivere persone senza base giuridica: configuralo prima di attivare sync automatica verso MailerLite.

Il contatore e il link anteprima in pagina mostrano quanti contatti corrispondono ai filtri adesso, prima di sincronizzare. Usali per verificare che non stai per esportare migliaia di schede per errore o, al contrario, che i filtri non sono troppo stretti (anteprima a zero contatti).

Mappatura campi

Nella sezione Collega campi abbina i campi MailerLite (predefiniti e personalizzati) alle colonne Mokapen. L'email principale resta sul campo email del contatto ed è fissa.

Ogni colonna Mokapen si può usare una sola volta. Lascia vuoto un campo MailerLite se non ti serve in CRM.

Duplicati e conflitti

Quando la stessa persona esiste sia in MailerLite sia in Mokapen (stessa email), Mokapen deve decidere se unire, saltare o aggiornare. Due opzioni in pagina:

Confronto email — sempre attivo e non disattivabile. Prima di creare un contatto da MailerLite, Mokapen cerca in org un contatto con la stessa email: se lo trova, non ne crea un secondo ma aggiorna quello esistente (secondo le regole conflitti sotto). Evita rubriche duplicate dopo la prima importazione massiva.

Gestire confliti — se email uguale ma nome, telefono, azienda o altri campi mappati non coincidono, scegli chi «vince»:

• MailerLite — in caso di discordanza, i valori su MailerLite sovrascrivono quelli in Mokapen alla sync.
• Mokapen — prevale il CRM; MailerLite viene aggiornato con i dati Mokapen quando la direzione sync lo consente.

Consiglio: in import iniziale da liste marketing spesso conviene far prevalere MailerLite sui campi anagrafici; se il CRM è la fonte di verità commerciale, scegli Mokapen. Prova su un campione prima di sync automatica su migliaia di contatti.

Sync automatica o manuale

Decide quando Mokapen esegue l'allineamento, non cosa sincronizzare (quello lo definiscono direzione e filtri).

Sync automatica — Mokapen propaga le modifiche in background: nuovo iscritto su MailerLite può comparire in CRM, modifica contatto in Mokapen (se passa i filtri export) può aggiornare MailerLite senza premere ogni volta il pulsante. Comoda per team che lavora tutti i giorni su entrambi i sistemi.

Sync manuale — niente aggiornamenti finché non premi Sincronizza. Utile in fase di setup (controlli mappatura e filtri), dopo cambi grossi ai consensi privacy, o se vuoi approvare ogni batch prima che esca verso MailerLite.

Puoi passare da manuale ad automatica in qualsiasi momento con Salva; la scelta non cancella i dati già sincronizzati.

Visibilità

Riguarda i contatti importati da MailerLite verso Mokapen (sync verso CRM o bidirezionale). Non cambia chi vede MailerLite — solo chi, dentro Mokapen, può aprire le schede create da questa sync.

Tutti i membri (visibilità pubblica) — ogni utente dell'org con permesso sui contatti vede le anagrafiche importate: adatto a CRM condiviso, sales e marketing sulla stessa base iscritti.

Solo membri selezionati (visibilità privata) — limiti l'accesso a te e/o utenti o team che scegli nel menu. Gli altri in org non vedono quelle schede anche se la sync è attiva. Utile se colleghi una lista personale o un segmento riservato; combina con i ruoli Mokapen: un utente senza permesso contatti non le gestisce comunque.

Se l'org ha già regole privacy globali (Team Master obbligatorio), alcune opzioni possono essere preimpostate o bloccate in pagina — segui ciò che compare nell'integrazione.

Condividi sync

Con piano adeguato, altri membri possono usare il tuo collegamento MailerLite (stessa API key) senza reinserirla. Chi ha creato il collegamento resta visibile in Creato da.

Autorizzazione obbligatoria

Spunta «Autorizzo Mokapen a creare una copia…» — senza quella casella i pulsanti Salva e Sincronizza restano disattivati.

Poi premi Sincronizza. Su liste grandi l'operazione può richiedere diversi minuti.

Comportamento in Mokapen

• Dall'elenco contatti puoi rilanciare sync dal menu integrazioni (se permesso).
• Con export attivo, creare o aggiornare un contatto in Mokapen che rispetta i filtri può aggiornare l'iscritto su MailerLite.
• I gruppi MailerLite non diventano automaticamente tag Mokapen: usa tag e filtri CRM se ti serve segmentazione interna.
• Questa integrazione sincronizza contatti / iscritti, non le campagne email: per le campagne esiste un collegamento separato «MailerLite Campaigns» in Integrazioni.

Problemi comuni

• Errore chiave API — verifica Classic vs MailerLite attuale; rigenera la chiave nel pannello MailerLite.
• Nessun iscritto importato — controlla filtri (solo attivi, gruppo sbagliato) e direzione sync.
• Troppi duplicati — il confronto email è fisso; usa lo strumento Duplicati dopo la prima importazione.
• Export vuoto — filtri tipo/tag/privacy troppo restrittivi; usa l'anteprima conteggio contatti.
• Sync bloccata — verifica casella autorizzazione; disconnetti e riconnetti con chiave valida.

Disconnettere

Premi Disconnetti: si apre una finestra con la sezione Conserva. Lì decidi cosa fare dei dati già importati in Mokapen con questa sync.

Opzioni in Mokapen (caselle spuntate = conserva, predefinito):

• Contatti — se lasci la casella attiva, i contatti importati da MailerLite restano in Mokapen ma non si sincronizzano più. Se la deselezioni, Mokapen elimina dalla org i contatti legati a questa integrazione MailerLite.
• Aziende — stessa logica per le anagrafiche azienda collegate alla sync (conserva o rimuovi da Mokapen).

La disconnessione non cancella automaticamente gli iscritti su MailerLite: restano nel tuo account salvo tu li elimini lì. Mokapen non revoca la chiave API in MailerLite — revocala manualmente nel pannello MailerLite se non la userai più.

Dopo aver scelto, digita la parola di conferma e conferma Disconnetti. La rimozione di molti contatti può richiedere qualche minuto.

Approfondimento: guida Contatti.