TotalApp Dökümanlar
Ctrl K
Anasayfa
EN | TR
Uygulamaya Git

WooCommerce Entegrasyonu

WooCommerce mağazanızı TotalApp'e bağlayın ve webhook tabanlı gerçek zamanlı sipariş takibi yapın.

Genel Bakış

TotalApp'in WooCommerce entegrasyonu, WordPress/WooCommerce mağazanızı REST API ve Webhook sistemi üzerinden bağlar. Siparişler, ürünler ve müşteri verileri TotalApp'te görüntülenir; yeni siparişler webhook aracılığıyla anlık olarak iletilir.

🛒 Sipariş Akışı

Yeni siparişler webhook üzerinden anlık bildirim olarak iletilir. Hiçbir sipariş atlanmaz.

📊 Ürün Kataloğu

Tüm WooCommerce ürünlerinizi, varyantları ve stok durumunu görüntüleyin.

🤖 Yapay Zeka Asistanı

Mağaza verileriniz hakkında doğal dil sorguları yapın ve anlık içgörüler alın.

📋 Olay Günlüğü

Tüm webhook olaylarını zaman damgası, konu ve durum bilgisiyle kayıt altında tutun.

Mimari: SSE Köprüsü

WooCommerce entegrasyonu, gerçek zamanlı veri iletimi için bir SSE (Server-Sent Events) köprüsü kullanır:

WooCommerce Webhook → TotalApp Sunucu → SSE Yayını → Tarayıcı

Bu mimari sayesinde iş akışı yürütücüsü (workflow executor) tarayıcıda çalışırken bile harici WooCommerce olaylarına anlık tepki verebilir.

Bağlantı Kurma

WooCommerce mağazanızı bağlamak için REST API anahtarları oluşturmanız ve webhook endpoint'i yapılandırmanız gerekir.

Adım 1: REST API Anahtarları Oluşturma

  1. WordPress yönetici panelinize giriş yapın
  2. WooCommerce → Ayarlar → Gelişmiş → REST API'ye gidin
  3. Anahtar Ekle düğmesine tıklayın
  4. Açıklama girin (örn. "TotalApp Entegrasyonu")
  5. Kullanıcı olarak yönetici hesabınızı seçin
  6. İzinler: Okuma seçin
  7. API Anahtarı Oluştur'a tıklayın
  8. Oluşturulan Tüketici Anahtarı (Consumer Key) ve Tüketici Sırrı'nı (Consumer Secret) kopyalayın

⚠️ Anahtarları Hemen Kaydedin

Tüketici Sırrı yalnızca bir kez gösterilir. Sayfayı kapatmadan önce kopyaladığınızdan emin olun.

Adım 2: TotalApp'e Kimlik Bilgilerini Girme

TotalApp'te E-ticaret → WooCommerce Entegrasyonu ekranına gidin ve şu bilgileri doldurun:

AlanDeğer
Mağaza URLhttps://siteniz.com (tam URL, sonunda / olmadan)
Tüketici Anahtarıck_xxxxxxxxxxxx ile başlayan anahtar
Tüketici Sırrıcs_xxxxxxxxxxxx ile başlayan sır

Bağlantıyı Test Et düğmesine tıklayın. Başarılı bağlantıda ürün ve sipariş sayılarını görürsünüz.

Adım 3: Webhook Yapılandırması (İsteğe Bağlı)

Anlık sipariş bildirimleri almak için WooCommerce'te webhook oluşturun:

  1. WooCommerce → Ayarlar → Gelişmiş → Webhook'lar'a gidin
  2. Webhook Ekle'ye tıklayın
  3. Ad: "TotalApp Sipariş Bildirimi"
  4. Durum: Etkin
  5. Konu: Sipariş oluşturuldu
  6. Dağıtım URL: https://app.totalapp.app/api/webhooks/woocommerce
  7. API sürümü: WP REST API Integration v3
  8. Kaydet ve Gizli anahtarı kopyalayın

💡 Ngrok ile Yerel Geliştirme

Yerel geliştirme ortamında test yapmak için ngrok kullanarak genel bir URL oluşturun: ngrok http 3000. WooCommerce webhook URL'sini ngrok URL'nize yönlendirin.

Mağaza Verilerini Görüntüleme

Bağlantı kurulduktan sonra WooCommerce entegrasyonu ekranı şu sekmeleri sunar:

Ürünler Sekmesi

  • Ürün adı, SKU ve fiyat
  • Stok durumu ve miktarı
  • Ürün kategorileri
  • Yayın durumu (Yayında / Taslak / Gizli)

Siparişler Sekmesi

  • Sipariş numarası ve tarihi
  • Müşteri adı ve iletişim bilgileri
  • Sipariş tutarı ve para birimi
  • Sipariş ve ödeme durumu

Olay Günlüğü Sekmesi

Webhook üzerinden iletilen tüm olayların kayıtlarını gösterir:

  • Zaman damgası
  • Olay konusu (order.created, product.updated vb.)
  • HTTP durum kodu
  • İşlem süresi (ms)
  • Yük özeti (ilk 300 karakter)

📡 Gerçek Zamanlı Günlük

Olay günlüğü SSE bağlantısı üzerinden anlık güncellenir. Yeni bir sipariş geldiğinde sayfayı yenilemeden günlükte görürsünüz.

Yapay Zeka Asistanı

WooCommerce entegrasyonu ekranındaki Yapay Zeka Asistanı, mağaza verilerinizi bağlam olarak kullanarak doğal dil sorularını yanıtlar.

Örnek Sorgular

  • "Bu haftaki siparişleri özetle"
  • "Stok miktarı 5'in altına düşen ürünler hangileri?"
  • "En popüler ürün kategorim hangisi?"
  • "Bekleyen ödemeler var mı?"
  • "Son 10 siparişin müşteri listesini ver"

İş Akışı Entegrasyonu

WooCommerce webhook olayları, TotalApp İş Akışı Editörü'ndeki tetikleyici düğümlerle birleştirilebilir. Yeni bir sipariş geldiğinde otomatik iş akışları başlatabilirsiniz:

  • Sipariş bildirimi e-postası gönder
  • Stok azaldığında uyarı oluştur
  • Müşteri verilerini CRM'e aktar
  • Raporlama verilerini güncelle

İş akışı tetikleyicileri hakkında daha fazla bilgi için İş Akışı Editörü belgelerine bakın.

Sık Sorulan Sorular

WooCommerce sürümü gereksinimi nedir?
WooCommerce 3.5 ve üzeri desteklenir. REST API v3 ile uyumlu olması gerekmektedir. WordPress 5.0+ önerilir.
SSL sertifikası gerekli mi?
Evet. WooCommerce REST API'si ve webhook bildirimleri için sitenizde HTTPS/SSL etkin olmalıdır. Geçersiz veya süresi dolmuş SSL sertifikaları bağlantı hatalarına neden olur.
Veriler TotalApp'te saklanıyor mu?
Webhook olay günlükleri (son 200 kayıt) kiracı kapsamlı bir JSON dosyasında saklanır. Ürün ve sipariş verileri ise yalnızca sorgulama anında işlenir; kalıcı olarak depolanmaz.
Bağlantı başarısız olursa ne yapmalıyım?
Mağaza URL'sinin https:// ile başladığını ve sonunda / olmadığını kontrol edin. Tüketici Anahtarı'nın ck_ ile başladığından ve Tüketici Sırrı'nın cs_ ile başladığından emin olun. WooCommerce'te REST API'nin etkin olduğunu doğrulayın.

Sonraki Adımlar