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
| Servidor | Pacote/URL | Autenticação | Propósito |
|---|---|---|---|
| WooCommerce MCP | woocommerce-mcp-server | Consumer Key/Secret | Clientes, pedidos, produtos, cupões, relatórios |
| Brevo MCP | mcp.brevo.com/v1/brevo/mcp | Token | Contactos, 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
- No Painel WordPress, aceda a WooCommerce > Definições > Avançado > REST API
- Clique em Adicionar Chave, defina permissões como Leitura e gere
- 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 BrevoO 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-syncdescription: Sync WooCommerce customers to Brevo contacts with order historyversion: 1.0.0temperature: 0.1tools: - woocommerce - brevo_contacts - brevo_attributes - brevo_liststriggers: - 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ção2. Para cada cliente, obter histórico de pedidos via endpoint de pedidos WooCommerce3. Criar ou atualizar contacto Brevo com perfil + atributos de commerce calculados4. 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_errorCaso 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-campaignsdescription: Orchestrate Brevo campaigns based on WooCommerce order eventsversion: 1.0.0temperature: 0.3tools: - woocommerce - brevo_contacts - brevo_email_campaign_management - brevo_templates - brevo_sms_campaignstriggers: - 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 estimado3. Rastrear evento: woo_order_placed com valor do pedido
### Pedido Concluído (Enviado/Entregue)#### Primeiras Compras1. Dia 3: E-mail de boas-vindas com história da marca2. Dia 7: Guia de cuidado do produto para a categoria comprada3. Dia 14: Pedido de avaliação4. Dia 30: Venda cruzada com base na categoria do produto
#### Compradores Recorrentes1. Dia 3: Notificação de pontos de fidelidade ou recompensa2. 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 pessoal2. Dia 3: SMS com dicas de cuidado3. Dia 7: Oferta VIP ou convite para o programa de fidelidade
### Pedido Reembolsado1. Imediato: E-mail de confirmação de reembolso2. Dia 3: Inquérito de feedback3. 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âmicoCaso de Uso 3: Recuperação de Carrinho Abandonado
Recupere carrinhos abandonados WooCommerce via mensagens multicanal Brevo:
---name: woocommerce-cart-recoverydescription: Recover WooCommerce abandoned carts via Brevo email, SMS, and WhatsAppversion: 1.0.0temperature: 0.2tools: - woocommerce - brevo_contacts - brevo_email_campaign_management - brevo_templates - brevo_sms_campaignstriggers: - 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 produtos2. **+24 horas**: Se sem abertura → SMS com link curto de recuperação do carrinho3. **+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ãoPara 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 checkoutCaso de Uso 4: Acompanhamento de Avaliação de Produto
Use os dados de produtos WooCommerce para campanhas direcionadas de avaliação:
---name: woocommerce-review-agentdescription: Request product reviews via Brevo based on WooCommerce delivery timelineversion: 1.0.0temperature: 0.2tools: - woocommerce - brevo_contacts - brevo_email_campaign_management - brevo_templatestriggers: - 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 dias2. 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 marketingExemplo: 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_sentPróximos Passos
- Servidor MCP Brevo, Lista completa de módulos MCP Brevo
- Especificação de Agente, Personalizar comportamento do agente
- Shopify + Brevo, Integração Shopify
- BigCommerce + Brevo, Integração BigCommerce
- API Personalizada + Brevo, Construir conectores para qualquer REST API