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

Shopify Entegrasyonu

Shopify mağazanızı TotalApp'e bağlayın ve yapay zeka destekli e-ticaret analizleri yapın.

Genel Bakış

TotalApp'in Shopify entegrasyonu, mağazanızdaki ürün, sipariş ve müşteri verilerini doğrudan TotalApp arayüzünde görüntülemenizi ve yapay zeka destekli analizler yapmanızı sağlar. Shopify Admin API'si aracılığıyla güvenli bağlantı kurulur; verileriniz TotalApp sunucularında saklanmaz.

🛍️ Ürün Verileri

Tüm ürünlerinizi, varyantlarınızı ve stok durumunuzu gerçek zamanlı görüntüleyin.

📦 Sipariş Takibi

Son siparişleri, müşteri bilgilerini ve sipariş durumlarını tek ekranda izleyin.

👥 Müşteri Analizi

En değerli müşterilerinizi, satın alma geçmişlerini ve demografik verilerini inceleyin.

🤖 Yapay Zeka Asistanı

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

Bağlantı Kurma

Shopify mağazanızı bağlamak için bir Özel Uygulama (Custom App) oluşturmanız ve API kimlik bilgilerinizi TotalApp'e girmeniz gerekir. Bu işlem yaklaşık 5 dakika sürer.

1. Shopify Admin → 2. Özel Uygulama → 3. API İzinleri → 4. TotalApp'e Gir → 5. Bağlandı!

Adım 1: Shopify Admin Paneline Giriş

Shopify yönetici panelinize (mağazanız.myshopify.com/admin) gidin.

Adım 2: Özel Uygulama Oluşturma

  1. Ayarlar → Uygulamalar ve satış kanalları'na gidin
  2. Sayfanın üst kısmındaki Özel uygulamalar geliştir bağlantısına tıklayın
  3. Henüz etkinleştirilmemişse Özel uygulama geliştirmeyi etkinleştir düğmesine tıklayın
  4. Uygulama oluştur düğmesine tıklayın
  5. Uygulama adını girin (örn. "TotalApp Entegrasyonu") ve oluşturun

Adım 3: API İzinlerini Yapılandırma

Oluşturduğunuz uygulamada API kimlik bilgilerini yapılandır sekmesine tıklayın ve aşağıdaki Admin API erişim kapsamlarını etkinleştirin:

  • read_products — Ürün bilgilerine salt okunur erişim
  • read_orders — Sipariş verilerine salt okunur erişim
  • read_customers — Müşteri verilerine salt okunur erişim
  • read_inventory — Stok verilerine salt okunur erişim

Gerekli kapsamları seçtikten sonra Kaydet düğmesine tıklayın ve ardından Yükle düğmesine basın.

Adım 4: API Kimlik Bilgilerini Kopyalama

Uygulama yüklendikten sonra API kimlik bilgileri sekmesine gidin:

  • Admin API erişim jetonu (Access Token) — Kopyalayın ve güvenli bir yerde saklayın. Bu jeton yalnızca bir kez gösterilir!
  • API anahtarı (API Key) — İsteğe bağlı

⚠️ Önemli: Erişim Jetonu Bir Kez Gösterilir

Admin API erişim jetonunu kopyalamak için tek bir fırsatınız olur. Kopyalamadan önce sayfayı kapatırsanız yeni bir uygulama oluşturmanız gerekir. Jetonu not edin veya hemen TotalApp'e yapıştırın.

Adım 5: TotalApp'e Kimlik Bilgilerini Girme

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

AlanDeğer
Mağaza URLmağazanız.myshopify.com (https:// olmadan)
Erişim JetonuShopify'dan kopyaladığınız Admin API Access Token

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

Mağaza Verilerini Görüntüleme

Bağlantı kurulduktan sonra Shopify Entegrasyonu ekranı üç ana sekme sunar:

Ürünler Sekmesi

Mağazanızdaki tüm ürünleri listeler. Her ürün kartında şunlar görünür:

  • Ürün adı ve açıklama
  • Fiyat aralığı (varyantlar varsa)
  • Toplam stok miktarı
  • Ürün durumu (Aktif / Taslak / Arşivlendi)
  • Varyant sayısı

Siparişler Sekmesi

Son 250 siparişi görüntüler. Her sipariş satırında:

  • Sipariş numarası ve oluşturma tarihi
  • Müşteri adı ve e-posta
  • Toplam tutar ve para birimi
  • Sipariş durumu (Ödeme, Gönderim)

Müşteriler Sekmesi

Müşteri listesini toplam harcamaya göre sıralı gösterir:

  • Ad, e-posta
  • Toplam sipariş sayısı
  • Toplam harcama tutarı
  • İlk ve son sipariş tarihleri

🔄 Verileri Yenile

Veriler her sayfa açılışında Shopify API'sinden çekilir. En güncel verileri görmek için sayfayı yenileyin veya Yenile düğmesine tıklayın.

Yapay Zeka Asistanı

Shopify entegrasyonunun en güçlü özelliği, mağaza verilerinizi bağlam olarak kullanan yerleşik Yapay Zeka Asistanıdır. Sağ kenardan açılan panel aracılığıyla doğal dil sorguları yapabilirsiniz.

Örnek Sorgular

  • "En çok satan 5 ürünüm hangileri?"
  • "Bu ay kaç sipariş aldım?"
  • "En değerli müşterilerimi listele"
  • "Stok sorunu olan ürünler var mı?"
  • "Ortalama sipariş değerim nedir?"
  • "Hangi ürün kategorileri en çok gelir getiriyor?"

Asistan Nasıl Çalışır?

Asistan her sorgu öncesinde Shopify API'sinden güncel veri çeker ve bu verileri Claude yapay zeka modeline bağlam olarak iletir. Yanıtlar gerçek mağaza verilerinize dayalıdır.

💡 İpucu: Rapor Olarak Kaydet

Asistanın oluşturduğu analiz raporlarını "Rapor Olarak Kaydet" düğmesiyle kaydedebilirsiniz. Kaydedilen raporlar E-ticaret Raporları ekranında görünür ve daha sonra düzenlenebilir.

Yazıcı Motoru Ayarları

Yapay Zeka Asistanı'nın çalışabilmesi için TotalApp'te bir yazıcı motoru yapılandırmanız gerekir. Desteklenen motorlar:

MotorNasıl Kullanılır
Claude APIAyarlar → Yapay Zeka'ya gidin, ANTHROPIC_API_KEY değerini girin
Claude CLIClaude Code kuruluysa "Local CLI" seçeneğini tercih edin

Ayarlar → Genel → Yazıcı Motoru bölümünden motor seçimini değiştirebilirsiniz.

Sık Sorulan Sorular

Verilerim TotalApp sunucularında saklanıyor mu?
Hayır. TotalApp, Shopify verilerini yalnızca sorgulama anında geçici olarak işler. Hiçbir ürün, sipariş veya müşteri verisi TotalApp sunucularında kalıcı olarak depolanmaz.
Bağlantım güvenli mi?
Evet. Tüm Shopify API çağrıları HTTPS üzerinden şifreli olarak yapılır. API erişim jetonunuz şifreli biçimde saklanır ve yalnızca kimliği doğrulanmış kullanıcılar erişebilir.
Kaç sipariş/ürün görüntülenebilir?
Ürünler için tüm katalog yüklenir. Siparişler için en son 250 sipariş gösterilir. Yapay Zeka Asistanı bağlamı için de bu limitler geçerlidir.
Bağlantıyı nasıl kaldırırım?
Shopify Entegrasyonu ekranında Bağlantı Ayarları bölümüne gidin ve "Bağlantıyı Kaldır" seçeneğini kullanın. Shopify tarafında da oluşturduğunuz özel uygulamayı silebilirsiniz.

Sonraki Adımlar