WooCommerce

Bu rehberde: WordPress üzerindeki WooCommerce mağazanızı bir REST API anahtarıyla bağlarsınız. Yeni sipariş, tamamlanan sipariş ve yeni müşteri olayları iş akışı başlatır; akış içinden sipariş okuyabilir ve siparişe (isterseniz müşteriye de görünen) not ekleyebilirsiniz.

⏱ 10 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyiciler:

Akış şu alanlarla başlar: orderId, orderNumber, status (pending, processing, on-hold, completed …), total, currency, customerId (misafir siparişte yok), customerName, customerEmail, customerPhone (fatura bilgilerinden), items (name, quantity, price), productName, paymentMethod, customerNote, paidAt, completedAt, createdAt ve kısaltılmış raw. Müşteri olayında customerId, customerName, customerEmail, customerPhone, firstName, lastName, username gelir.

WooCommerce kutusunun işlemleri:

Editördeki test çalıştırmalarında not ekleme çalıştırılmaz; okuma işlemleri çalışır.

Ön koşullar#

• WooCommerce 3.5 veya üstü yüklü bir WordPress sitesi, HTTPS üzerinden yayında. Anahtarlar Basic auth ile gönderildiği için düz HTTP siteler kabul edilmez.
• WordPress kalıcı bağlantıları (Ayarlar → Kalıcı bağlantılar) "Düz" (Plain) dışında bir seçenekte olmalı; aksi hâlde /wp-json/ adresi çalışmaz.
• Yönetici (Administrator) veya Mağaza yöneticisi (Shop manager) rolünde bir kullanıcı.
• Güvenlik eklentisi, Cloudflare ya da barındırma güvenlik duvarı /wp-json/wc/v3/ isteklerini ve OrqLabs'tan gelen webhook doğrulama isteğini engellememeli.

Adım adım kurulum#

A) WooCommerce'te API anahtarı#

1. WordPress yönetiminde WooCommerce → Ayarlar → Gelişmiş → REST API → Anahtar ekle.
2. Açıklama: OrqLabs, Kullanıcı: yönetici hesabınız, İzinler: Okuma/Yazma (Read/Write). Webhook oluşturmak ve not eklemek için yazma izni gerekir.
3. API anahtarı oluştur → Consumer key (ck_…) ve Consumer secret (cs_…) değerlerini kopyalayın; gizli anahtar yalnızca bir kez gösterilir.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → WooCommerce → Bağla → Proje seçin.
2. Store URL: mağazanın ana adresi, ör. https://magaza.ornek.com (WordPress bir alt klasördeyse https://ornek.com/magaza).
3. Consumer key ve Consumer secret → Bağla.

Bağlantı kurulunca OrqLabs üç webhook'u (order.created, order.updated, customer.created) mağazanızda kendi gizli anahtarıyla otomatik oluşturur. WooCommerce oluşturma anında adrese bir doğrulama isteği (webhook_id=…) gönderir; OrqLabs bu isteği yanıtlar ve webhook Etkin kalır. Webhook'ları WooCommerce → Ayarlar → Gelişmiş → Webhook'lar sayfasında OrqLabs – … adıyla görebilirsiniz; bunları silmeyin.

Örnek iş akışları#

1) Yeni siparişe WhatsApp bildirimi#

Entegrasyon olayı (WOOCOMMERCE · Order created) → Eğer ({{ $json.status }} eşittir processing) → Mesaj gönder (WhatsApp, onaylı şablon, alıcı {{ $json.customerPhone }}, parametreler {{ $json.customerName }}, {{ $json.orderNumber }}).

2) Tamamlanan siparişten sonra yorum isteği#

1. Entegrasyon olayı – WOOCOMMERCE · Order completed.
2. Bekle – 3 gün.
3. Metin üret – {{ $json.customerName }} için {{ $json.productName }} ürününü değerlendirmesini rica eden kısa bir e-posta yaz.
4. E-posta gönder – alıcı {{ $node["Entegrasyon olayı"].json.customerEmail }}.
5. WooCommerce → Add order note – Order id {{ $node["Entegrasyon olayı"].json.orderId }}, Note Yorum isteği gönderildi, Send to the customer kapalı.

3) Yeni müşteriyi aday listesine alma#

Entegrasyon olayı (WOOCOMMERCE · Customer created) → Aday oluştur (ad {{ $json.customerName }}, e-posta {{ $json.customerEmail }}, telefon {{ $json.customerPhone }}) → Ekibe bildir.

Tetikleyiciler nasıl çalışır?#

• WooCommerce her teslimatı webhook'un gizli anahtarıyla imzalar (X-WC-Webhook-Signature, base64 HMAC-SHA256). OrqLabs imzayı ham gövde üzerinden doğrular; imzasız veya hatalı teslimatları reddeder.
• order.updated her sipariş kaydında gönderilir. Order completed yalnızca durum completed olduğunda ve sipariş başına bir kez akış başlatır.
• Aynı sipariş veya müşteri için tekrar gelen teslimatlar ikinci kez akış başlatmaz.
• WooCommerce teslimatları arka planda (Action Scheduler / WP-Cron) gönderir; trafiği az olan sitelerde birkaç dakikalık gecikme normaldir.

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et sipariş listesine erişimi dener ve site adını ile toplam sipariş sayısını gösterir. Webhook'ları denemek için mağazada bir test siparişi verin ve iş akışının Çalıştırmalar sekmesine bakın.

Kimlik bilgilerini yenileme#

WooCommerce → Ayarlar → Gelişmiş → REST API'de yeni anahtar oluşturun → OrqLabs'ta ayrıntı panelinden Kimlik bilgileri → Güncelle → eski anahtarı İptal et. Webhook'lar kendi gizli anahtarlarını kullandığı için etkilenmez.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Sipariş numaraları özel bir eklentiyle değişiyorsa? orderNumber WooCommerce'in gösterdiği numaradır (eklenti değiştirdiyse onun biçimi); kutu işlemleri ise orderId (veritabanı numarası) ister.

Misafir siparişlerde müşteri bilgisi gelir mi? Evet; ad, e-posta ve telefon fatura bilgilerinden okunur. customerId yalnızca hesabı olan müşterilerde vardır.

Müşteriye not gönderince e-posta kimden çıkar? WooCommerce'in kendi e-posta ayarlarından (WooCommerce → Ayarlar → E-postalar → Müşteri notu).

Sonraki adım#

• Shopify
• WordPress
• Entegrasyonlara genel bakış