# Пример: WooCommerce REST API
source_api:
  base_url: "https://your-store.com/wp-json/wc/v3"
  auth: Basic (consumer_key:consumer_secret)
  endpoints:
    - GET /customers          # Списък клиенти
    - GET /customers/{id}     # Детайли за клиент
    - GET /orders             # Списък поръчки
    - GET /orders/{id}        # Детайли за поръчка
    - GET /products           # Списък продукти
    - GET /coupons            # Списък купони

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

Свържете данните на магазина WooCommerce с Brevo за кампании за ангажиране.

## Изходен API

- **Base URL**: https://your-store.com/wp-json/wc/v3
- **Удостоверяване**: Basic Auth с Consumer Key/Secret
- **Ключови крайни точки**: /customers, /orders, /products

## Стратегия за синхронизация

### Синхронизация на клиенти
1. GET /customers?modified_after={last_sync_time}
2. За всеки клиент:
   - Съпоставете полетата на WooCommerce с атрибутите на Brevo
   - Създайте или актуализирайте контакта в Brevo
   - Добавете към подходящ списък въз основа на историята на поръчките

### Синхронизация на поръчки
1. GET /orders?after={last_sync_time}&status=completed
2. За всяка поръчка:
   - Проследявайте събитието "order_completed" в Brevo
   - Актуализирайте атрибутите на контакта (order_count, total_spent)
   - Задействайте кампания след покупка ако е приложимо

## Съпоставяне на полета

| WooCommerce | Атрибут в 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 |

## Модел на API извиквания

За всяка операция по синхронизация агентът трябва да:
1. Извика WooCommerce REST API за вземане на данни
2. Трансформира отговора в очаквания формат на Brevo
3. Извика MCP инструментите на Brevo за създаване/актуализиране на контакти
4. Регистрира резултатите от синхронизацията за мониторинг

## Правила
- Спазвайте ограниченията на честотата на WooCommerce API (по подразбиране: 25 заявки/10 секунди)
- СИНХРОНИЗИРАЙТЕ САМО клиенти с валидни имейл адреси
- Прилагайте инкрементална синхронизация с параметъра modified_after
- Съхранявайте времевия печат на последната синхронизация за следващото стартиране

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

Вие: "Синхронизирайте всички клиенти от WooCommerce от последната седмица с Brevo
     и добавете новите клиенти към списъка Серия добре дошли."

Claude: Ще синхронизирам вашите клиенти от WooCommerce с Brevo.

Вземане на клиенти, модифицирани в последните 7 дни от WooCommerce...
[Прави HTTP GET към your-store.com/wp-json/wc/v3/customers?modified_after=...]

Намерени 67 клиента. Синхронизация с Brevo...
[Използва brevo_contacts за създаване/актуализиране на контакти]
[Използва brevo_lists за добавяне на 23 нови клиенти към "Серия добре дошли"]

Синхронизацията е завършена:
- 67 клиента обработени
- 44 съществуващи контакта актуализирани
- 23 нови контакта създадени → добавени към Серия добре дошли
- 0 пропуснати (всички имаха валидни имейли)

---
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 конектор

## Конфигурация на изходния API
- **Base URL**: {api_base_url}
- **Auth**: {auth_method} ({details})
- **Rate Limit**: {rate_limit}

## Данни за синхронизиране

### Контакти
- Изходна крайна точка: {endpoint}
- Съпоставяне с Brevo: {field_map}
- Честота на синхронизация: На всеки 6 часа
- Инкрементална: Използвайте параметъра modified_after / updated_since

### Събития
- Изходна крайна точка: {endpoint}
- Наименование на събитие в Brevo: {event_name}
- Тригер: При {condition}

## Логика на синхронизацията
1. Вземете променените записи от изходния API след последната синхронизация
2. Трансформирайте в формата на Brevo
3. Актуализирайте контактите чрез brevo_contacts
4. Проследявайте събитията за тригери на кампании
5. Регистрирайте резултатите и актуализирайте курсора за синхронизация

## Обработка на грешки
- Повтаряйте неуспешните API извиквания 3 пъти с експоненциално изчакване
- Пропускайте отделни записи, неуспешни при валидация
- Докладвайте грешките в резюмето на синхронизацията
- НИКОГА не спирайте цялата синхронизация при грешка на отделен запис