On this page

Guide d'intégration Tajo-Brevo

Ce guide complet vous explique comment intégrer votre plateforme de fidélité Tajo avec Brevo pour créer de puissantes campagnes d’engagement client automatisées.

Vue d’ensemble

L’intégration Tajo-Brevo vous permet de :

  • Synchroniser les données client en temps réel entre les plateformes
  • Automatiser les campagnes de fidélité basées sur le comportement client
  • Suivre l’engagement via email, SMS et WhatsApp
  • Segmenter les clients par niveau de fidélité et comportement d’achat
  • Déclencher des messages personnalisés pour les événements de fidélité clés

Prérequis

Avant de démarrer l’intégration, assurez-vous d’avoir :

  • Compte Tajo avec le programme de fidélité configuré
  • Compte Brevo avec accès API
  • Clés API valides pour les deux plateformes
  • Points de terminaison webhook configurés pour la synchronisation en temps réel
  • Certificat SSL pour la transmission sécurisée des données

Étape 1 : Configuration de l’authentification

Générer une clé API Brevo

  1. Connectez-vous à votre compte Brevo
  2. Allez dans Compte & Plan > Clés API
  3. Cliquez sur Générer une nouvelle clé API
  4. Nommez-la “Tajo Integration”
  5. Copiez et conservez la clé en lieu sûr
Terminal window
# Store in environment variables
export BREVO_API_KEY="xkeysib-your-api-key-here"
export TAJO_WEBHOOK_SECRET="your-webhook-secret"

Configurer l’intégration Tajo

Dans votre tableau de bord Tajo :

  1. Allez dans Paramètres > Intégrations
  2. Sélectionnez Brevo dans la liste
  3. Entrez votre clé API Brevo
  4. Configurez les paramètres de synchronisation
{
  "brevo_api_key": "xkeysib-your-api-key-here",
  "sync_frequency": "real-time",
  "sync_contacts": true,
  "sync_orders": true,
  "sync_events": true,
  "loyalty_attributes": [
    "LOYALTY_POINTS",
    "LOYALTY_TIER",
    "TOTAL_SPENT",
    "LAST_PURCHASE"
  ]
}

Étape 2 : Synchronisation des données client

Configuration de la synchronisation des contacts

Configurez la synchronisation automatique des contacts pour maintenir les données client à jour :

// Sync customer on registration
async function syncCustomerToBrevo(customer) {
  const brevoData = {
    email: customer.email,
    attributes: {
      FIRSTNAME: customer.firstName,
      LASTNAME: customer.lastName,
      PHONE: customer.phone,
      LOYALTY_ID: customer.loyaltyId,
      LOYALTY_POINTS: customer.points,
      LOYALTY_TIER: customer.tier,
      SIGNUP_DATE: customer.createdAt,
      TOTAL_SPENT: customer.totalSpent,
      PREFERRED_CATEGORIES: customer.categories,
      BIRTHDAY: customer.birthday
    },
    listIds: [getListForTier(customer.tier)]
  };


  const response = await fetch('https://api.brevo.com/v3/contacts', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'api-key': process.env.BREVO_API_KEY
    },
    body: JSON.stringify(brevoData)
  });


  return response.json();
}

Synchronisation des événements d’achat

Synchronisez automatiquement les achats pour déclencher des campagnes de fidélité :

// Sync order completion
async function syncOrderToBrevo(order, customer) {
  // Create order in Brevo
  const orderData = {
    id: order.id,
    email: customer.email,
    products: order.items.map(item => ({
      id: item.productId,
      name: item.name,
      quantity: item.quantity,
      price: item.price,
      category: item.category
    })),
    revenue: order.total,
    date: order.createdAt
  };


  await fetch('https://api.brevo.com/v3/ecommerce/orders', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'api-key': process.env.BREVO_API_KEY
    },
    body: JSON.stringify(orderData)
  });


  // Create loyalty event
  const eventData = {
    email: customer.email,
    event: 'Purchase Completed',
    properties: {
      order_id: order.id,
      amount: order.total,
      points_earned: order.pointsEarned,
      loyalty_tier: customer.tier,
      tier_upgraded: order.tierUpgraded,
      products: order.items.map(i => i.name).join(', ')
    }
  };


  await fetch('https://api.brevo.com/v3/events', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'api-key': process.env.BREVO_API_KEY
    },
    body: JSON.stringify(eventData)
  });
}

Étape 3 : Configuration des campagnes automatisées

Campagne de bienvenue pour les nouveaux clients

Créez une série de bienvenue automatisée pour les nouveaux membres du programme de fidélité :

{
  "campaign_name": "Tajo Loyalty Welcome Series",
  "trigger": {
    "event": "Contact Created",
    "conditions": {
      "LOYALTY_ID": "exists",
      "SIGNUP_DATE": "today"
    }
  },
  "emails": [
    {
      "delay": "immediate",
      "template_id": 101,
      "subject": "Welcome to Tajo Loyalty! Here's your {{params.welcome_bonus}} points bonus",
      "params": {
        "welcome_bonus": "500",
        "loyalty_tier": "Bronze",
        "next_tier_points": "1000"
      }
    },
    {
      "delay": "3 days",
      "template_id": 102,
      "subject": "Don't forget to use your {{params.welcome_bonus}} bonus points!"
    },
    {
      "delay": "1 week",
      "template_id": 103,
      "subject": "Here's how to earn points faster with Tajo"
    }
  ]
}

Campagne de montée en niveau

Célébrez automatiquement les montées en niveau :

// Webhook handler for tier upgrades
app.post('/webhook/tier-upgrade', (req, res) => {
  const { customer, previousTier, newTier } = req.body;


  const campaignData = {
    email: customer.email,
    template_id: getTierUpgradeTemplate(newTier),
    params: {
      customer_name: customer.firstName,
      new_tier: newTier,
      previous_tier: previousTier,
      new_benefits: getTierBenefits(newTier),
      points_balance: customer.points
    }
  };


  // Send congratulations email
  sendBrevoEmail(campaignData);


  // Add to tier-specific list
  addToBrevoList(customer.email, getTierListId(newTier));


  res.status(200).json({ success: true });
});

Étape 4 : Suivi des événements de fidélité

Événements clés à suivre

Configurez le suivi pour ces événements de fidélité essentiels :

const loyaltyEvents = {
  // Account Events
  'Account Created': {
    properties: ['signup_source', 'referral_code', 'welcome_bonus']
  },
  'Profile Updated': {
    properties: ['updated_fields', 'marketing_consent']
  },


  // Purchase Events
  'Purchase Completed': {
    properties: ['order_total', 'points_earned', 'loyalty_tier', 'products']
  },
  'Product Returned': {
    properties: ['return_reason', 'points_deducted', 'refund_amount']
  },


  // Loyalty Events
  'Points Earned': {
    properties: ['points_amount', 'earning_reason', 'total_balance']
  },
  'Points Redeemed': {
    properties: ['points_used', 'reward_type', 'remaining_balance']
  },
  'Tier Upgraded': {
    properties: ['previous_tier', 'new_tier', 'upgrade_benefits']
  },


  // Engagement Events
  'Email Opened': {
    properties: ['campaign_type', 'subject_line', 'device']
  },
  'Reward Browsed': {
    properties: ['reward_category', 'reward_name', 'points_required']
  },
  'Referral Made': {
    properties: ['referral_method', 'referee_email', 'referral_bonus']
  }
};

Implémentation du suivi d’événements 

class TajoBrevoEventTracker {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://api.brevo.com/v3';
  }


  async trackEvent(customerEmail, eventName, properties = {}) {
    const eventData = {
      email: customerEmail,
      event: eventName,
      properties: {
        timestamp: new Date().toISOString(),
        source: 'tajo_platform',
        ...properties
      }
    };


    try {
      const response = await fetch(`${this.baseUrl}/events`, {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'api-key': this.apiKey
        },
        body: JSON.stringify(eventData)
      });


      if (!response.ok) {
        throw new Error(`Event tracking failed: ${response.statusText}`);
      }


      return await response.json();
    } catch (error) {
      console.error('Brevo event tracking error:', error);
      throw error;
    }
  }


  // Convenience methods for common events
  async trackPurchase(customer, order) {
    return this.trackEvent(customer.email, 'Purchase Completed', {
      order_id: order.id,
      order_total: order.total,
      currency: order.currency,
      points_earned: order.pointsEarned,
      loyalty_tier: customer.tier,
      items_count: order.items.length,
      first_purchase: customer.orderCount === 1
    });
  }


  async trackTierUpgrade(customer, previousTier) {
    return this.trackEvent(customer.email, 'Tier Upgraded', {
      previous_tier: previousTier,
      new_tier: customer.tier,
      points_balance: customer.points,
      benefits_unlocked: getTierBenefits(customer.tier),
      upgrade_date: new Date().toISOString()
    });
  }
}

Étape 5 : Stratégie de segmentation

Segments clients

Créez des segments ciblés dans Brevo pour des campagnes personnalisées :

const loyaltySegments = [
  // Tier-based segments
  {
    name: "Bronze Members",
    conditions: { LOYALTY_TIER: "Bronze" },
    campaigns: ["tier_upgrade_promotion", "engagement_boost"]
  },
  {
    name: "Silver Members",
    conditions: { LOYALTY_TIER: "Silver" },
    campaigns: ["premium_offers", "early_access"]
  },
  {
    name: "Gold Members",
    conditions: { LOYALTY_TIER: "Gold" },
    campaigns: ["vip_treatment", "exclusive_rewards"]
  },
  {
    name: "Platinum Members",
    conditions: { LOYALTY_TIER: "Platinum" },
    campaigns: ["luxury_experiences", "personal_offers"]
  },


  // Behavior-based segments
  {
    name: "High Spenders",
    conditions: { TOTAL_SPENT: ">1000" },
    campaigns: ["luxury_catalog", "big_spender_rewards"]
  },
  {
    name: "Frequent Shoppers",
    conditions: { PURCHASE_FREQUENCY: "weekly" },
    campaigns: ["convenience_offers", "bulk_discounts"]
  },
  {
    name: "At-Risk Customers",
    conditions: { LAST_PURCHASE: ">90 days" },
    campaigns: ["win_back", "special_incentives"]
  },
  {
    name: "Birthday Month",
    conditions: { BIRTHDAY: "this_month" },
    campaigns: ["birthday_specials", "bonus_points"]
  }
];

Étape 6 : Tests et surveillance

Liste de contrôle des tests d’intégration

  • Synchronisation des contacts : Les nouveaux clients apparaissent dans Brevo
  • Synchronisation des commandes : Les achats déclenchent des événements correctement
  • Suivi des événements : Tous les événements de fidélité sont enregistrés
  • Déclencheurs de campagne : Les emails automatisés s’envoient correctement
  • Segmentation : Les clients se déplacent correctement entre les listes
  • Livraison des webhooks : La synchronisation en temps réel fonctionne de manière fiable

Configuration de la surveillance 

// Health check endpoint
app.get('/integration/health', async (req, res) => {
  const checks = {
    brevo_api: await checkBrevoConnection(),
    webhook_delivery: await checkWebhookDelivery(),
    event_tracking: await checkEventTracking(),
    campaign_triggers: await checkCampaignTriggers()
  };


  const allHealthy = Object.values(checks).every(check => check.status === 'ok');


  res.status(allHealthy ? 200 : 503).json({
    status: allHealthy ? 'healthy' : 'degraded',
    checks,
    timestamp: new Date().toISOString()
  });
});

Dépannage des problèmes courants

Limites de débit API

Brevo a des limites de débit, implémentez une logique de réessai :

async function makeBrevoRequest(url, options, retries = 3) {
  try {
    const response = await fetch(url, options);


    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After') || 60;
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      return makeBrevoRequest(url, options, retries - 1);
    }


    return response;
  } catch (error) {
    if (retries > 0) {
      await new Promise(resolve => setTimeout(resolve, 5000));
      return makeBrevoRequest(url, options, retries - 1);
    }
    throw error;
  }
}

Problèmes de synchronisation des données

Surveillez et résolvez les conflits de synchronisation :

// Sync conflict resolution
async function resolveSyncConflict(tajoData, brevoData) {
  // Use most recent timestamp as source of truth
  const tajoUpdated = new Date(tajoData.updatedAt);
  const brevoUpdated = new Date(brevoData.modifiedAt);


  if (tajoUpdated > brevoUpdated) {
    // Update Brevo with Tajo data
    await updateBrevoContact(brevoData.id, tajoData);
  } else {
    // Update Tajo with Brevo data
    await updateTajoCustomer(tajoData.id, brevoData);
  }
}

Prochaines étapes

  1. Configurer les webhooks pour la synchronisation en temps réel
  2. Créer des modèles email pour les campagnes de fidélité
  3. Configurer l’automatisation SMS pour les notifications urgentes
  4. Configurer les analytics pour suivre les performances

Support et ressources

Assistant AI

Bonjour ! Posez-moi vos questions sur la documentation.

Commencez gratuitement avec Brevo