On this page

Guida all'Integrazione Magento / Adobe Commerce

Questa guida ti accompagna nell’integrazione di Tajo con Magento Open Source o Adobe Commerce per sbloccare le funzionalità di coinvolgimento dei clienti, programmi fedeltà e automazione del marketing.

Panoramica

L’integrazione Tajo-Magento ti consente di:

Sincronizzare i dati dei clienti automaticamente dal tuo negozio Magento
Tracciare ordini e prodotti per il marketing personalizzato
Gestire programmi fedeltà con punti, livelli e premi
Automatizzare le campagne di marketing tramite Brevo (email, SMS, WhatsApp)
Supportare configurazioni multi-sito e multi-negozio
Gestire cataloghi prodotti complessi con prodotti configurabili

Prerequisiti

Prima di avviare l’integrazione, assicurati di avere:

Magento 2.4+ o Adobe Commerce (Cloud o On-Premise)
Account Tajo con un abbonamento attivo
Account Brevo (opzionale, per l’automazione del marketing)
Accesso amministratore alla tua istanza Magento
Composer per la gestione delle dipendenze
PHP 8.1+ con le estensioni richieste

Passo 1: Installa l’Estensione Tajo

Tramite Composer (Consigliato)

# Aggiungi il repository Tajo
composer config repositories.tajo composer https://packages.tajo.io

# Installa il modulo
composer require tajo/module-brevo

# Abilita il modulo
php bin/magento module:enable Tajo_Brevo

# Esegui le migrazioni
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Passo 2: Configura il Modulo

Impostazioni nel Pannello Admin

Naviga su Negozi → Configurazione → Tajo → Integrazione Brevo
Inserisci la tua Chiave API Brevo
Configura le impostazioni di sincronizzazione:

<config>
  <default>
    <tajo_brevo>
      <general>
        <enabled>1</enabled>
        <api_key>your_brevo_api_key</api_key>
        <sync_customers>1</sync_customers>
        <sync_orders>1</sync_orders>
        <sync_products>1</sync_products>
      </general>
      <loyalty>
        <enabled>1</enabled>
        <points_per_dollar>1</points_per_dollar>
        <welcome_bonus>500</welcome_bonus>
      </loyalty>
    </tajo_brevo>
  </default>
</config>

Passo 3: Sincronizzazione Dati

Observer per Nuovi Clienti

<?php
namespace Tajo\Brevo\Observer;

use Magento\Framework\Event\Observer;
use Magento\Framework\Event\ObserverInterface;

class CustomerRegisterSuccess implements ObserverInterface
{
    public function execute(Observer $observer)
    {
        $customer = $observer->getCustomer();

        $this->brevoService->syncCustomer([
            'email' => $customer->getEmail(),
            'firstName' => $customer->getFirstname(),
            'lastName' => $customer->getLastname(),
            'loyaltyTier' => 'Bronze',
            'loyaltyPoints' => 500 // Bonus di benvenuto
        ]);
    }
}

Passo 4: Supporto Multi-Sito

// Configura per ogni store view
$storeConfigs = [
    'default' => [
        'list_id' => 1,
        'loyalty_multiplier' => 1.0
    ],
    'premium' => [
        'list_id' => 2,
        'loyalty_multiplier' => 2.0
    ]
];