# Exemplo: WooCommerce REST API
source_api:
  base_url: "https://your-store.com/wp-json/wc/v3"
  auth: Basic (consumer_key:consumer_secret)
  endpoints:
    - GET /customers          # Listar clientes
    - GET /customers/{id}     # Obter detalhes do cliente
    - GET /orders             # Listar pedidos
    - GET /orders/{id}        # Obter detalhes do pedido
    - GET /products           # Listar produtos
    - GET /coupons            # Listar cupões

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

# Agente de Sincronização WooCommerce → Brevo

Ligue dados da loja WooCommerce ao Brevo para campanhas de envolvimento.

## API de Origem

- **Base URL**: https://your-store.com/wp-json/wc/v3
- **Autenticação**: Basic Auth com consumer key/secret
- **Endpoints chave**: /customers, /orders, /products

## Estratégia de Sincronização

### Sincronização de Clientes
1. GET /customers?modified_after={last_sync_time}
2. Para cada cliente:
   - Mapear campos WooCommerce para atributos Brevo
   - Criar ou atualizar contacto Brevo
   - Adicionar à lista adequada com base no histórico de pedidos

### Sincronização de Eventos de Pedidos
1. GET /orders?after={last_sync_time}&status=completed
2. Para cada pedido:
   - Rastrear evento "order_completed" no Brevo
   - Atualizar atributos do contacto (order_count, total_spent)
   - Acionar campanha pós-compra se aplicável

## Mapeamento de Campos

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

## Padrão de Chamada de API

Para cada operação de sincronização, o agente deve:
1. Chamar a REST API WooCommerce para obter dados
2. Transformar a resposta para o formato esperado pelo Brevo
3. Chamar as ferramentas MCP Brevo para criar/atualizar contactos
4. Registar resultados de sincronização para monitorização

## Regras
- Respeitar os limites de taxa da API WooCommerce (padrão: 25 req/10 segundos)
- APENAS sincronizar clientes com endereços de e-mail válidos
- Implementar sincronização incremental usando o parâmetro modified_after
- Guardar timestamp da última sincronização para a próxima execução

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

Utilizador: "Sincronize todos os clientes WooCommerce da última semana para o Brevo
     e adicione novos clientes à lista Welcome Series."

Claude: Vou sincronizar os seus clientes WooCommerce para o Brevo.

A obter clientes modificados nos últimos 7 dias do WooCommerce...
[Faz HTTP GET para your-store.com/wp-json/wc/v3/customers?modified_after=...]

Encontrei 67 clientes. A sincronizar para o Brevo...
[Usa brevo_contacts para criar/atualizar contactos]
[Usa brevo_lists para adicionar 23 novos clientes à "Welcome Series"]

Sincronização concluída:
- 67 clientes processados
- 44 contactos existentes atualizados
- 23 novos contactos criados → adicionados à Welcome Series
- 0 ignorados (todos tinham e-mails válidos)

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

# Conector {Platform} → Brevo

## Configuração da API de Origem
- **Base URL**: {api_base_url}
- **Auth**: {auth_method} ({details})
- **Limite de Taxa**: {rate_limit}

## Dados a Sincronizar

### Contactos
- Endpoint de origem: {endpoint}
- Mapeamento Brevo: {field_map}
- Frequência de sincronização: A cada 6 horas
- Incremental: Usar parâmetro modified_after / updated_since

### Eventos
- Endpoint de origem: {endpoint}
- Nome do evento Brevo: {event_name}
- Acionar: Quando {condition}

## Lógica de Sincronização
1. Obter registos alterados da origem desde a última sincronização
2. Transformar para formato Brevo
3. Upsert de contactos via brevo_contacts
4. Rastrear eventos para acionadores de campanha
5. Registar resultados e atualizar cursor de sincronização

## Tratamento de Erros
- Retentar chamadas de API falhadas 3 vezes com backoff exponencial
- Ignorar registos individuais que falhem na validação
- Reportar erros no resumo de sincronização
- NUNCA parar toda a sincronização por falha de um único registo