Integração WooCommerce + Brevo

WooCommerce + Brevo

Ligue dados da loja WooCommerce à plataforma de envolvimento do Brevo através de MCP. Sincronize clientes, automatize campanhas orientadas por pedidos, recupere carrinhos abandonados e segmente compradores, tudo orquestrado por agentes de IA no Claude.

Servidores MCP Utilizados

ServidorPacote/URLAutenticaçãoPropósito
WooCommerce MCPwoocommerce-mcp-serverConsumer Key/SecretClientes, pedidos, produtos, cupões, relatórios
Brevo MCPmcp.brevo.com/v1/brevo/mcpTokenContactos, campanhas de e-mail, SMS, WhatsApp, rastreamento de eventos

Tip

O WooCommerce usa a REST API WordPress com autenticação por consumer key. O servidor MCP envolve estes endpoints para que o Claude possa ler os dados da sua loja junto com o Brevo. Certifique-se de que a sua REST API WooCommerce está ativada em WooCommerce > Definições > Avançado > REST API.

Configuração

Passo 1: Criar Chaves de API WooCommerce

  1. No Painel WordPress, aceda a WooCommerce > Definições > Avançado > REST API
  2. Clique em Adicionar Chave, defina permissões como Leitura e gere
  3. Anote a sua Consumer Key e Consumer Secret

Passo 2: Ligar Ambos os Servidores MCP

{
"mcpServers": {
"brevo": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.brevo.com/v1/brevo/mcp",
"--header",
"Authorization: Bearer ${BREVO_MCP_TOKEN}"
],
"env": {
"BREVO_MCP_TOKEN": "your-brevo-mcp-token"
}
},
"woocommerce": {
"command": "npx",
"args": ["-y", "woocommerce-mcp-server"],
"env": {
"WOO_STORE_URL": "https://your-store.com",
"WOO_CONSUMER_KEY": "ck_your_consumer_key",
"WOO_CONSUMER_SECRET": "cs_your_consumer_secret"
}
}
}
}

Passo 3: Verificar Ligação

Pergunte ao Claude:

> Quais são os 5 pedidos WooCommerce mais recentes?
> Liste as minhas listas de contactos Brevo

O Claude deve usar o WooCommerce MCP para o primeiro e o Brevo MCP para o segundo.

Caso de Uso 1: Agente de Sincronização de Clientes

Sincronize clientes WooCommerce para o Brevo com dados completos de compras:

---
name: woocommerce-customer-sync
description: Sync WooCommerce customers to Brevo contacts with order history
version: 1.0.0
temperature: 0.1
tools:
- woocommerce
- brevo_contacts
- brevo_attributes
- brevo_lists
triggers:
- schedule: "0 */6 * * *"
- event: customer_created
- event: order_completed
---
# Agente de Sincronização de Clientes WooCommerce
Sincronize dados de clientes do WooCommerce para contactos Brevo.
## Estratégia
1. Consultar o WooCommerce para clientes modificados desde a última sincronização
2. Para cada cliente, obter histórico de pedidos via endpoint de pedidos WooCommerce
3. Criar ou atualizar contacto Brevo com perfil + atributos de commerce calculados
4. Segmentar em listas Brevo:
- Novos clientes → lista "Welcome Series"
- Compradores recorrentes (2+ pedidos) → lista "Loyal Customers"
- Alto valor (total >$500) → lista "VIP"
- Inativos (sem pedido há 90+ dias) → lista "Win-Back"
## Mapeamento de Campos
| Campo WooCommerce | Atributo Brevo |
|------------------|-----------------|
| email | EMAIL |
| first_name | FIRSTNAME |
| last_name | LASTNAME |
| billing.phone | SMS |
| billing.company | COMPANY |
| billing.country | COUNTRY |
| billing.city | CITY |
| date_created | SIGNUP_DATE |
| orders_count (calculado) | ORDER_COUNT |
| total_spent (calculado) | TOTAL_SPENT |
| last_order_date (calculado) | LAST_ORDER |
| role | WOO_ROLE |
## Regras
- APENAS sincronizar clientes, não checkouts de visitantes (exceto se o e-mail corresponder a um contacto existente)
- NUNCA sobrescrever dados Brevo se o campo WooCommerce estiver vazio
- SEMPRE validar telefone para formato E.164 antes de sincronizar
- Gerir roles WordPress: apenas "customer" e "subscriber" (ignorar "administrator", "shop_manager")
- Rastrear eventos: woo_sync_success, woo_sync_error

Caso de Uso 2: Agente de Campanha de Pedidos

Acione campanhas personalizadas a partir de eventos do ciclo de vida de pedidos WooCommerce:

---
name: woocommerce-order-campaigns
description: Orchestrate Brevo campaigns based on WooCommerce order events
version: 1.0.0
temperature: 0.3
tools:
- woocommerce
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_sms_campaigns
triggers:
- event: order_processing
- event: order_completed
- event: order_refunded
---
# Agente de Campanha de Pedidos WooCommerce
Quando o estado de um pedido WooCommerce muda, acione sequências de envolvimento direcionadas no Brevo.
## Lógica da Sequência
### Pedido em Processamento (Novo Pedido)
1. Imediato: E-mail de confirmação de pedido (transacional)
2. +2 horas: SMS com resumo do pedido e envio estimado
3. Rastrear evento: woo_order_placed com valor do pedido
### Pedido Concluído (Enviado/Entregue)
#### Primeiras Compras
1. Dia 3: E-mail de boas-vindas com história da marca
2. Dia 7: Guia de cuidado do produto para a categoria comprada
3. Dia 14: Pedido de avaliação
4. Dia 30: Venda cruzada com base na categoria do produto
#### Compradores Recorrentes
1. Dia 3: Notificação de pontos de fidelidade ou recompensa
2. Dia 14: Lembrete de reabastecimento (se consumível)
3. Dia 21: Acesso antecipado a novos produtos
#### Pedidos de Alto Valor (>$150)
1. Dia 1: E-mail de agradecimento pessoal
2. Dia 3: SMS com dicas de cuidado
3. Dia 7: Oferta VIP ou convite para o programa de fidelidade
### Pedido Reembolsado
1. Imediato: E-mail de confirmação de reembolso
2. Dia 3: Inquérito de feedback
3. Dia 7: Oferta de reativação com 15% de desconto
## Regras
- SEMPRE verificar o estado atual do pedido WooCommerce antes de enviar
- NUNCA enviar marketing para pedidos com estado "cancelled" ou "failed"
- Personalizar com: nome do produto, número do pedido, primeiro nome do cliente
- Verificar notas de pedido WooCommerce para instruções especiais
- Usar variáveis de template Brevo para conteúdo dinâmico

Caso de Uso 3: Recuperação de Carrinho Abandonado

Recupere carrinhos abandonados WooCommerce via mensagens multicanal Brevo:

---
name: woocommerce-cart-recovery
description: Recover WooCommerce abandoned carts via Brevo email, SMS, and WhatsApp
version: 1.0.0
temperature: 0.2
tools:
- woocommerce
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_sms_campaigns
triggers:
- event: cart_abandoned
conditions:
- cart_value: "> 25"
- time_since_activity: "> 1h"
---
# Agente de Recuperação de Carrinho WooCommerce
Monitorize carrinhos abandonados WooCommerce e execute recuperação multicanal através do Brevo.
## Sequência de Recuperação
1. **+1 hora**: E-mail de lembrete com conteúdo do carrinho e imagens de produtos
2. **+24 horas**: Se sem abertura → SMS com link curto de recuperação do carrinho
3. **+48 horas**: Se sem recuperação → E-mail com código de cupão (gerado automaticamente via API de cupões WooCommerce)
4. **+72 horas**: Se carrinho >$100 e sem recuperação → WhatsApp com contacto pessoal
## Dados do Carrinho a Incluir
- Nomes e imagens de produtos (do WooCommerce)
- Total do carrinho com moeda
- URL direta de recuperação do carrinho
- Código de cupão WooCommerce (criado dinamicamente via API para o passo 3)
## Geração de Cupão
Para o passo 3, criar um cupão WooCommerce via API:
- Tipo: percent_discount (10%)
- Limite de utilização: 1
- Validade: 7 dias
- Uso individual: true
- Incluir código de cupão no template de e-mail Brevo
## Regras
- NUNCA enviar para clientes que completaram o checkout desde que o carrinho foi abandonado
- SEMPRE verificar se o carrinho ainda existe antes de cada passo
- Máximo de 4 pontos de contacto por carrinho abandonado
- Respeitar preferências de cancelamento por canal
- Carrinhos de visitantes WooCommerce: apenas recuperar se o e-mail foi capturado no início do checkout

Caso de Uso 4: Acompanhamento de Avaliação de Produto

Use os dados de produtos WooCommerce para campanhas direcionadas de avaliação:

---
name: woocommerce-review-agent
description: Request product reviews via Brevo based on WooCommerce delivery timeline
version: 1.0.0
temperature: 0.2
tools:
- woocommerce
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
triggers:
- schedule: "0 9 * * *"
---
# Agente de Avaliação de Produto
Identifique pedidos WooCommerce entregues há 14+ dias sem avaliação, e envie um pedido de avaliação personalizado via Brevo.
## Estratégia
1. Consultar o WooCommerce para pedidos concluídos há 14-21 dias
2. Verificar se o cliente deixou uma avaliação de produto (via API de avaliações WooCommerce)
3. Se sem avaliação, enviar e-mail personalizado com:
- Nome e imagem do produto
- Link direto para avaliação
- Pequeno incentivo (ex.: 5% de desconto na próxima encomenda)
4. Rastrear evento: review_request_sent
## Regras
- Máximo de um pedido de avaliação por pedido
- NUNCA solicitar avaliações para pedidos reembolsados/cancelados
- Apenas enviar durante o horário comercial (9h fuso horário do cliente)
- Ignorar se o cliente cancelou a subscrição de marketing

Exemplo: Orquestração em Linguagem Natural

Com ambos os servidores MCP ligados:

Utilizador: "Encontre clientes WooCommerce que gastaram mais de $200 no total mas
não encomendaram há 60+ dias. Adicione-os à minha lista de reativação
Brevo e envie um e-mail de reengajamento com 15% de desconto."
Claude: A consultar o WooCommerce para clientes inativos de alto valor...
[Usa woocommerce MCP para obter clientes e histórico de pedidos]
[Filtra: total_spent > $200 E último pedido > 60 dias atrás]
Encontrei 41 clientes inativos de alto valor.
A verificar contactos Brevo...
[Usa brevo_contacts para corresponder e-mails]
A processar 41 clientes...
[Atualiza contactos com atributos TOTAL_SPENT e LAST_ORDER]
[Adiciona 41 à lista "Win-Back"]
[Cria cupão WooCommerce: WINBACK15 (15% de desconto, uso único)]
[Aciona template de e-mail de reativação com código de cupão]
Concluído:
- 41 clientes adicionados à lista "Win-Back" no Brevo
- E-mails de reativação enviados com código de desconto de 15% personalizado
- Cupão WINBACK15 criado no WooCommerce (uso único, validade de 14 dias)
- Evento Brevo rastreado: winback_campaign_sent

Próximos Passos

Assistente AI

Olá! Pergunte-me qualquer coisa sobre a documentação.

Comece grátis com Brevo