> ## 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.

# Brevo

> Aggiungi Brevo al tuo progetto Macaly

Brevo (in precedenza Sendinblue) è una piattaforma di email marketing che include anche SMS, campagne WhatsApp e un CRM integrato. Se ti serve qualcosa di più delle semplici newsletter, Brevo riunisce diversi canali di comunicazione in un unico strumento.

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

<Note>
  **Ti serve davvero Brevo?** 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. Brevo conviene quando ti servono newsletter, sequenze automatiche, campagne SMS o un CRM per gestire i tuoi contatti.
</Note>

## Perché usare Brevo

* **Invia newsletter ed email di marketing.** Usa l'editor drag-and-drop o i template HTML senza toccare il codice.
* **Automatizza i tuoi follow-up.** Crea serie di benvenuto, email per i carrelli abbandonati e campagne di riattivazione che funzionano da sole.
* **Raggiungi le persone su più canali.** Invia campagne email, SMS e WhatsApp dalla stessa piattaforma.
* **Gestisci i contatti senza un CRM separato.** Monitora le trattative e segmenta il tuo pubblico, tutto in un unico posto.

## Cosa ti serve

Prima di iniziare, assicurati di avere:

* Un **account Brevo**. Creane uno gratuitamente su [brevo.com](https://www.brevo.com)
* Una **lista di contatti** in Brevo in cui raccogliere gli iscritti

Ci sono due modi per collegare Brevo al tuo sito:

* **Modulo di iscrizione incorporato.** Incolli nel tuo sito il codice del modulo generato da Brevo. Ideale per una semplice raccolta di email.
* **API di Brevo.** Colleghi i tuoi moduli all'API di Brevo 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. Brevo genera un modulo che puoi incorporare nel tuo sito.

<Steps>
  <Step title="Ottieni il codice di incorporamento del modulo">
    In Brevo vai su **Contacts** e poi su **Forms**. Crea un nuovo modulo di iscrizione (o usane uno esistente), personalizzalo e copia il codice di incorporamento.
  </Step>

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

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

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

  <Step title="L'agente posiziona il modulo">
    L'agente aggiunge il modulo al tuo progetto. Digli dove lo vuoi: nel footer, nella barra laterale, 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, dillo all'agente: *"Adatta lo stile del modulo Brevo al resto del mio sito."*
</Tip>

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

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

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

    * `BREVO_API_KEY`, la tua chiave API di Brevo
    * `BREVO_LIST_ID`, la lista di contatti a cui vuoi aggiungere gli iscritti

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

      1. In Brevo, fai clic sul tuo nome in alto a destra, poi su **SMTP & API**
      2. Vai alla scheda **API Keys**
      3. Fai clic su **Generate a new API key** e copiala

      **ID della lista:**

      1. Vai su **Contacts** e poi su **Lists**
      2. Fai clic sulla lista che vuoi usare
      3. Il tuo **List ID** è visibile nella URL e nei dettagli della lista
    </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 lista di contatti Brevo tramite l'API.
    Ho aggiunto la chiave API e l'ID della lista ai Secret.
    ```
  </Step>
</Steps>

<Warning>
  Non incollare mai le chiavi API direttamente nella chat. Usa sempre **Impostazioni** e poi **Secret** per conservare 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 i contatti in Brevo">
    Vai su **Contacts** in Brevo. La tua email di prova dovrebbe comparire nella lista che hai collegato.
  </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 del modulo Brevo
* L'API di Brevo può inviare anche email transazionali (conferme d'ordine, reimpostazione della password). Chiedilo all'agente se ti servono


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