Connettori

I connettori sono integrazioni predefinite che sincronizzano i dati tra le tue piattaforme e Brevo. Gestiscono autenticazione, mappatura dei dati e sincronizzazione in tempo reale.

Cosa sono i connettori?

Un Connettore è un ponte dati bidirezionale che:

• Autentica in modo sicuro con piattaforme esterne
• Sincronizza i dati in tempo reale o in modalità batch
• Mappa i campi tra gli schemi della piattaforma e Brevo
• Abilita le Skill ad agire sui dati sincronizzati

Connettori disponibili

Piattaforme e-commerce

Sistemi CRM

Pagamenti

Architettura dei connettori

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

Flusso dati

1. Autenticazione: Connessione sicura tramite OAuth 2.0 o API key
2. Eventi in tempo reale: I webhook catturano i cambiamenti istantaneamente
3. Sincronizzazione batch: Job pianificati per dati storici
4. Mappatura dei campi: Mappatura configurabile verso gli attributi Brevo
5. API Brevo: Dati sincronizzati con contatti, eventi e liste

Configurazione

Setup di 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

Modalità di sincronizzazione

Avvio rapido

1. Scegli il tuo connettore

Seleziona il connettore per la tua piattaforma dal catalogo qui sopra.

2. Autenticati

Connetti la tua piattaforma usando OAuth o credenziali API:

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

3. Configura la mappatura dei campi

Mappa i campi della piattaforma agli attributi di contatto Brevo:

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

4. Abilita la sincronizzazione dei dati

Avvia la sincronizzazione dei dati:

tajo connectors sync shopify --full

5. Attiva le Skill

Abilita le skill che utilizzano i dati sincronizzati:

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

Passi successivi

• Connettore Shopify - Inizia con Shopify