Connecteurs

Connecteurs

Les connecteurs sont des intégrations prêtes à l’emploi qui synchronisent les données entre vos plateformes et Brevo. Ils gèrent l’authentification, le mappage des données et la synchronisation en temps réel.

Que sont les connecteurs ?

Un connecteur est un pont de données bidirectionnel qui :

• S’authentifie en toute sécurité avec des plateformes externes
• Synchronise les données en temps réel ou en mode batch
• Mappe les champs entre les schémas de plateforme et Brevo
• Active les skills pour agir sur les données synchronisées

Connecteurs disponibles

Plateformes e-commerce

Systèmes CRM

Paiements

Architecture des connecteurs

graph LR
    A[Your Platform] <-->|OAuth/API Key| B[Tajo Connector]
    B <-->|Real-time Webhooks| C[Event Processing]
    C --> D[Field Mapping]
    D --> E[Brevo API]
    B <-->|Batch Sync| F[Scheduled Jobs]
    F --> D

Flux de données

1. Authentification : connexion sécurisée via OAuth 2.0 ou clés API
2. Événements en temps réel : les webhooks capturent les changements instantanément
3. Synchronisation batch : tâches planifiées pour les données historiques
4. Mappage des champs : mappage configurable vers les attributs Brevo
5. API Brevo : données synchronisées vers les contacts, événements et listes

Configuration

Configuration de base

connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_key: "${SHOPIFY_API_KEY}"
    api_secret: "${SHOPIFY_API_SECRET}"

    # Data sync settings
    sync:
      customers: true
      orders: true
      products: true
      carts: true

    # Field mappings
    field_mapping:
      email: email
      first_name: FIRSTNAME
      last_name: LASTNAME
      total_spent: TOTAL_SPENT

Modes de synchronisation

Démarrage rapide

1. Choisissez votre connecteur

Sélectionnez le connecteur de votre plateforme dans le catalogue ci-dessus.

2. Authentifiez-vous

Connectez votre plateforme via OAuth ou avec des identifiants API :

tajo connectors connect shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY

3. Configurez le mappage des champs

Mappez les champs de la plateforme vers les attributs de contact Brevo :

field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  totalOrders: ORDER_COUNT
  totalSpent: TOTAL_REVENUE
  lastOrderDate: LAST_ORDER_DATE

4. Activez la synchronisation des données

Démarrez la synchronisation :

tajo connectors sync shopify --full

5. Activez les skills

Activez les skills qui utilisent les données synchronisées :

tajo skills enable abandoned-cart
tajo skills enable customer-sync

Connecteurs personnalisés

Construisez votre propre connecteur pour les plateformes absentes du catalogue :

Connector SDK

import { ConnectorSDK } from '@tajo/connector-sdk';

const connector = new ConnectorSDK({
  name: 'my-platform',
  version: '1.0.0',

  // Authentication
  auth: {
    type: 'oauth2',
    authorizationUrl: 'https://api.myplatform.com/oauth/authorize',
    tokenUrl: 'https://api.myplatform.com/oauth/token'
  },

  // Data mappings
  resources: {
    customers: {
      endpoint: '/api/customers',
      mapping: {
        email: 'contact.email',
        name: 'contact.full_name'
      }
    }
  },

  // Webhooks
  webhooks: {
    customer_created: '/webhooks/customer',
    order_placed: '/webhooks/order'
  }
});

export default connector;

Prochaines étapes

• Connecteur Shopify, Démarrez avec Shopify
• Guide de mappage des données, Apprenez le mappage des champs
• Connector SDK, Construisez des connecteurs personnalisés
• Patterns d’authentification, Sécurisez vos connexions