Sinhronizacija strank

Samodejno sinhronizirajte podatke o strankah s platforme za e-trgovino v stike Brevo. Ta skill zagotavlja, da vaš seznam stikov Brevo vedno odraža vašo trenutno bazo strank.

Pregled

Lastnost	Vrednost
Kategorija	Sinhronizacija podatkov
Stanje	Stabilno
Verzija	2.1
Sprožilci	`customer_created`, `customer_updated`, `customer_deleted`
Dejanja	Ustvari stik, Posodobi stik, Izbriši stik

Kako deluje

graph LR
    A[Platforma za e-trgovino] -->|Dogodek stranke| B[Skill sinhronizacije strank]
    B -->|Preslikava podatkov| C[Preslikava polj]
    C -->|Klic API| D[Brevo Contacts API]
    D -->|Uspeh| E[Stik posodobljen]
    D -->|Napaka| F[Čakalna vrsta ponovnih poskusov]

Zaznavanje dogodkov: Posluša dogodke življenjskega cikla stranke s vaše platforme
Preslikava podatkov: Preslika polja platforme v atribute stika Brevo
Sinhronizacija API: Ustvari, posodobi ali izbriše stike prek Brevo API
Obravnavanje napak: Ponovi neuspešne operacije z eksponentnim povratnim odmikom

Konfiguracija

Osnovna nastavitev

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

    # Preslikava polj platforme v atribute Brevo
    field_mapping:
      email: email
      firstName: FIRSTNAME
      lastName: LASTNAME
      phone: SMS

    # Možnosti sinhronizacije
    options:
      sync_mode: realtime  # ali batch
      delete_behavior: soft  # ali hard
      list_id: 5  # Dodaj na ta seznam

Preslikava polj

Preslikajte polja stranke vaše platforme v atribute stika Brevo:

Privzete preslikave polj

Parameter	Type	Description
`email` required	string	E-poštni naslov stranke. Uporablja se kot edinstveni identifikator v Brevo.
`firstName` optional	string	Ime stranke. Preslika se v atribut FIRSTNAME. Default: `FIRSTNAME`
`lastName` optional	string	Priimek stranke. Preslika se v atribut LASTNAME. Default: `LASTNAME`
`phone` optional	string	Telefonska številka v formatu E.164. Preslika se v atribut SMS za WhatsApp/SMS. Default: `SMS`
`acceptsMarketing` optional	boolean	Status soglasja za trženje. Nadzira status e-poštne naročnine. Default: `true`

Lastni atributi

Dodajte lastne preslikave atributov za podatke e-trgovine:

field_mapping:
  # Standardna polja
  email: email
  firstName: FIRSTNAME

  # Lastni atributi e-trgovine
  totalOrders: TOTAL_ORDERS
  totalSpent: TOTAL_SPENT
  lastOrderDate: LAST_ORDER_DATE
  customerTier: CUSTOMER_TIER
  tags: TAGS

Tip

Najprej ustvarite atribute: Lastne atribute je treba ustvariti v Brevo, preden jih je mogoče sinhronizirati. Za njihovo ustvarjanje uporabite nadzorno ploščo ali API Brevo.

Sprožilci

customer_created

Sproži se, ko je na vaši platformi ustvarjena nova stranka.

{
  "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

Sproži se, ko so podatki o stranki spremenjeni.

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

customer_deleted

Sproži se, ko je stranka odstranjena s vaše platforme.

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

Dejanja

Ustvari stik

Ustvari nov stik v Brevo, ko je ustvarjena stranka.

Ustvarite nov stik v vašem računu Brevo

Query Parameters

Parameter	Description
email string required	E-poštni naslov stika
attributes object optional	Atributi stika
listIds array optional	ID-ji seznamov, na katere se doda stik
updateEnabled boolean optional	Posodobi, če stik obstaja Default: `false`

Responses

201 Stik uspešno ustvarjen

400 Neveljavni parametri zahteve

409 Stik že obstaja

Posodobi stik

Posodobi obstoječi stik, ko se spremenijo podatki o stranki.

Posodobite atribute obstoječega stika

Path Parameters

Parameter	Description
identifier string required	E-pošta ali ID stika

Query Parameters

Parameter	Description
attributes object optional	Atributi za posodobitev
listIds array optional	Seznami, na katere se doda stik
unlinkListIds array optional	Seznami, s katerih se stik odstrani

Responses

204 Stik uspešno posodobljen

400 Neveljavni parametri zahteve

404 Stik ni najden

Izbriši stik

Odstrani stik, ko je stranka izbrisana.

Trajno izbrišite stik iz Brevo

Path Parameters

Parameter	Description
identifier string required	E-pošta ali ID stika

Responses

204 Stik uspešno izbrisan

404 Stik ni najden

Primeri kode

JavaScript (Node.js)

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

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

// Aktivacija skill sinhronizacije strank
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
  }
});

// Ročna sprožitev sinhronizacije
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']
)

# Aktivacija skill sinhronizacije strank
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
    }
})

# Ročna sprožitev sinhronizacije
tajo.skills.trigger('customer-sync', {
    'event': 'customer_updated',
    'data': {
        'email': '[email protected]',
        'total_orders': 10,
        'total_spent': 1250.00
    }
})

Nadzor

Nadzorna plošča stanja sinhronizacije

Spremljajte delovanje sinhronizacije na nadzorni plošči Tajo:

Stopnja uspešnosti sinhronizacije: Odstotek uspešnih sinhronizacij
Povprečna latenca: Čas od dogodka do posodobitve Brevo
Stopnja napak: Neuspešni poskusi sinhronizacije
Globina čakalne vrste: Čakajoče operacije sinhronizacije

Obvestila prek webhookov

Prejemajte obvestila o dogodkih sinhronizacije:

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

Odpravljanje težav

Pogoste težave

Stik že obstaja (409)

V svoji konfiguraciji aktivirajte updateEnabled: true, da posodobite obstoječe stike namesto neuspeha.

Napaka	Vzrok	Rešitev
`Contact already exists`	Stik z e-pošto obstaja	Aktivirajte `updateEnabled: true`
`Invalid attribute`	Atribut v Brevo ne obstaja	Najprej ustvarite atribut v Brevo
`Rate limit exceeded`	Preveč zahtev API	Uporabite način serijske sinhronizacije
`Invalid email format`	Napačen format e-poštnega naslova	Preverite e-poštne naslove pred sinhronizacijo

Način odpravljanja napak

Aktivirajte podrobno beleženje za odpravljanje težav:

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

Sorodni Skills

Dogodki naročil – Sinhronizacija podatkov naročil
Katalog izdelkov – Sinhronizacija podatkov izdelkov
Dogodki košarice – Sledenje aktivnosti košarice

Naslednji koraki

Konfigurirajte preslikave polj za vašo platformo
Nastavite lastne atribute v Brevo
Aktivirajte sinhronizacijo v realnem času za takojšnje posodobitve

Sinhronizacija strank