OpenClaw + WooCommerce Entegrasyon Kılavuzu

WooCommerce, dünya çapındaki tüm çevrimiçi mağazaların %39'una, diğer tüm e-Ticaret platformlarından daha fazla güç sağlıyor. Esnekliği ve derin WordPress entegrasyonu, onu, yığınları üzerinde kontrol sahibi olmak isteyen işletmelerin tercih ettiği platform haline getiriyor. Ancak bu esneklik operasyonel karmaşıklığı da beraberinde getiriyor. WooCommerce, Shopify'ın görüşlü iş akışlarına veya yerel otomasyon ekosistemine sahip değildir. Sonuç olarak, WooCommerce mağazaları genellikle her operasyonel sorun için eklentiler biriktirir (bir abonelik eklentisi, bir sadakat eklentisi, bir envanter eklentisi, bir destek eklentisi), her biri kendi yönetici arayüzüne sahiptir ve hiçbiri verileri akıllıca paylaşmaz.

OpenClaw, WooCommerce için eklentilerin yama yapısını tutarlı, muhakeme yeteneğine sahip bir otomasyon sistemiyle değiştiren birleşik bir AI operasyon katmanı sağlar. REST API, WordPress web kancaları ve gerektiğinde doğrudan veritabanı erişimi aracılığıyla WooCommerce'e bağlanır ve tek bir aracı çerçevesinden tüm operasyonel alanlarda koordinasyon sağlar.

Önemli Çıkarımlar

OpenClaw, uygulama şifrelerini kullanarak REST API aracılığıyla WooCommerce'e bağlanır; WordPress tarafında eklenti kurulumu gerekmez.

Webhook kaydı, otomatik gizli rotasyon ve imza doğrulama ile WooCommerce API aracılığıyla programlı bir şekilde gerçekleştirilir.

Sipariş Otomasyon Aracısı durum geçişlerini, sipariş karşılama yönlendirmesini ve müşteri iletişimini uçtan uca yönetir.

Envanter Aracısı, WooCommerce konumlarındaki ve harici depolardaki stokları izleyerek stok tükenmeden önce yenilemeyi tetikler.

Abonelik yönetimi otomasyonu, başarısız ödeme kurtarma, kesinti tahmini ve yükseltme/düşürme iş akışlarını yönetir.

SEO Aracısı ürün sıralamalarını izler, optimizasyon fırsatlarını belirler ve optimize edilmiş ürün açıklamaları oluşturur.

Doğrudan veritabanı erişimi (salt okunur, okuma kopyası yoluyla), REST API tarafından verimli bir şekilde sunulamayan analizler ve raporlama için kullanılır.

ECOSIRE'ın OpenClaw WooCommerce entegrasyon hizmeti, dört ila altı hafta içinde üretime hazır otomasyon sağlar.

Kimlik Doğrulama ve Bağlantı Kurulumu

WooCommerce'in REST API'si, kimlik doğrulama için OAuth 1.0 veya uygulama şifrelerini kullanır. Uygulama şifrelerinin (WordPress 5.6'dan beri mevcuttur) sunucudan sunucuya entegrasyonlar için yönetilmesi daha kolaydır.

export const WooCommerceTool = defineTool({
  name: "woocommerce",
  type: "rest",
  baseUrl: `${process.env.WORDPRESS_URL}/wp-json/wc/v3`,
  auth: {
    type: "basic",
    username: "${WC_CONSUMER_KEY}", // Vault reference
    password: "${WC_CONSUMER_SECRET}", // Vault reference
  },
  rateLimiting: {
    type: "fixed-window",
    requestsPerSecond: 25, // WooCommerce default server capacity
    burstSize: 50,
  },
  sslVerification: true, // Always verify SSL on production
});

Web Kancası Kaydı: OpenClaw, ihtiyaç duyduğu web kancalarını ilk başlatmada kaydeder ve bunları her yeniden başlatmada doğrular:

export const RegisterWebhooks = defineSkill({
  name: "register-webhooks",
  tools: ["woocommerce"],
  async run({ input, tools }) {
    const requiredWebhooks = [
      { topic: "order.created", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/order-created` },
      { topic: "order.updated", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/order-updated` },
      { topic: "product.updated", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/product-updated` },
      { topic: "customer.created", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/customer-created` },
    ];

    const existingWebhooks = await tools.woocommerce.get("/webhooks?per_page=100");

    for (const required of requiredWebhooks) {
      const exists = existingWebhooks.find((w) => w.topic === required.topic && w.delivery_url === required.deliveryUrl);
      if (!exists) {
        await tools.woocommerce.post("/webhooks", {
          name: `OpenClaw - ${required.topic}`,
          topic: required.topic,
          delivery_url: required.deliveryUrl,
          secret: process.env.WC_WEBHOOK_SECRET,
          status: "active",
        });
      }
    }

    return { registered: requiredWebhooks.length };
  },
});

Sipariş Otomasyonu: Durum Yönetimi ve İletişim

WooCommerce sipariş durumları şunlardır: ödeme bekleniyor, işleniyor, beklemede, tamamlandı, iptal edildi, para iadesi yapıldı ve başarısız oldu. Sipariş Otomasyon Aracısı, her adımda uygulanan iş mantığıyla durum geçişlerini yönetir.

Beklemede → İşleniyor: Ödeme, ödeme ağ geçidi web kancası tarafından onaylandığında, aracı siparişi İşleme aşamasına taşır, envanter kullanılabilirliğini kontrol eder ve gönderimi başlatır.

İşleniyor → Tamamlandı: Depo sevkiyatın ve takibin mevcut olduğunu onayladığında temsilci sipariş durumunu günceller, takip bilgilerini özel bir alan olarak ekler ve müşteriye bir sevkiyat bildirimi gönderir.

Başarısız Ödeme Kurtarma: Bir ödeme başarısız olduğunda temsilci siparişi hemen iptal etmez. Bunun yerine, bir ödeme kurtarma e-posta dizisi gönderir (başarısızlıktan 1 saat, 24 saat ve 72 saat sonra), geçici bir ödeme bağlantısı oluşturur ve yalnızca dizi tamamlandıktan sonra başarılı bir ödeme alınmazsa iptal eder.

export const HandleOrderStatusChange = defineSkill({
  name: "handle-order-status-change",
  tools: ["woocommerce", "email", "warehouse"],
  async run({ input, tools }) {
    const { orderId, newStatus, previousStatus } = input;
    const order = await tools.woocommerce.get(`/orders/${orderId}`);

    if (previousStatus === "pending" && newStatus === "processing") {
      // Payment received — initiate fulfillment
      const fulfillmentResult = await initiateFulfillment(tools, order);
      if (!fulfillmentResult.success) {
        // Put on hold if fulfillment cannot proceed
        await tools.woocommerce.put(`/orders/${orderId}`, {
          status: "on-hold",
          customer_note: "We are reviewing your order and will update you shortly.",
        });
        return { handled: true, action: "ON_HOLD_FULFILLMENT_ISSUE" };
      }
    }

    if (newStatus === "failed") {
      // Schedule payment recovery sequence
      await schedulePaymentRecovery(tools, order);
      return { handled: true, action: "PAYMENT_RECOVERY_SCHEDULED" };
    }

    return { handled: true, action: "STATUS_UPDATED" };
  },
});

Envanter Yönetimi: Gerçek Stok Görünürlüğü

WooCommerce'in yerel envanter yönetimi basittir; basit stokta kalmama davranışıyla ürün başına ve varyasyon başına stok sayımları. Birden fazla depoya, tedarikçiye veya karmaşık stok rotasına sahip mağazalar için Envanter Aracısı bunu önemli ölçüde genişletir.

Çok Konumlu Stok: WooCommerce, birden fazla stok konumunu yerel olarak desteklemez. Envanter Aracısı, uzun süreli hafızasında konum başına stok seviyelerini izleyen bir konum haritası tutar. WooCommerce genel miktarı gösterdiğinde temsilci, konum bazında dökümü bilir.

Yeniden Sipariş Noktası İzleme: Temsilci, yapılandırılmış yeniden sipariş noktalarını saatlik olarak kontrol eder. Bir ürünün miktarı yeniden sipariş noktasının altına düştüğünde, ürünün kaynak yapılandırmasına bağlı olarak uygun yenileme eylemi tetiklenir:

Tedarikçi kaynaklı ürünler: ERP'de bir satın alma siparişi oluşturur (Odoo, QuickBooks veya tedarikçiye gönderilen bir satın alma siparişi e-postası).
Üretilen ürünler: Bir üretim planlama bildirimini tetikler.
Dropshipped ürünler: Tedarikçi API'si (varsa) aracılığıyla tedarikçinin stok durumunu doğrular ve ürünün stok durumunu buna göre günceller.

export const CheckReorderPoints = defineSkill({
  name: "check-reorder-points",
  tools: ["woocommerce"],
  async run({ input, tools }) {
    const products = await tools.woocommerce.get("/products?manage_stock=true&per_page=100&stock_status=instock");
    const replenishmentNeeded = [];

    for (const product of products) {
      const reorderPoint = product.meta_data.find(m => m.key === "_openclaw_reorder_point")?.value ?? 5;
      const reorderQty = product.meta_data.find(m => m.key === "_openclaw_reorder_qty")?.value ?? 50;

      if (product.stock_quantity <= parseInt(reorderPoint)) {
        replenishmentNeeded.push({
          productId: product.id,
          productSku: product.sku,
          currentStock: product.stock_quantity,
          reorderPoint: parseInt(reorderPoint),
          orderQty: parseInt(reorderQty),
          sourcingType: product.meta_data.find(m => m.key === "_openclaw_sourcing")?.value ?? "supplier",
        });
      }
    }

    return { replenishmentNeeded, checkedCount: products.length };
  },
});

Abonelik Yönetimi Otomasyonu

Aracı, WooCommerce Aboneliklerini kullanan WooCommerce mağazaları için eklentinin temel özelliklerinin üstüne akıllı abonelik yönetimi ekler.

Başarısız Ödeme Kurtarma: Yerel WooCommerce Abonelikleri yeniden deneme mantığı zamana dayalıdır. OpenClaw aracısı davranışsal zeka ekler: Daha önce başarısız bir ödemeyi kurtarmış olan müşteriler için ilk yeniden deneme 2 saat içinde gerçekleşir. Tutarlı bir zamanında ödeme geçmişine sahip müşteriler için temsilci, yeniden denemeyi denemeden önce kibar bir ödeme güncelleme isteği göndererek süresi dolmuş kartları proaktif bir şekilde yakalar.

Kesinti Tahmini: Aracı, bir abone kaybı riski puanı oluşturmak için abonelik kullanım sinyallerini (kullanım verilerinin mevcut olduğu SaaS ürünleri için), oturum açma sıklığını ve destek bildirim duyarlılığını izler. Yüksek riskli abonelikler CS ekibinin proaktif elde tutma desteğini tetikler.

Yükseltme ve Düşürme Akışları: Bir abonenin davranışı, daha yüksek bir katmandan (plan sınırlarına yakın tutarlı kullanım) veya daha düşük bir katmandan (planını sürekli olarak yetersiz kullanma) yararlanacağını gösterdiğinde, aracı, abonenin aboneyi kaybetmesini beklemek yerine otomatik bir öneri dizisini tetikler.

export const MonitorSubscriptionHealth = defineSkill({
  name: "monitor-subscription-health",
  tools: ["woocommerce", "analytics"],
  async run({ input, tools }) {
    const subscriptions = await tools.woocommerce.get(
      "/subscriptions?status=active&per_page=100"
    );

    const atRisk = [];
    for (const sub of subscriptions) {
      const signals = await collectChurnSignals(tools, sub);
      const churnScore = computeChurnScore(signals);

      if (churnScore > 0.65) {
        atRisk.push({ subscriptionId: sub.id, customerId: sub.customer_id, churnScore, signals });
      }
    }

    return { atRisk, total: subscriptions.length };
  },
});

SEO ve Ürün İçeriği Optimizasyonu

WooCommerce mağazaları organik aramayla yaşar ve ölür. SEO Aracısı, ürün sıralamalarını izler, içerik boşluklarını belirler ve dönüşümden ödün vermeden keşfedilebilirliği artıran optimize edilmiş ürün açıklamaları oluşturur.

Sıralama İzleme: Temsilci, ürün sayfalarının sıralama verilerini almak için haftalık olarak Google Search Console API'sini sorgular. Sıralamada önemli ölçüde düşen ürünler içerik denetimini tetikler.

Açıklama Optimizasyonu: Açıklamaları zayıf (200 kelimeden az) olan veya hedef anahtar kelimeler için kötü sıralamaya sahip ürünler için temsilci, ürünün özelliklerini, müşteri yorumlarını ve rakip analizini kullanarak iyileştirilmiş açıklamalar oluşturur. Oluşturulan açıklamalar bir inceleme kuyruğuna yerleştirilir; yayınlanmadan önce bir kişi onaylar.

Şema İşaretleme Denetimi: Temsilci, ürün sayfalarının geçerli Ürün şeması işaretlemesine (fiyat, stok durumu ve inceleme toplamaları dahil) sahip olup olmadığını kontrol eder. Eksik veya hatalı biçimlendirilmiş şema, geliştiricinin düzeltmesi için işaretlendi.

Müşteri Segmentasyonu ve Pazarlama Otomasyonu

Pazarlama Temsilcisi, müşterileri satın alma davranışına göre segmentlere ayırır ve e-posta servis sağlayıcınız (Mailchimp, Klaviyo, ActiveCampaign) aracılığıyla hedeflenen kampanyaları düzenler.

Müşteri segmentleri otomatik olarak korunur:

Yeni müşteriler (30 gün içindeki ilk satın alma): İlk katılım süreci, ürün eğitimi, ikinci satın alma teşviki.
Aktif müşteriler (90 gün içinde satın alınanlar, 2'den fazla sipariş): Bağlılık ödülü bildirimleri, yeni ürün duyuruları, çapraz satış dizileri.
Risk altındaki müşteriler (son satın alma tarihinden itibaren 90-180 gün): Gittikçe daha güçlü teklifler sunan geri kazanma kampanyaları.
Geçmiş müşteriler (180+ gün): Nihai geri kazanma girişimi ve ardından aktif pazarlama listelerinin sona ermesi.
Yüksek değere sahip müşteriler (yaşam boyu değere göre ilk %10): VIP muamelesi, yeni ürünlere erken erişim, B2B hesapları için kişisel CSM desteği.

Segment atamaları, satın alma etkinlikleri geldikçe günlük olarak güncellenir.

Analiz ve Raporlama

Analitik Aracısı, gecelik raporlar çalıştırır ve bir yönetim kontrol panelini aşağıdakilerle doldurur:

Geçen yılın aynı dönemine göre günlük, haftalık ve aylık gelir
Ürün kategorisine göre brüt kar marjı (ürün meta alanlarından veya ERP'den maliyet verileri gerekir)
Siparişlerdeki UTM verilerinden müşteri edinme maliyeti
Trafik kaynağına göre dönüşüm oranı
Ortalama sipariş değeri eğilimi
Geri ödeme oranı ve nedenleri
Abonelik MRR'si ve kayıp oranı

Büyük sipariş hacimlerine sahip WooCommerce mağazaları için Analitik Aracısı, sorguları raporlamak için REST API yerine WordPress veritabanının okuma kopyasını kullanır ve üretim veritabanındaki yükü önler.

Sıkça Sorulan Sorular

OpenClaw herhangi bir WordPress eklentisinin yüklenmesini gerektiriyor mu?

Hiçbir eklentiye gerek yoktur. OpenClaw, tamamen WooCommerce'in yerleşik REST API'si ve WordPress webhook sistemi aracılığıyla bütünleşir. Tek gereksinim, WooCommerce REST API'nin etkinleştirilmiş olması (varsayılan olarak budur) ve aracı için bir uygulama parolasının veya API tüketici anahtarının oluşturulmuş olmasıdır. Bu, eklenti uyumluluk sorunlarının, eklenti güncelleme çakışmalarının veya ek lisans maliyetlerinin olmadığı anlamına gelir.

Temsilci, sınırlı kaynaklara sahip paylaşılan barındırmada WooCommerce mağazalarını nasıl yönetiyor?

Paylaşılan barındırma ortamları, özel sunuculara göre daha katı hız sınırlarına ve kaynak kısıtlamalarına sahiptir. OpenClaw'ın WooCommerce araç adaptörü muhafazakar hız limitleriyle (saniyede 25 yerine 5-10 istek) yapılandırılabilir ve barındırma kısıtlamaları dahilinde kalmak için toplu işlem isteğinde bulunabilir. API performansının endişe verici olduğu mağazalar için ECOSIRE, OpenClaw'ın yoğun toplu işlemler (envanter kontrolleri, analiz sorguları) için yoğun olmayan saatleri kullanacak şekilde yapılandırılmasını ve sipariş işleme için gerçek zamanlı API kapasitesinin ayrılmasını önerir.

Envanter aracısı harici depo yönetim sistemleriyle senkronize edilebilir mi?

Evet. Envanter Aracısı, API sağlayan herhangi bir WMS ile (ShipBob, ShipStation, Linnworks, Brightpearl ve diğerleri) entegre olabilir. WMS'de bir sipariş karşılandığında aracı, yerine getirme olayını alır, WooCommerce sipariş durumunu ve takibini günceller ve envanter sayımlarını mutabakata varır. API'leri olmayan 3PL iş ortakları için temsilci, e-posta veya CSV envanter raporlarını otomatik olarak işleyebilir.

Abonelik kaybı tahmin modeli, geçmiş verileri olmayan yeni mağazalar için nasıl çalışır?

Kayıp modeli, iş kategoriniz (SaaS, abonelik kutusu, sarf malzemeleri vb.) için sektör ortalamalı temellerle başlar ve 60+ günlük abonelik verileri biriktikçe mağazaya özel modellere geçiş yapar. Temel dönem boyunca ECOSIRE, ürün türünüze ve abonelik yapınıza göre bir iptal sinyali yapılandırması sağlar. Sonuçlar gözlemlendikçe ve eğitim setine geri beslendikçe model otomatik olarak iyileşir.

WordPress/WooCommerce performansı üzerindeki etkisi nedir?

OpenClaw tamamen WordPress'in dışında çalışır. OpenClaw'dan WooCommerce'e yapılan API çağrıları, herhangi bir API istemcisiyle aynı işleme tabi olan standart HTTP istekleridir. Araç bağdaştırıcısındaki hız sınırlayıcı, aracının WordPress veritabanını aşırı doldurmasını önler. Yüksek trafikli mağazalar için (ayda 10.000'den fazla sipariş), ECOSIRE bir WordPress okuma kopyası oluşturmanızı ve OpenClaw'ın analiz sorgularını buraya yönlendirmenizi önerir. Gerçek zamanlı sipariş işleme sorguları birincil veritabanında çalıştırılır ancak yoğun şekilde önbelleğe alınır.

Sonraki Adımlar

WooCommerce'in esnekliği onun en büyük gücü ve operasyonel zorluğudur. OpenClaw, WooCommerce mağazalarına Shopify Plus satıcılarının yerel olarak edindiği operasyon zekasını, WooCommerce'in sağladığı kontrol ve özelleştirmeden vazgeçmeden verir.

ECOSIRE'ın OpenClaw WooCommerce entegrasyon hizmeti, mağazanızın spesifik ürün karışımına, operasyonel iş akışlarına ve teknoloji yığınına göre uyarlanmış eksiksiz bir otomasyon yığını sunar. Ekibimiz, OpenClaw'ı butik özel perakendecilerden yüksek hacimli B2B distribütörlerine kadar uzanan WooCommerce mağazalarıyla entegre etti.

Bir WooCommerce otomasyon keşif oturumu planlamak için ECOSIRE ile iletişime geçin.

OpenClaw + WooCommerce Integration Guide