# Példa: WooCommerce REST API
source_api:
  base_url: "https://your-store.com/wp-json/wc/v3"
  auth: Basic (consumer_key:consumer_secret)
  endpoints:
    - GET /customers          # Ügyfelek listázása
    - GET /customers/{id}     # Ügyfél részletek lekérése
    - GET /orders             # Rendelések listázása
    - GET /orders/{id}        # Rendelés részletek lekérése
    - GET /products           # Termékek listázása
    - GET /coupons            # Kuponok listázása

---
name: woocommerce-brevo-sync
description: Sync WooCommerce customers and orders to Brevo
version: 1.0.0
temperature: 0.1
tools:
  - brevo_contacts
  - brevo_attributes
  - brevo_lists
  - brevo_email_campaign_management
triggers:
  - schedule: "0 */6 * * *"
  - webhook: /agents/woocommerce/sync
    method: POST
---

# WooCommerce → Brevo szinkronizáló ügynök

Csatlakoztassa a WooCommerce áruházi adatait a Brevo-hoz interakciós kampányokhoz.

## Forrás API

- **Alap URL**: https://your-store.com/wp-json/wc/v3
- **Hitelesítés**: Basic Auth consumer key/secret-tel
- **Kulcsvégpontok**: /customers, /orders, /products

## Szinkronizálási stratégia

### Ügyfél szinkronizálás
1. GET /customers?modified_after={last_sync_time}
2. Minden ügyfélre:
   - WooCommerce mezők leképezése Brevo attribútumokra
   - Brevo kapcsolat létrehozása vagy frissítése
   - Hozzáadás a megfelelő listához rendelési előzmények alapján

### Rendelési esemény szinkronizálás
1. GET /orders?after={last_sync_time}&status=completed
2. Minden rendelésre:
   - "order_completed" esemény követése a Brevo-ban
   - Kapcsolat attribútumok frissítése (order_count, total_spent)
   - Vásárlás utáni kampány indítása, ha alkalmazható

## Mezőleképezés

| WooCommerce | Brevo attribútum |
|-------------|-----------------|
| email | EMAIL |
| first_name | FIRSTNAME |
| last_name | LASTNAME |
| billing.phone | SMS |
| orders_count | ORDER_COUNT |
| total_spent | TOTAL_SPENT |
| date_created | CUSTOMER_SINCE |
| role | CUSTOMER_TYPE |

## API hívás minta

Minden szinkronizálási művelethez az ügynök:
1. Meghívja a WooCommerce REST API-t az adatok lekéréséhez
2. Átalakítja a választ a Brevo elvárt formátumára
3. Meghívja a Brevo MCP eszközöket a kapcsolatok létrehozásához/frissítéséhez
4. Naplózza a szinkronizálási eredményeket a monitoringhoz

## Szabályok
- Tartsa tiszteletben a WooCommerce API sebességkorlátokat (alapértelmezett: 25 kérés/10 másodperc)
- CSAK érvényes emailcímmel rendelkező ügyfeleket szinkronizáljon
- Implementáljon növekményes szinkronizálást modified_after paraméterrel
- Tárolja el az utolsó szinkronizálás időbélyegét a következő futtatáshoz

{
  "mcpServers": {
    "brevo_contacts": {
      "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp",
      "headers": { "Authorization": "Bearer your-brevo-token" }
    },
    "brevo_email": {
      "url": "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp",
      "headers": { "Authorization": "Bearer your-brevo-token" }
    },
    "brevo_lists": {
      "url": "https://mcp.brevo.com/v1/brevo_lists/mcp",
      "headers": { "Authorization": "Bearer your-brevo-token" }
    }
  }
}

Ön: "Szinkronizálja az összes WooCommerce ügyfelet az elmúlt hétből a Brevo-ba
     és adja az új ügyfeleket a Welcome Series listához."

Claude: Szinkronizálom a WooCommerce ügyfeleket a Brevo-ba.

Az elmúlt 7 napban módosított ügyfelek lekérése a WooCommerce-ből...
[HTTP GET hívás: your-store.com/wp-json/wc/v3/customers?modified_after=...]

67 ügyfelet találtam. Szinkronizálás a Brevo-ba...
[A brevo_contacts segítségével kapcsolatokat hoz létre/frissít]
[A brevo_lists segítségével 23 új ügyfelet ad a "Welcome Series" listához]

Szinkronizálás kész:
- 67 ügyfél feldolgozva
- 44 meglévő kapcsolat frissítve
- 23 új kapcsolat létrehozva → hozzáadva a Welcome Series-hez
- 0 kihagyva (mindegyiknek volt érvényes emailje)

---
name: {platform}-brevo-connector
description: Sync {platform} data to Brevo for engagement
version: 1.0.0
temperature: 0.1
tools:
  - brevo_contacts
  - brevo_attributes
  - brevo_lists
triggers:
  - schedule: "0 */6 * * *"
---

# {Platform} → Brevo csatlakozó

## Forrás API konfiguráció
- **Alap URL**: {api_base_url}
- **Hitelesítés**: {auth_method} ({details})
- **Sebességkorlát**: {rate_limit}

## Szinkronizálandó adatok

### Kapcsolatok
- Forrás végpont: {endpoint}
- Brevo leképezés: {field_map}
- Szinkronizálási gyakoriság: Minden 6 órában
- Növekményes: modified_after / updated_since paraméter használata

### Események
- Forrás végpont: {endpoint}
- Brevo esemény neve: {event_name}
- Kiváltó: Amikor {condition}

## Szinkronizálási logika
1. Módosított rekordok lekérése a forrásból az utolsó szinkronizálás óta
2. Átalakítás Brevo formátumra
3. Kapcsolatok upsert-je brevo_contacts-on keresztül
4. Kampánykiváltókhoz szükséges események követése
5. Eredmények naplózása és szinkronizálási kurzor frissítése

## Hibakezelés
- Sikertelen API hívások újrapróbálása 3-szor exponenciális visszatartással
- Validálást nem teljesítő egyedi rekordok kihagyása
- Hibák riportálása a szinkronizálási összefoglalóban
- SOHA ne állítsa le a teljes szinkronizálást egyetlen rekord hibája miatt