WooCommerce (müşteri verisi)

Nereden: Ayarlar → Entegrasyonlar → Müşteri verisi → WooCommerce → Bağla

Telefon çalarken arayanın numarasıyla mağazanızdaki son siparişler sorgulanır. Asistan siparişin durumunu, ürünleri, tutarı ve varsa kargo firmasıyla takip numarasını görüşme başlamadan bilir. Genel bilgi, KVKK ve asistanın neyi söyleyip neyi söylemediği için Müşteri verisi makalesine bakın.

Arayan "Kargom nerede?" dediğinde asistan cevabı aramadan bilsin: telefon çalarken arayanın numarasıyla WooCommerce mağazanızdaki siparişler sorgulanır; son siparişler, durumları ve kargo takip numarası asistana görüşme başlamadan ulaşır. Bunun için WooCommerce'te yalnızca okuma izinli bir REST API anahtarı oluşturursunuz.

Sunucu IP adresimiz: 188.245.28.244

Başlamadan önce

• WordPress yönetim paneline WooCommerce ayarlarını değiştirebilen bir kullanıcıyla giriş.
• Mağazanızın https:// ile açılması: WooCommerce anahtarları yalnızca güvenli bağlantıda kabul eder.
• Asistanın kargo takip numarasını bilmesi için resmî Shipment Tracking eklentisi ya da takip numarasını sipariş meta alanına yazan bir kargo eklentisi. WooCommerce kargo takibini kendisi tutmaz.

Adım adım

1. WordPress panelinde WooCommerce → Ayarlar → Gelişmiş → REST API sayfasını açın (İngilizce panelde WooCommerce → Settings → Advanced → REST API) ve Anahtar ekle'ye (Add key) tıklayın.
2. Açıklamaya e-Temsilci yazın, kullanıcı olarak siparişleri görebilen bir yönetici seçin ve izni Okuma (Read) yapın. API anahtarı oluştur'a (Generate API key) basın.
3. Ekranda gösterilen Consumer key (ck_…) ve Consumer secret (cs_…) değerlerini kopyalayın. Sayfadan çıkınca secret bir daha gösterilmez; kaybederseniz yeni anahtar oluşturursunuz.
4. Bu formda mağaza adresinizi (ör. https://magazam.com) ve iki anahtarı girin. Kargo takip bilgisinin nereden okunacağını seçin: Shipment Tracking eklentisi, kendi kargo eklentinizin sipariş meta alanı (anahtarını yazarak) ya da takip bilgisi yok.
5. Arayana ne kadar bilgi verileceğini seçip kaydedin. Anahtar hemen denenir; kartta Bağlı görünmelidir.
6. Kartta Test et'e basıp müşterilerinizden birinin telefon numarasını yazın: asistanın göreceği siparişler, süre ve atılan alanlar gösterilir.
7. Gelen çağrılar → Asistan'da "Arayanın sipariş ve müşteri bilgilerini sorgula" açık olsun. Giden kampanyalarda aynı anahtar sihirbazın Asistan adımındadır (varsayılan kapalı).

Sorun yaşarsanız

• Siparişler fatura ve teslimat telefonuna göre bulunur. Telefonu boşluklu kaydedilmiş siparişler (ör. 0532 111 22 33) bulunamaz; ödeme sayfanızda numaranın boşluksuz alınması en iyisidir.
• "Anahtar reddedildi" hatasında iznin Okuma olduğunu ve anahtarın sahibi kullanıcının siparişleri görebildiğini kontrol edin. Hata sürerse sunucunuz Authorization başlığını iletmiyor olabilir: "Anahtarın gönderilme şekli"ni Sorgu parametresi yapın.
• "REST API bulunamadı (404)" hatasında adresi kontrol edin; WordPress Ayarlar → Kalıcı bağlantılar'da (Permalinks) Düz (Plain) dışında bir yapı seçili olmalıdır.
• Güvenlik eklentiniz veya güvenlik duvarınız (Cloudflare, Wordfence vb.) istekleri engelliyorsa 188.245.28.244 IP adresine izin verin.
• WooCommerce'te "teslim edildi" durumu yoktur: Tamamlandı siparişler için asistan "kargoya verildi" der ve takip numarasını verir, teslimatı uydurmaz. Eklentiyle eklenen özel durumlar (ör. "Kargoda") asistana kendi adıyla aktarılır.

Bağlantılar: WooCommerce REST API kimlik doğrulama · Shipment Tracking eklentisi

Asistan hangi durumu nasıl anlatır?

• Ödeme bekleniyor: ödemesi henüz alınmamış siparişler (WooCommerce'te pending) ve havale / çekle verilip beklemeye alınmış siparişler (on-hold).
• Beklemede: diğer ödeme yöntemleriyle beklemeye alınmış siparişler (on-hold).
• Hazırlanıyor: ödemesi alınmış, gönderilmeyi bekleyen siparişler (processing).
• Kargoya verildi: tamamlanmış siparişler (completed). WooCommerce teslimatı bildirmediği için asistan "teslim edildi" demez.
• İptal edildi, İade edildi, Tamamlanamadı: cancelled, refunded, failed. Kısmi iadede ödeme "kısmen iade edildi" olarak görünür.
• Eklentiyle eklenen özel durumlar (ör. kargoda) asistana durumun kendi adıyla aktarılır.

Kargo takip numarası yalnızca seçtiğiniz kaynakta (Shipment Tracking eklentisi veya kargo eklentinizin sipariş meta alanı) varsa bilinir. Asistan takip numarasını yalnızca istenirse okur; takip bağlantısını okumaz.

Sınırlar

• Siparişler fatura ve teslimat telefonuna göre aranır; en yeni 5 sipariş kullanılır. Telefonu boşluklu kaydedilmiş siparişler bulunamaz.
• Arayan bir sipariş numarası söylerse asistan o numarayla tekrar sorgular. Sipariş başka bir telefona aitse yalnızca durumu ve kargo bilgisi kullanılır.
• WooCommerce'in REST API'sinde istek sınırı yoktur, ama barındırma firmanız veya güvenlik eklentiniz sınır koyabilir. Her gelen çağrı mağazanıza bir veya iki istek gönderir.