Il plugin Brevo per Magento 2 ti consente di sincronizzare i dati dei clienti e degli ordini del tuo negozio con il tuo account Brevo. Questo ti permette di inviare campagne email e SMS mirate, creare automazioni di marketing e migliorare il coinvolgimento dei clienti.

Prima di iniziare

Assicurati di avere accesso al tuo pannello di amministrazione di Magento 2 e al server Magento come proprietario del file system.

Installa il plugin Brevo per Magento 2

Fase 1: aggiunta del plugin Magento al carrello

Il plugin Brevo per Magento è gratuito, ma deve comunque essere aggiunto al carrello e "acquistato".

1. Vai alla pagina del plugin Brevo Marketing Platform & CRM suite.
2. Nel menu a discesa Edition (Edizione), seleziona la versione di Magento 2 che stai utilizzando.
3. Nei menu a discesa Your store version (Versione dello store), seleziona il numero esatto della versione della piattaforma dello store.
4. Clicca su Add to cart (Aggiungi al carrello).
   
5. Clicca sull'icona del carrello 🛒 nella barra superiore.
6. Clicca su Proceed to checkout (Vai al pagamento).
7. Se non l'hai già fatto, accedi al tuo account Adobe Commerce.
8. Clicca su Place order (Effettua ordine).

Fase 2: verifica dei prerequisiti

Prima di installare il plugin Brevo sul tuo negozio Magento, assicurati che i seguenti prerequisiti siano soddisfatti:

1. Accedi al tuo server Magento come proprietario del file di sistema.
2. Controlla i tuoi file composer.json per verificare che il repository repo.magento.com sia incluso:
   

   repositories": [ { "type": "composer", "url": "https://repo.magento.com/" } ]

3. Crea nuove chiavi di autenticazione dal tuo account Commerce Marketplace. Per ulteriori informazioni, consulta la documentazione dedicata di Adobe. 
4. Incolla le tue chiavi di autenticazione nel file auth.json nella cartella di installazione di Magento. Se il file non è presente, apri il seguente menu a discesa per visualizzare una struttura di esempio che puoi utilizzare:
   File auth.json di esempio

   { "http-basic": { "repo.magento.com": { "username": "<public-key>", "password": "<private-key>" } } }

Fase 3: installazione del plugin Brevo per Magento 2

Installa il plugin Brevo direttamente dal tuo server Magento.

1. Accedi al tuo server Magento come proprietario del file di sistema.
2. Accedi alla cartella in cui è installato il tuo negozio Magento.

3. Installa il plugin Brevo eseguendo il comando seguente:
   

   composer require brevo/magento2-extension

4. (Opzionale) Se si verifica un errore, esegui il comando seguente:
   

   sudo composer require brevo/magento2-extension

   e conferma per continuare come utente root digitando yes (sì).

5. Aggiorna la tua istanza di Magento eseguendo questi comandi in sequenza:

   sudo bin/magento module:enable Brevo_Core

   sudo bin/magento setup:di:compile

   setup:upgrade

6. Al termine della configurazione, accedi al pannello di amministrazione di Magento.

Il plugin Brevo è ora installato e deve essere attivato. 

Fase 3: attivazione del plugin Brevo per Magento 2

Attiva il plugin Brevo per collegare il tuo negozio Magento al tuo account Brevo.

1. Nel menu della barra laterale, vai su Stores (Negozi) > Brevo Configuration (Configurazione di Brevo).
2. Clicca su Activate Plugin (Attiva plugin).
3. Accanto a Brevo Integration (Integrazione Brevo), clicca su Activate (Attiva).
4. Clicca su Allow (Consenti) per consentire a Brevo di accedere alle impostazioni necessarie per l'integrazione.
5. Clicca su Allow access (Consenti accesso) per consentire a Magento 2 di accedere al tuo account Brevo.
6. Clicca su Activate (Attiva) per collegare il tuo account Magento 2. Verrai reindirizzato alle impostazioni del plugin.

Accesso alle impostazioni del plugin in Brevo

Accedi alle impostazioni del plugin in Brevo. Qui puoi gestire le impostazioni plugin Brevo, tra cui la sincronizzazione dei clienti, il tracciamento dei visitatori del tuo negozio e molto altro.

1. Accedi al tuo account Brevo.
2. Clicca sul menu a discesa dell'account e seleziona Integrations (Integrazioni).
3. Vai sulla scheda My Integrations (Le mie integrazioni).
4. Accanto al plugin Magento 2, clicca sull'icona con i tre puntini e seleziona Edit settings (Modifica impostazioni).
   

Sincronizzazione dei clienti di Magento 2 con Brevo

Sincronizza i clienti nuovi ed esistenti del tuo negozio Magento 2 con Brevo.

1. Dalle impostazioni del plugin, vai su Contact Synchronization (Sincronizzazione dei contatti).
2. Attiva l'opzione Sync your store contacts to Brevo (Sincronizza i contatti del negozio con Brevo). Attivando questa opzione, tutti i contatti del negozio aggiunti, aggiornati o eliminati in Magento 2 si rifletteranno automaticamente in Brevo.
   
3. Dal menu a discesa, seleziona se desideri eseguire la sincronizzazione da una lista di clienti o da un gruppo.
4. Scegli come sincronizzare i tuoi contatti:
   
   Sincronizzazione di tutti i contatti con una lista Brevo Sincronizzazione dei gruppi del negozio con liste Brevo

   1. Nel menu a discesa, seleziona l'opzione A list (Una lista). Per impostazione predefinita, i contatti vengono aggiunti alla lista denominata Magento 2 nella cartella Integrations (Integrazioni).
   2. (Opzionale) Per scegliere una lista diversa o crearne una nuova, clicca su Select another list (Seleziona un'altra lista).
      

   1. Nel menu a discesa, seleziona l'opzione A group (Un gruppo). 
   2. Clicca su Assignment settings (Impostazioni assegnazione).
      
   3. Scegli le liste Brevo in cui desideri sincronizzare gruppi specifici del negozio.
5. (Opzionale) Configura le seguenti opzioni, attivate per impostazione predefinita:
   
   1. Sync the state of contacts (subscribed/unsubscribed) (Sincronizza lo stato dei contatti (iscritti/disiscritti))
      Sincronizza l'attuale stato di iscrizione dei contatti tra Magento 2 e Brevo. Quindi, quando un contatto si iscrive o si disiscrive in Brevo, la modifica si rifletterà in Magento 2.
      Se non vuoi sincronizzare lo stato di iscrizione in Brevo, disattiva questa opzione.
   2. Autoassign store contacts' attributes to Brevo contact attributes (Associa automaticamente gli attributi dei contatti del negozio agli attributi dei contatti di Brevo)
      Abbina automaticamente l'indirizzo email, il nome e il cognome dei contatti del tuo negozio in Magento 2 agli attributi di contatto in Brevo.
      Per abbinare manualmente altri attributi, disattiva questa opzione e seleziona Map attributes (Abbina attributi).
      
      💡 Buono a sapersi

      Solo gli attributi predefiniti di Magento possono essere abbinati agli attributi di contatto di Brevo. Gli attributi personalizzati non possono essere abbinati.
      
6. Clicca su Save (Salva).

Sincronizzazione degli attributi ecommerce di Magento 2 con Brevo

Sincronizza i prodotti, le categorie, gli ordini e i clienti del tuo negozio Magento 2 con Brevo.

1. Dalle impostazioni del plugin, vai su Ecommerce Attribute Synchronization (Sincronizzazione degli attributi dell'ecommerce).
2. Attiva l'opzione Enable the sync of e-commerce attributes to gain insights on your most valuable customers (Abilita la sincronizzazione degli attributi dell'ecommerce per ottenere informazioni sui tuoi clienti più importanti). Attivando questa opzione:
   • Tutti i prodotti, le categorie e gli ordini del negozio saranno sincronizzati con Brevo. 
   • Tutti i clienti del negozio che hanno effettuato almeno un ordine verranno sincronizzati con Brevo.
   • I contatti che hanno fornito il consenso a ricevere comunicazioni via email tramite l'interfaccia del negozio saranno iscritti a Brevo, mentre tutti gli altri contatti sincronizzati saranno bloccati in Brevo.
     
3. Clicca su Confirm (Conferma).
4. Nella sezione Sync Statuses (Stati di sincronizzazione), monitora lo stato di sincronizzazione degli attributi dell'ecommerce. La sincronizzazione completa iniziale dei dati storici potrebbe richiedere diverso tempo.
   
   
   💡 Buono a sapersi

   Puoi monitorare lo stato di sincronizzazione anche selezionando il plugin Magento 2 dalla pagina My Integrations (Le mie integrazioni) nel tuo account Brevo.
5. (Opzionale) Clicca su View Ecommerce Analytics (Visualizza le analisi di ecommerce) per accedere alla tua dashboard di ecommerce, dove puoi analizzare diverse metriche come l'andamento del fatturato, le prestazioni dei prodotti e le performance di fidelizzazione. Per ulteriori informazioni, consulta la sezione dedicata all'argomento nel Centro di assistenza.

Al termine della sincronizzazione, tutti i nuovi prodotti, ordini e clienti verranno sincronizzati in tempo reale.

Gestione delle impostazioni di conferma dell'iscrizione

Utilizza una delle opzioni di conferma dell'iscrizione di Brevo e invia email di doppia conferma o di conferma semplice quando un contatto invia un modulo sul tuo negozio Magento 2.

1. Dalle impostazioni del plugin, vai su Subscription Confirmation (Conferma iscrizione).
2. Attiva l'opzione Use Brevo subscription confirmation to manage opt-in settings (Utilizza le opzioni di conferma dell'iscrizione a Brevo per gestire le impostazioni di opt-in). Attivando questa opzione, puoi scegliere se inviare email di doppia conferma o di conferma semplice dell'iscrizione direttamente da Brevo.
3. Seleziona se desideri inviare email di doppia conferma o di conferma semplice. Per ulteriori informazioni, consulta il nostro articolo dedicato Domande frequenti: perché usare un modulo di iscrizione a doppio opt-in?
   
4. Configura la tua conferma di iscrizione:
   
   Double confirmation email (Email di doppia conferma) Simple confirmation email (Email di conferma semplice)

   1. Nel menu a discesa, seleziona il modello di email di conferma a doppio opt-in che desideri inviare ai contatti che inviano il tuo modulo. Per informazioni sulla creazione di un modello di email a doppio opt-in, consulta il nostro articolo dedicato Creazione di un modello di email a doppio opt-in (DOI) personalizzato per un modulo di iscrizione creato in Brevo.
   2. (Opzionale) Inserisci l'URL della pagina di conferma a cui verranno reindirizzati i contatti dopo aver cliccato sul link di doppio opt-in nell'email.
   3. (Opzionale) Seleziona le email di conferma finale che desideri inviare ai contatti dopo che hanno cliccato sul link di doppio opt-in nell'email.
      
   4. Clicca su Save (Salva).

   1. Nel menu a discesa, seleziona il modello di email di conferma semplice che desideri inviare ai contatti che inviano il tuo modulo.
      
   2. Clicca su Save (Salva).

Tracciamento delle azioni dei contatti sul negozio Magento 2

Tieni traccia delle azioni dei tuoi contatti sul tuo negozio Magento 2 e sincronizza i relativi dati con Brevo. Questo ti consente di utilizzare i dati nelle automazioni, ad esempio per l'invio automatico di un'email quando un contatto abbandona il proprio carrello o completa un acquisto.

1. Dalle impostazioni del plugin, vai su Behavior tracking (Tracciamento comportamento).
2. Attiva l'opzione Allow Brevo to track visitor actions on your store website in order to use this information for conditions and triggers in your marketing automation workflows (Consenti a Brevo di tenere traccia delle azioni dei visitatori sul sito del negozio in modo da poterle utilizzare per gli scenari di marketing automation). Attivando questa opzione:
   • Brevo Tracker verrà installato sul tuo negozio per monitorare le azioni dei visitatori in tempo reale. Per ulteriori informazioni, consulta il nostro articolo dedicato Domande frequenti: che cos'è Brevo Tracker e come si installa?
   • I dati dell'attività, ad es. visualizzazioni dei prodotti, aggiunte al carrello e acquisti, verranno sincronizzati direttamente con Brevo.
     
3. (Opzionale) Configura le seguenti opzioni, attivate per impostazione predefinita:
   1. Track page visits (Tieni traccia delle visite alle pagine)
      Monitora quando un contatto visita pagine specifiche del tuo negozio.
   2. Track the actions related to an abandoned cart (Tieni traccia delle azioni correlate a un carrello abbandonato)
      Monitora quando un contatto aggiunge o rimuove un prodotto dal carrello e tiene traccia di quando ha completato un acquisto.
      
4. Clicca su Save (Salva).

Invio di email transazionali da Magento 2 tramite Brevo SMTP

Invia le email transazionali del tuo negozio tramite Brevo SMTP. Questo ti consente di migliorare la consegnabilità delle tue email.

1. Dalle impostazioni del plugin, vai su SMTP for transactional mailing (SMTP per email transazionali).
2. Attiva l'opzione Use Brevo to send your store's transactional emails (Usa Brevo per inviare le email transazionali del tuo negozio). Attivando questa opzione:
   • Le tue email transazionali verranno inviate tramite Brevo SMTP.
   • Le statistiche delle email transazionali saranno disponibili direttamente nel tuo account Brevo.
   • Puoi utilizzare gli IP dedicati di Brevo e autenticare il tuo dominio per migliorare la consegnabilità delle tue email.
3. Scegli il mittente che desideri utilizzare per le tue email transazionali. Il nome e l'indirizzo email del mittente selezionato saranno visualizzati nella posta in arrivo del destinatario come origine dell'email.
   
4. Clicca su Save (Salva).

Creazione di automazioni per i contatti Magento 2

Crea le automazioni utilizzando i dati delle azioni dei tuoi contatti sul tuo negozio. Ad esempio, puoi inviare automaticamente un'email quando un contatto abbandona il carrello o completa un acquisto sul tuo negozio Magento 2. 

Per ulteriori informazioni, consulta i nostri articoli dedicati:

Invio di messaggi SMS per la conferma dell'ordine e della spedizione tramite Brevo

Invia messaggi SMS per la conferma dell'ordine e della spedizione tramite Brevo.

1. Dalle impostazioni del plugin, vai su SMS Options (Opzioni SMS).
2. Attiva l'opzione Use Brevo SMS Options to send SMS to customers after order confirmation and shipment (Usa le opzioni SMS di Brevo per inviare SMS ai clienti dopo la conferma dell'ordine e la spedizione). Attivando questa opzione:
   • I tuoi messaggi SMS per la conferma dell'ordine e della spedizione verranno inviati tramite Brevo.
   • Le statistiche degli SMS transazionali saranno disponibili direttamente nel tuo account Brevo.
     
3. (Opzionale) Attiva l'opzione Activate special characters (Attiva i caratteri speciali) se il tuo messaggio SMS contiene caratteri speciali come caratteri GSM, contenuto Unicode utilizzato negli alfabeti non latini (ad es. arabo, russo) ed emoji. In caso contrario, i caratteri speciali potrebbero essere sostituiti al momento dell'invio.
   
   
   ❗️ Importante

   L'attivazione di questa opzione ridurrà il limite di caratteri dell'SMS da 160 a 70 caratteri.
4. Scegli se desideri inviare messaggi SMS per la conferma dell'ordine e/o la spedizione dell'ordine / per quali eventi desideri utilizzare Brevo per inviare i tuoi messaggi SMS: 
   • Order Confirmation (Conferma dell'ordine)
     I tuoi clienti riceveranno un SMS quando il loro ordine sarà confermato dal tuo server.
   • Order Shipment (Spedizione dell'ordine)
     I tuoi clienti riceveranno un SMS quando il loro ordine viene spedito dalla tua azienda. 
5. Personalizza i tuoi messaggi SMS:
   
   
   1. Sender (Mittente): inserisci un nome personalizzato per il tuo mittente composto da 3 a 11 lettere o massimo 15 cifre. Ti consigliamo di utilizzare il nome della tua azienda per aiutare i destinatari a riconoscere il tuo brand. Evita di utilizzare caratteri speciali come caratteri GSM, caratteri Unicode in alfabeti non latini (ad es. arabo, russo) ed emoji.
      
      💡 Buono a sapersi

      In alcuni Paesi (inclusi gli Stati Uniti e il Canada), i destinatari non possono vedere la personalizzazione del mittente, che viene invece visualizzata come un codice numerico breve. Per ulteriori informazioni, consulta il nostro articolo dedicato Codici brevi, codici lunghi e mittenti di SMS personalizzati.
   2. Message (Messaggio): inserisci il contenuto del messaggio SMS che riceveranno i tuoi destinatari. Puoi personalizzare i tuoi SMS utilizzando variabili predefinite, come {first_name} per includere il nome del tuo cliente. Ogni SMS può contenere fino a 160 caratteri (o 70 caratteri se sono attivati i caratteri speciali), inclusi spazi e interruzioni di riga.
      ❗️ Importante

      Devi includere un'opzione di disiscrizione nel contenuto del tuo SMS. Per ulteriori informazioni, consulta il nostro articolo dedicato Aggiunta di un link di disiscrizione negli SMS.
   3. Send a test SMS (Invia un SMS di prova): invia un SMS di prova al numero di telefono che desideri per vedere quale sarà l'aspetto del tuo SMS transazionale.
      
      ❗️ Importante

      L'SMS di prova inviato verrà dedotto dai tuoi crediti SMS. 
6. Clicca su Save (Salva).

Risoluzione dei problemi relativi all'installazione del plugin Brevo

• Risoluzione dei problemi generali
• Problema con la versione corrispondente del pacchetto

Risoluzione dei problemi generali

In caso di problemi durante l'installazione:

1. Cancella la cache di Magento:
   1. Nel pannello di amministrazione di Magento, vai su System (Sistema) > Cache Management (Gestione cache).
   2. Clicca su Flush Magento Cache (Svuota la cache di Magento).
      
2. Disconnettiti e riaccedi al pannello di amministrazione di Magento.
3. Se il problema persiste, prova a reinstallare l'estensione.
4. Se riscontri ancora problemi, contatta il nostro team di assistenza creando un ticket dal tuo account.

Problema con la versione corrispondente del pacchetto

Could not find a matching version of package brevo/magento2-extension. 
Check the package spelling, your version constraint and that the package 
is available in a stability which matches your minimum-stability (stable) 
(Impossibile trovare una versione corrispondente del pacchetto brevo/magento2-extension. 
Verifica l'ortografia del pacchetto, i vincoli della tua versione e che il pacchetto sia 
disponibile in una stabilità corrispondente alla tua stabilità minima (stabile))

Se viene visualizzato questo messaggio di errore durante l'installazione, significa che le tue chiavi di autenticazione potrebbero essere obsolete o danneggiate. Per risolvere il problema, crea nuove chiavi di autenticazione dal tuo account Commerce Marketplace. Per ulteriori informazioni, consulta la documentazione dedicata di Adobe. 

🤔 Domande?

In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.

Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.