Connecteur Brevo

Connecteur Brevo

Connectez votre compte Brevo à Tajo pour une gestion unifiée des contacts, une messagerie transactionnelle sur e-mail, SMS et WhatsApp, et une automatisation marketing complète.

Vue d’ensemble

Fonctionnalités

• Messagerie multicanale, Envoyez e-mails transactionnels, SMS et WhatsApp depuis une API unifiée
• Gestion des contacts, Créez, mettez à jour et segmentez les contacts avec des attributs personnalisés
• Campagnes marketing, Créez et envoyez des campagnes e-mail de manière programmatique
• Suivi d’événements, Suivez les événements personnalisés et l’activité du site via le Brevo Tracker
• Synchronisation eCommerce, Synchronisez produits, commandes et données de panier pour des campagnes personnalisées
• Programmes de fidélité, Gérez abonnements de fidélité, points et données des membres
• Prise en charge des webhooks, Notifications d’événements en temps réel pour les événements transactionnels, marketing et CRM
• Conversations, Intégration du widget de chat en direct et gestion programmatique des messages

Prérequis

Avant de commencer, assurez-vous de disposer de :

1. Un compte Brevo (plan Free, Starter, Business ou Enterprise)
2. Une clé API générée depuis Brevo Settings > API Keys
3. Un compte Tajo avec accès API
4. Un domaine d’expédition vérifié pour l’envoi d’e-mails

Authentification

Brevo prend en charge deux méthodes d’authentification :

Authentification par clé API (recommandée)

Incluez votre clé API dans l’en-tête api-key à chaque requête. Idéale pour les intégrations directes et les communications serveur à serveur.

curl -X GET "https://api.brevo.com/v3/account" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Authentification OAuth 2.0

Utilisez OAuth 2.0 pour les intégrations privées au sein d’une organisation nécessitant un accès délégué et des permissions spécifiques à l’utilisateur. OAuth fournit un système basé sur des jetons avec des durées de validité définies.

Configuration

Configuration de base

connectors:
  brevo:
    enabled: true
    api_key: "${BREVO_API_KEY}"
    api_version: "v3"

    # Data sync options
    sync:
      contacts: true
      campaigns: true
      transactional: true
      events: true
      ecommerce: true

    # List assignment
    lists:
      all_customers: 5
      newsletter: 6
      buyers: 7

Mappage des champs

Mappez vos champs de données vers les attributs de contact Brevo :

Mappage d’attributs personnalisés

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Marketing fields
  opt_in: OPT_IN
  signup_source: SIGNUP_SOURCE
  preferred_language: LANGUAGE

  # eCommerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_REVENUE
  last_order_date: LAST_ORDER_DATE

  # Loyalty fields
  loyalty_tier: VIP_TIER
  loyalty_points: LOYALTY_POINTS

Endpoints API

Endpoints principaux

Endpoints eCommerce

Endpoints de campagne

Événements

Événements transactionnels

Événements eCommerce

Exemples de code

Initialiser le connecteur

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Brevo account
await tajo.connectors.connect('brevo', {
  apiKey: process.env.BREVO_API_KEY
});

Envoyer un e-mail transactionnel

// Send a transactional email via Brevo
await tajo.brevo.sendTransactionalEmail({
  to: [{ email: '[email protected]', name: 'John Doe' }],
  templateId: 12,
  params: {
    ORDER_ID: '12345',
    ORDER_TOTAL: '$59.99',
    DELIVERY_DATE: '2024-02-15'
  }
});

Synchroniser les contacts

// Bulk import contacts to Brevo
await tajo.connectors.sync('brevo', {
  type: 'full',
  resources: ['contacts'],
  options: {
    listIds: [5, 6],
    updateExisting: true,
    emptyContactsAttributes: false
  }
});

// Check sync status
const status = await tajo.connectors.status('brevo');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 25400,
//   campaignsSent: 142,
//   eventsTracked: 89320
// }

Suivre des événements personnalisés

// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: '[email protected]',
  event: 'product_purchased',
  eventdata: {
    id: 'txn_98765',
    data: {
      product_name: 'Premium Widget',
      price: 49.99,
      currency: 'USD'
    }
  }
});

Limites de débit

Brevo applique des limites de débit selon trois niveaux en fonction de votre plan :

Dépannage

Problèmes courants

Mode débogage

Activez la journalisation détaillée :

connectors:
  brevo:
    debug: true
    log_level: verbose
    log_webhooks: true

Tester la connexion

tajo connectors test brevo
# ✓ API connection successful
# ✓ Contacts API accessible
# ✓ Transactional email ready
# ✓ SMS sending configured
# ✓ Webhooks registered

Bonnes pratiques

1. Utilisez la rotation des clés API, Faites tourner les clés API périodiquement pour la sécurité
2. Implémentez la vérification des webhooks, Validez les signatures webhook avec l’authentification username/password
3. Imports de contacts en lot, Utilisez l’import en masse pour les gros jeux de données plutôt que des appels API individuels
4. Surveillez les limites de débit, Vérifiez les en-têtes de limite de débit pour éviter les erreurs 429
5. Utilisez le suivi d’événements, Implémentez le Brevo Tracker pour des données complètes sur le comportement client
6. Configurez correctement l’authentification de l’expéditeur, Configurez SPF, DKIM et DMARC pour une délivrabilité optimale

Sécurité

• Authentification par clé API, Accès par jeton secret via l’en-tête api-key
• OAuth 2.0, Accès délégué par jeton pour les intégrations privées
• Vérification des webhooks, Authentification username et password pour des appels webhook sécurisés
• Chiffrement TLS, Toutes les communications API chiffrées en transit
• Whitelisting d’IP, Restrictions d’IP optionnelles disponibles sur les plans Enterprise

Ressources associées

• Documentation de l’API Brevo
• Guide d’authentification Brevo
• Limites de débit Brevo
• Connecteur Shopify
• Skill Customer Sync
• API Contacts Brevo