Kundesynkronisering

Synkroniser automatisk kundedata fra din e-handelsplatform til Brevo-kontakter. Denne skill sikrer, at din Brevo-kontaktliste altid afspejler din aktuelle kundebase.

Oversigt

Egenskab	Værdi
Kategori	Datasynkronisering
Status	Stabil
Version	2.1
Triggere	`customer_created`, `customer_updated`, `customer_deleted`
Handlinger	Opret kontakt, opdater kontakt, slet kontakt

Sådan fungerer det

graph LR
    A[E-commerce Platform] -->|Customer Event| B[Customer Sync Skill]
    B -->|Map Data| C[Field Mapping]
    C -->|API Call| D[Brevo Contacts API]
    D -->|Success| E[Contact Updated]
    D -->|Error| F[Retry Queue]

Hændelsesregistrering: Lytter efter kundelivscyklushændelser fra din platform
Datamapping: Mapper platformsfelter til Brevo-kontaktattributter
API-synkronisering: Opretter, opdaterer eller sletter kontakter via Brevo API
Fejlhåndtering: Prøver mislykkede handlinger igen med eksponentiel backoff

Konfiguration

Grundlæggende opsætning

skills:
  customer-sync:
    enabled: true
    source: shopify  # or woocommerce, magento, custom

    # Map platform fields to Brevo attributes
    field_mapping:
      email: email
      firstName: FIRSTNAME
      lastName: LASTNAME
      phone: SMS

    # Sync options
    options:
      sync_mode: realtime  # or batch
      delete_behavior: soft  # or hard
      list_id: 5  # Add to this list

Feltmapping

Map din platforms kundefelter til Brevo-kontaktattributter:

Standard-feltmappings

Parameter	Type	Description
`email` required	string	Kundens e-mailadresse. Bruges som den unikke identifikator i Brevo.
`firstName` optional	string	Kundens fornavn. Mappes til FIRSTNAME-attributten. Default: `FIRSTNAME`
`lastName` optional	string	Kundens efternavn. Mappes til LASTNAME-attributten. Default: `LASTNAME`
`phone` optional	string	Telefonnummer i E.164-format. Mappes til SMS-attributten for WhatsApp/SMS. Default: `SMS`
`acceptsMarketing` optional	boolean	Markedsføringstilmeldingsstatus. Styrer e-mailabonnementsstatus. Default: `true`

Tilpassede attributter

Tilføj tilpassede attributmappings for e-handelsdata:

field_mapping:
  # Standard fields
  email: email
  firstName: FIRSTNAME

  # Custom e-commerce attributes
  totalOrders: TOTAL_ORDERS
  totalSpent: TOTAL_SPENT
  lastOrderDate: LAST_ORDER_DATE
  customerTier: CUSTOMER_TIER
  tags: TAGS

Tip

Opret attributter først: Tilpassede attributter skal oprettes i Brevo, før de kan synkroniseres. Brug Brevo-dashboardet eller API’et til at oprette dem.

Triggere

customer_created

Udløses, når en ny kunde oprettes på din platform.

{
  "event": "customer_created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "cust_12345",
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+1234567890",
    "acceptsMarketing": true,
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

customer_updated

Udløses, når kundeoplysninger ændres.

{
  "event": "customer_updated",
  "timestamp": "2024-01-15T14:45:00Z",
  "data": {
    "id": "cust_12345",
    "email": "[email protected]",
    "changes": {
      "phone": {
        "old": null,
        "new": "+1234567890"
      }
    }
  }
}

customer_deleted

Udløses, når en kunde fjernes fra din platform.

{
  "event": "customer_deleted",
  "timestamp": "2024-01-15T16:00:00Z",
  "data": {
    "id": "cust_12345",
    "email": "[email protected]",
    "deletedAt": "2024-01-15T16:00:00Z"
  }
}

Handlinger

Opret kontakt

Opretter en ny kontakt i Brevo, når en kunde oprettes.

Opret en ny kontakt på din Brevo-konto

Query Parameters

Parameter	Description
email string required	Kontaktens e-mailadresse
attributes object optional	Kontaktattributter
listIds array optional	Liste-ID'er som kontakten skal tilføjes til
updateEnabled boolean optional	Opdater hvis kontakten findes Default: `false`

Responses

201 Kontakt oprettet

400 Ugyldige anmodningsparametre

409 Kontakten findes allerede

Opdater kontakt

Opdaterer en eksisterende kontakt, når kundedata ændres.

Opdater en eksisterende kontakts attributter

Path Parameters

Parameter	Description
identifier string required	E-mail eller kontakt-ID

Query Parameters

Parameter	Description
attributes object optional	Attributter der skal opdateres
listIds array optional	Lister som kontakten skal tilføjes til
unlinkListIds array optional	Lister som kontakten skal fjernes fra

Responses

204 Kontakt opdateret

400 Ugyldige anmodningsparametre

404 Kontakt ikke fundet

Slet kontakt

Fjerner en kontakt, når en kunde slettes.

Slet en kontakt permanent fra Brevo

Path Parameters

Parameter	Description
identifier string required	E-mail eller kontakt-ID

Responses

204 Kontakt slettet

404 Kontakt ikke fundet

Kodeeksempler

JavaScript (Node.js)

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

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

// Enable customer sync skill
await tajo.skills.enable('customer-sync', {
  source: 'shopify',
  fieldMapping: {
    email: 'email',
    firstName: 'FIRSTNAME',
    lastName: 'LASTNAME',
    totalOrders: 'TOTAL_ORDERS',
    totalSpent: 'TOTAL_SPENT'
  },
  options: {
    syncMode: 'realtime',
    listId: 5
  }
});

// Manually trigger a sync
await tajo.skills.trigger('customer-sync', {
  event: 'customer_created',
  data: {
    email: '[email protected]',
    firstName: 'Jane',
    lastName: 'Smith'
  }
});

Python

from tajo import TajoClient

tajo = TajoClient(
    api_key=os.environ['TAJO_API_KEY'],
    brevo_api_key=os.environ['BREVO_API_KEY']
)

# Enable customer sync skill
tajo.skills.enable('customer-sync', {
    'source': 'woocommerce',
    'field_mapping': {
        'email': 'email',
        'first_name': 'FIRSTNAME',
        'last_name': 'LASTNAME',
        'total_orders': 'TOTAL_ORDERS'
    },
    'options': {
        'sync_mode': 'realtime',
        'list_id': 5
    }
})

# Manually trigger a sync
tajo.skills.trigger('customer-sync', {
    'event': 'customer_updated',
    'data': {
        'email': '[email protected]',
        'total_orders': 10,
        'total_spent': 1250.00
    }
})

Overvågning

Dashboard for synkroniseringsstatus

Overvåg synkroniseringsydelsen i Tajo-dashboardet:

Synkroniseringssuccessrate: Procentdel af vellykkede synkroniseringer
Gennemsnitlig latenstid: Tid fra hændelse til Brevo-opdatering
Fejlrate: Mislykkede synkroniseringsforsøg
Kødybde: Ventende synkroniseringsoperationer

Webhook-notifikationer

Modtag notifikationer for synkroniseringshændelser:

notifications:
  webhook_url: https://your-app.com/webhooks/tajo
  events:
    - sync_completed
    - sync_failed
    - batch_completed

Fejlfinding

Almindelige problemer

Kontakten findes allerede (409)

Aktivér updateEnabled: true i din konfiguration for at opdatere eksisterende kontakter i stedet for at fejle.

Fejl	Årsag	Løsning
`Contact already exists`	Kontakt med e-mail findes	Aktivér `updateEnabled: true`
`Invalid attribute`	Attribut findes ikke i Brevo	Opret attributten i Brevo først
`Rate limit exceeded`	For mange API-forespørgsler	Brug batch-synkroniseringstilstand
`Invalid email format`	Forkert formateret e-mailadresse	Valider e-mails før synkronisering

Fejlfindingstilstand

Aktivér fejlfindingslogning til fejlfinding:

skills:
  customer-sync:
    debug: true
    log_level: verbose

Relaterede skills

Ordrehændelser - Synkroniser ordredata
Produktkatalog - Synkroniser produktdata
Kurvhændelser - Spor kurvaktivitet

Næste skridt

Konfigurer feltmappings til din platform
Opsæt tilpassede attributter i Brevo
Aktivér realtidssynkronisering for øjeblikkelige opdateringer

Kundesynkronisering