Ügyfél-szinkronizálás

Automatikusan szinkronizálja az ügyféladatokat e-kereskedelmi platformjáról a Brevo kapcsolatokba. Ez a skill gondoskodik arról, hogy a Brevo kapcsolati listája mindig tükrözze az aktuális ügyfélkörét.

Áttekintés

Tulajdonság	Érték
Kategória	Adatszinkronizálás
Állapot	Stabil
Verzió	2.1
Kiváltók	`customer_created`, `customer_updated`, `customer_deleted`
Műveletek	Kapcsolat létrehozása, Kapcsolat frissítése, Kapcsolat törlése

Hogyan működik

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]

Esemény észlelés: Figyeli az ügyfél életciklusával kapcsolatos eseményeket a platformon
Adatleképezés: Platformmezőket képez le Brevo kapcsolati attribútumokra
API szinkronizálás: Kapcsolatokat hoz létre, frissít vagy töröl a Brevo API-n keresztül
Hibakezelés: Exponenciális visszalépéssel próbálja újra a sikertelen műveleteket

Konfiguráció

Alapbeállítás

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

    # Platformmezők leképezése Brevo attribútumokra
    field_mapping:
      email: email
      firstName: FIRSTNAME
      lastName: LASTNAME
      phone: SMS

    # Szinkronizálási beállítások
    options:
      sync_mode: realtime  # or batch
      delete_behavior: soft  # or hard
      list_id: 5  # Hozzáadás ehhez a listához

Mező-leképezés

Képezze le a platform ügyfélmezőit a Brevo kapcsolati attribútumokra:

Alapértelmezett mező-leképezések

Parameter	Type	Description
`email` required	string	Ügyfél email-cím. A Brevo egyedi azonosítójaként szolgál.
`firstName` optional	string	Az ügyfél keresztneve. A FIRSTNAME attribútumra képezi le. Default: `FIRSTNAME`
`lastName` optional	string	Az ügyfél vezetékneve. A LASTNAME attribútumra képezi le. Default: `LASTNAME`
`phone` optional	string	Telefonszám E.164 formátumban. WhatsApp/SMS esetén az SMS attribútumra képezi le. Default: `SMS`
`acceptsMarketing` optional	boolean	Marketing hozzájárulás állapota. Az email feliratkozási állapotot vezérli. Default: `true`

Egyéni attribútumok

Adjon hozzá egyéni attribútum-leképezéseket az e-kereskedelmi adatokhoz:

field_mapping:
  # Alapmezők
  email: email
  firstName: FIRSTNAME

  # Egyéni e-kereskedelmi attribútumok
  totalOrders: TOTAL_ORDERS
  totalSpent: TOTAL_SPENT
  lastOrderDate: LAST_ORDER_DATE
  customerTier: CUSTOMER_TIER
  tags: TAGS

Tip

Először hozza létre az attribútumokat: Az egyéni attribútumokat a Brevo-ban kell létrehozni, mielőtt szinkronizálhatók lennének. Ehhez használja a Brevo irányítópultját vagy az API-t.

Kiváltók

customer_created

Akkor aktiválódik, ha új ügyfél jön létre a platformon.

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

Akkor aktiválódik, ha az ügyfél adatai módosulnak.

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

customer_deleted

Akkor aktiválódik, ha egy ügyfelet eltávolítanak a platformról.

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

Műveletek

Kapcsolat létrehozása

Új kapcsolatot hoz létre a Brevo-ban, ha egy ügyfél létrejön.

Új kapcsolat létrehozása a Brevo fiókban

Query Parameters

Parameter	Description
email string required	Kapcsolat email-cím
attributes object optional	Kapcsolat attribútumai
listIds array optional	Lista azonosítók a kapcsolat hozzáadásához
updateEnabled boolean optional	Frissítés ha a kapcsolat már létezik Default: `false`

Responses

201 Kapcsolat sikeresen létrehozva

400 Érvénytelen kérési paraméterek

409 A kapcsolat már létezik

Kapcsolat frissítése

Frissíti a meglévő kapcsolatot, ha az ügyféladatok megváltoznak.

Meglévő kapcsolat attribútumainak frissítése

Path Parameters

Parameter	Description
identifier string required	Email-cím vagy kapcsolat azonosítója

Query Parameters

Parameter	Description
attributes object optional	Frissítendő attribútumok
listIds array optional	Listák, amelyekhez a kapcsolatot hozzá kell adni
unlinkListIds array optional	Listák, amelyekből a kapcsolatot el kell távolítani

Responses

204 Kapcsolat sikeresen frissítve

400 Érvénytelen kérési paraméterek

404 A kapcsolat nem található

Kapcsolat törlése

Eltávolítja a kapcsolatot, ha egy ügyfelet törölnek.

Kapcsolat végleges törlése a Brevo-ból

Path Parameters

Parameter	Description
identifier string required	Email-cím vagy kapcsolat azonosítója

Responses

204 Kapcsolat sikeresen törölve

404 A kapcsolat nem található

Kódpéldák

JavaScript (Node.js)

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

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

// Ügyfél-szinkronizálási skill engedélyezése
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
  }
});

// Szinkronizálás kézi indítása
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']
)

# Ügyfél-szinkronizálási skill engedélyezése
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
    }
})

# Szinkronizálás kézi indítása
tajo.skills.trigger('customer-sync', {
    'event': 'customer_updated',
    'data': {
        'email': '[email protected]',
        'total_orders': 10,
        'total_spent': 1250.00
    }
})

Megfigyelés

Szinkronizálási állapot irányítópult

Kövesse nyomon a szinkronizálás teljesítményét a Tajo irányítópultján:

Szinkronizálás sikeressége: Sikeres szinkronizálások aránya
Átlagos késleltetés: Az eseménytől a Brevo frissítéséig eltelt idő
Hibaráta: Sikertelen szinkronizálási kísérletek
Várósor mélysége: Függőben lévő szinkronizálási műveletek

Webhook értesítések

Értesítések fogadása szinkronizálási eseményekről:

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

Hibaelhárítás

Gyakori problémák

A kapcsolat már létezik (409)

Engedélyezze az updateEnabled: true beállítást a konfigurációban, hogy frissítse a meglévő kapcsolatokat ahelyett, hogy hibát generálna.

Hiba	Ok	Megoldás
`Contact already exists`	Email-címmel rendelkező kapcsolat már létezik	Engedélyezze az `updateEnabled: true` beállítást
`Invalid attribute`	Az attribútum nem létezik a Brevo-ban	Először hozza létre az attribútumot a Brevo-ban
`Rate limit exceeded`	Túl sok API-kérés	Használja a kötegelt szinkronizálási módot
`Invalid email format`	Hibás email-cím formátum	Érvényesítse az email-eket szinkronizálás előtt

Hibakeresési mód

Engedélyezze a részletes naplózást a hibakereséshez:

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

Kapcsolódó Skillек

Rendelési események – Rendelési adatok szinkronizálása
Termékkatalógus – Termékadatok szinkronizálása
Kosáresemények – Kosártevékenység követése

Következő lépések

Konfigurálja a mező-leképezéseket a platformján
Hozzon létre egyéni attribútumokat a Brevo-ban
Engedélyezze a valós idejű szinkronizálást az azonnali frissítésekhez

Ügyfél-szinkronizálás