TotalApp Dökümanlar

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.

Ekran önizlemeleri

Ekranlara kısa bir bakış. Koyu ve açık tema arasında geçmek için her önizlemenin köşesindeki anahtarı kullanın.

app.totalapp.app/ecommerce/shopify
S
my-store.myshopify.com
Bağlı · 3 uç nokta aktif
Şimdi Senkronize Et
YZ Asistanı
Siparişler (30 g)
1,284
↑ geçen aya göre %12
Ürünler
347
24 düşük stok
Müşteriler
8,920
↑ bu hafta 89 yeni
Webhook Tetikleyicileri (İş Akışı Düzenleyicisi)
orders/create
Aktif
products/update
Aktif
customers/create
+ İş Akışı Ekle

Canlı sayılar ve webhook tetikleyicileriyle Shopify bağlantısı

app.totalapp.app/ecommerce/catalog
🛍️ Ürün Kataloğu
Tümü
Giyim
Aksesuarlar
Elektronik
👟
Air Runner Pro
SKU-SHO-042
$129.00
In Stock 84
👜
Deri Omuz Çantası
SKU-BAG-017
$89.00
Low 7
⌚
Akıllı Saat X2
SKU-ELC-009
$249.00
In Stock 31
🧢
Kanvas Şapka
SKU-APR-055
$32.00
Yok 0
🕶️
Polarize Gözlük
SKU-ACC-028
$54.00
In Stock 19
🎒
Trekking Sırt Çantası 35L
SKU-BAG-031
$148.00
Low 3
👕
Merinos Yün Tişört
SKU-APR-012
$45.00
In Stock 67
💻
Dizüstü Kılıfı 15"
SKU-ELC-033
$38.00
In Stock 52

Varyant, fiyat ve stok rozetleriyle ürün kataloğu

app.totalapp.app/ecommerce/orders
📦 Siparişler
Tümü
Bekliyor
Karşılandı
İade Edildi
Sipariş
Müşteri
Kalemler
Toplam
Durum
#5041
Elif Yıldız
sarah@email.com
Air Runner Pro × 1
$129.00
Karşılandı
#5040
Cem Parlak
jpark@corp.io
Smart Watch X2 × 2
$498.00
Bekliyor
#5039
Ebru Lale
emma.l@mail.se
Omuz Çantası + Gözlük
$143.00
Karşılandı
#5038
Cengiz Mert
c.mendez@mx.net
Trail Backpack 35L × 1
$148.00
İşleniyor
#5037
Ayten Pekin
apetrova@ru.co
Merino Wool Tee × 3
$135.00
İade Edildi
#5036
Tolga Vural
twalsh@uk.org
Laptop Sleeve 15" × 2
$76.00
Karşılandı
#5035
Selin Aksoy
selin.a@mail.com.tr
Yoga Matı Pro × 1
$64.00
İşleniyor
#5034
Murat Demir
mdemir@shop.com.tr
Kablosuz Kulaklık × 2
$158.00
Karşılandı

Karşılama durumuyla sipariş akışı

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

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