> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailchimp

> Aggiungi Mailchimp al tuo progetto Macaly

Mailchimp ti permette di raccogliere iscritti, inviare newsletter e gestire campagne email automatizzate. Se vuoi creare e coltivare una mailing list dal tuo sito Macaly, Mailchimp è uno dei modi più diffusi per farlo.

<Callout icon="user">
  Disponibile in tutti i piani
</Callout>

<Note>
  **Ti serve davvero Mailchimp?** Macaly ha un [database integrato](/docs/it/features/databases) e le notifiche via email. Se ti serve solo un modulo di contatto o una lista d'attesa, non hai bisogno di uno strumento esterno. Mailchimp vale la pena quando ti servono newsletter, sequenze automatiche o segmentazione del pubblico.
</Note>

## Perché usare Mailchimp

* **Fai crescere la tua lista dal tuo sito.** Raccogli iscritti e gestiscili in un unico posto. Segmentali per interessi, origine dell'iscrizione o comportamento.
* **Invia newsletter senza toccare il codice.** Progetta e invia campagne email al tuo pubblico. Programmale o inviale subito.
* **Automatizza i tuoi follow-up.** Configura email di benvenuto, sequenze automatiche e promemoria per i carrelli abbandonati che funzionano da soli.
* **Scopri cosa funziona davvero.** Monitora i tassi di apertura, i tassi di clic e quali link ottengono più interazioni.

## Cosa ti serve

Prima di iniziare, assicurati di avere:

* Un **account Mailchimp**. Creane uno gratuitamente su [mailchimp.com](https://mailchimp.com)
* Un **audience Mailchimp** (mailing list) in cui raccogliere gli iscritti

Ci sono due modi per collegare Mailchimp al tuo sito:

* **Modulo di iscrizione incorporato.** Incolla nel tuo sito il codice del modulo generato da Mailchimp. Ideale per la semplice raccolta di email.
* **API di Mailchimp.** Collega i tuoi moduli all'API di Mailchimp per avere pieno controllo sui dati che invii. Ideale quando vuoi moduli personalizzati in linea con il tuo design.

## Opzione 1: modulo di iscrizione incorporato

L'approccio più semplice. Mailchimp genera un modulo che puoi inserire nel tuo sito.

<Steps>
  <Step title="Ottieni il codice di incorporamento del modulo">
    In Mailchimp, vai su **Audience**, poi **Signup forms**, poi **Embedded forms**. Personalizza i campi che vuoi, poi copia il codice HTML generato.
  </Step>

  <Step title="Chiedi all'agente di aggiungerlo">
    Apri la chat nel tuo progetto Macaly e chiedi:

    ```
    Aggiungi questo modulo di iscrizione Mailchimp al mio sito. Ecco il codice
    di incorporamento:

    [incolla qui il tuo codice di incorporamento Mailchimp]
    ```
  </Step>

  <Step title="L'agente posiziona il modulo">
    L'agente aggiunge il modulo al tuo progetto. Puoi dirgli esattamente dove lo vuoi, per esempio nel footer, in una pagina dedicata o in un popup.
  </Step>
</Steps>

<Tip>
  Se vuoi che il modulo sia in linea con il design del tuo sito, di' all'agente: *"Dai al modulo Mailchimp lo stile del resto del mio sito."*
</Tip>

## Opzione 2: modulo personalizzato con l'API di Mailchimp

Per avere più controllo, l'agente può creare un modulo personalizzato che invia gli iscritti a Mailchimp tramite la loro API.

<Steps>
  <Step title="Aggiungi le tue credenziali Mailchimp ai Secret">
    Vai su **Impostazioni**, poi **Secret** nel tuo progetto Macaly. Aggiungi due secret:

    * `MAILCHIMP_API_KEY` - la tua chiave API di Mailchimp
    * `MAILCHIMP_AUDIENCE_ID` - l'audience a cui vuoi aggiungere gli iscritti

    <Accordion title="Come trovare la chiave API e l'audience ID">
      **Chiave API:**

      1. In Mailchimp, fai clic sull'icona del tuo profilo, poi su **Account & billing**
      2. Vai su **Extras**, poi **API keys**
      3. Fai clic su **Create a key** e copiala

      **Audience ID:**

      1. Vai su **Audience**, poi **All contacts**
      2. Fai clic su **Settings**, poi **Audience name and defaults**
      3. Il tuo **Audience ID** è indicato in questa pagina
    </Accordion>
  </Step>

  <Step title="Chiedi all'agente di creare il modulo">
    Apri la chat e chiedi:

    ```
    Crea un modulo di iscrizione alla newsletter nel footer. Quando qualcuno
    si iscrive, aggiungilo alla mia audience Mailchimp tramite l'API.
    Ho aggiunto la mia chiave API e l'audience ID ai Secret.
    ```
  </Step>
</Steps>

<Warning>
  Non incollare mai le chiavi API direttamente nella chat. Usa sempre **Impostazioni**, poi **Secret**, per archiviare le credenziali sensibili. L'agente può leggerle da lì in modo sicuro.
</Warning>

## Verifica che funzioni

<Steps>
  <Step title="Invia un'iscrizione di prova">
    Visita il tuo sito e inserisci un indirizzo email di prova nel modulo di iscrizione.
  </Step>

  <Step title="Controlla la tua audience Mailchimp">
    Vai su **Audience**, poi **All contacts** in Mailchimp. La tua email di prova dovrebbe comparire come nuovo iscritto.
  </Step>
</Steps>

## Buono a sapersi

* Se ti serve solo raccogliere email, il [database integrato](/docs/it/features/databases) di Macaly è più semplice e non richiede un account esterno
* Per la conformità al GDPR, attiva il **double opt-in** nelle impostazioni della tua audience Mailchimp. In questo modo viene inviata un'email di conferma prima di aggiungere qualcuno alla lista
* L'agente può anche configurare moduli popup e moduli a scomparsa se vuoi qualcosa di più visibile di un'iscrizione in linea


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.