# Příklad: WooCommerce REST API
source_api:
  base_url: "https://your-store.com/wp-json/wc/v3"
  auth: Basic (consumer_key:consumer_secret)
  endpoints:
    - GET /customers          # Seznam zákazníků
    - GET /customers/{id}     # Podrobnosti zákazníka
    - GET /orders             # Seznam objednávek
    - GET /orders/{id}        # Podrobnosti objednávky
    - GET /products           # Seznam produktů
    - GET /coupons            # Seznam kupónů

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

# Agent synchronizace WooCommerce → Brevo

Propojte data obchodu WooCommerce s Brevo pro engagementové kampaně.

## Zdrojové API

- **Base URL**: https://your-store.com/wp-json/wc/v3
- **Autentizace**: Basic Auth s consumer key/secret
- **Klíčové endpointy**: /customers, /orders, /products

## Strategie synchronizace

### Synchronizace zákazníků
1. GET /customers?modified_after={last_sync_time}
2. Pro každého zákazníka:
   - Mapujte pole WooCommerce na atributy Brevo
   - Vytvořte nebo aktualizujte kontakt Brevo
   - Přidejte do příslušného seznamu na základě historie objednávek

### Synchronizace událostí objednávek
1. GET /orders?after={last_sync_time}&status=completed
2. Pro každou objednávku:
   - Sledujte událost "order_completed" v Brevo
   - Aktualizujte atributy kontaktu (order_count, total_spent)
   - Spusťte kampaň po nákupu, pokud je to vhodné

## Mapování polí

| WooCommerce | Atribut Brevo |
|-------------|-----------------|
| 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 |

## Vzorec volání API

Pro každou operaci synchronizace by agent měl:
1. Volat REST API WooCommerce pro načtení dat
2. Transformovat odpověď do očekávaného formátu Brevo
3. Volat nástroje Brevo MCP pro vytvoření/aktualizaci kontaktů
4. Zaznamenat výsledky synchronizace pro monitoring

## Pravidla
- Respektujte limity rychlosti API WooCommerce (výchozí: 25 req/10 sekund)
- Synchronizujte POUZE zákazníky s platnými e-mailovými adresami
- Implementujte inkrementální synchronizaci pomocí parametru modified_after
- Ukládejte časové razítko poslední synchronizace pro další spuštění

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

Vy: "Synchronizujte všechny zákazníky WooCommerce z posledního týdne do Brevo
     a přidejte nové zákazníky do seznamu Welcome Series."

Claude: Synchronizuji vaše zákazníky WooCommerce do Brevo.

Načítám zákazníky změněné v posledních 7 dnech z WooCommerce...
[Provádí HTTP GET na your-store.com/wp-json/wc/v3/customers?modified_after=...]

Nalezeno 67 zákazníků. Synchronizuji do Brevo...
[Používá brevo_contacts k vytvoření/aktualizaci kontaktů]
[Používá brevo_lists k přidání 23 nových zákazníků do "Welcome Series"]

Synchronizace dokončena:
- 67 zákazníků zpracováno
- 44 stávajících kontaktů aktualizováno
- 23 nových kontaktů vytvořeno → přidáno do Welcome Series
- 0 přeskočeno (všichni měli platné e-maily)

---
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 konektor

## Konfigurace zdrojového API
- **Base URL**: {api_base_url}
- **Auth**: {auth_method} ({details})
- **Rate Limit**: {rate_limit}

## Data k synchronizaci

### Kontakty
- Zdrojový endpoint: {endpoint}
- Mapování Brevo: {field_map}
- Frekvence synchronizace: Každých 6 hodin
- Inkrementální: Použijte parametr modified_after / updated_since

### Události
- Zdrojový endpoint: {endpoint}
- Název události Brevo: {event_name}
- Spouštěč: Při {condition}

## Logika synchronizace
1. Načtěte změněné záznamy ze zdroje od poslední synchronizace
2. Transformujte do formátu Brevo
3. Upsert kontaktů přes brevo_contacts
4. Sledujte události pro spouštěče kampaní
5. Zaznamenejte výsledky a aktualizujte kurzor synchronizace

## Zpracování chyb
- Opakujte neúspěšná API volání 3krát s exponenciálním back-off
- Přeskočte jednotlivé záznamy, které selžou při validaci
- Nahlaste chyby v souhrnu synchronizace
- NIKDY nezastavujte celou synchronizaci kvůli selhání jednotlivého záznamu