SocialHub.AI
Kaynaklar · Geliştirici Merkezi

Shopify, Amazon ve TikTok Mağazası

E-ticaret kanallarınızı bağlayın, böylece çevrimiçi siparişler sadakat puanı kazanır. Shopify ürünleri senkronize eder ve siparişlerde otomatik olarak puan verir; Amazon ve TikTok Shop, üyelerin pazaryeriyle karşılaştırdığımız siparişler için puan kazanmalarını sağlar - asla alışveriş yapanın sözüne güvenmeyiz. Üçünü de uygulamada Ayarlar → Çevrimiçi Mağaza altında yapılandırabilirsiniz.

Üç kanal, tek yer

Üçü de Ayarlar → Çevrimiçi Mağaza sayfasında tek bir sekmeli kart olarak yer almaktadır. Shopify tam senkronizasyondur (ürünler + otomatik sipariş puanları). Amazon ve TikTok Mağazası doğrulanmış sipariş kanallarıdır: bir üye siparişini number portalda kendisi bildirir ve platform, puanları vermeden önce satıcı tarafından yetkilendirilmiş API siparişten yetkili siparişi alır. Alıcıya ait kişisel bilgiler asla saklanmaz.

Çevrimiçi Mağaza

Shopify

Ürün verilerini kampanyalarınıza entegre etmek ve tamamlanan siparişleri sadakat puanlarına dönüştürmek için Shopify mağazanızı bağlayın — kod gerekmez, sadece bir mağaza alan adı ve bir Yönetici API erişim belirteci yeterlidir.

1 · Shopify'de bir Yönetici API erişim belirteci oluşturun

Shopify Yönetici panelinizde Ayarlar → Uygulamalar ve satış kanalları → Uygulama geliştir → bir uygulama oluşturun, ona read_products ve read_orders izinlerini verin (yazma izinlerini yalnızca ihtiyacınız varsa ekleyin) ve Yönetici API erişim belirtecini (shpat_…) ortaya çıkarmak için yükleyin.

2 · Mağazayı SocialHub'a bağlayın

Uygulamada, Ayarlar → Çevrimiçi Mağaza → Çevrimiçi Mağaza sekmesi. Mağaza alan adınızı (my-store.myshopify.com) ve Yönetici API erişim belirtecinizi girin. Belirteç, kaydedilmeden önce mağazanıza karşı doğrulanır ve bekleme durumunda şifrelenir (AES-256-GCM) — asla kaydedilmez veya tekrar gösterilmez.

3 · Senkronize et ve kazan

Kampanyalarınız için ürün kataloğunuzu çekmek üzere Şimdi Senkronize Et'e tıklayın. Bundan sonra, tamamlanan siparişler otomatik olarak sadakat puanları kazandırır (makbuzlarla aynı formül) ve ilk / tekrarlanan satın alımlar, satın alma sonrası otomasyon etkinliklerini tetikler.

// What the platform exposes for the Online Shop connection:
POST /api/shopify/connect      { "shopDomain": "my-store.myshopify.com", "accessToken": "shpat_…" }
GET  /api/shopify/status       // → { connected, shopDomain, status, lastSyncedAt, productCount, apiVersion }
POST /api/shopify/sync         // pull products now
POST /api/shopify/disconnect   // remove the connection + synced product data
//
// Orders: SocialHub receives Shopify order webhooks (order.fulfilled) and awards points
// keyed by the order id — idempotent, so a replayed webhook never double-awards.
// Connecting an Online Shop requires the Omnichannel plan.
Pazar yeri

Amazon

Üyelerin doğrulanmış Amazon siparişleri için puan kazanmalarına izin verin. Satıcı Merkezi hesabınızda bir Amazon SP-API uygulaması (Amazon ile Giriş Yap) yetkilendirirsiniz; platform, bu kimlik bilgilerini kullanarak her kendi kendine bildirilen siparişi alır ve yalnızca sipariş gerçekse puan verir. Bunu Ayarlar → Çevrimiçi Mağaza → Amazon altında kurun (ekip yöneticileri ve sistem yöneticileri).

Bağlantı ayarları

Bağlantı Adı
Bu bağlantı için bir etiket, ör. “Amazon ABD - BrandX”. Çok satıcılı mı? Bağlantı başına farklı bir ad kullanın.
Bölge
SP-API uç noktasının AWS bölgesi, örneğin us-east-1.
Uç nokta
Bölgeniz için SP-API sunucusu, örneğin https://sellingpartnerapi-na.amazon.com.
Pazar Yeri Kimlikleri
Virgülle ayrılmış, örneğin ATVPDKIKX0DER (Amazon ABD).
Satıcı Kimliği
İsteğe bağlı — Satış Ortağınız / satıcı kimliğiniz.

Sırlar (kullanılmadığında şifrelenir, salt yazılır)

LWA Yenileme Jetonu
Atzr|… — Seller Central'da SP-API uygulamanızın yetkilendirilmesinden.
LWA İstemci Kimliği
amzn1.application-oa2-client… — SP-API uygulamanızın istemci kimliği.
LWA Müşteri Gizli Anahtarı
SP-API uygulamanızın istemci gizli anahtarı.

Kaydet ve Doğrula, SP-API'ye karşı canlı bir canlılık kontrolü gerçekleştirir ve görebildiği pazar yerlerini listeler. LWA yenileme belirteci dönmüyor; istediğiniz zaman bağlantı satırından yeniden doğrulayın.

Pazar yeri

TikTok Mağazası

TikTok Shop Ortağı API'ya karşı Amazon ile aynı doğrulama-güvenme modeli. Bir Uygulama Anahtarı / Uygulama Sırrı ve yenileme jetonu almak için mağazanızda bir TikTok Shop Partner uygulamasına yetki verirsiniz. Bunu Ayarlar → Çevrimiçi Mağaza → TikTok Mağazası (ekip yöneticileri ve sistem yöneticileri) altında ayarlayın.

Bağlantı ayarları

Bağlantı Adı
Bu bağlantı için bir etiket, örneğin “TikTok ABD - BrandX”.
Bölge
Alışveriş bölgesi, ör. biz.
Şifre alışverişi
İsteğe bağlı — boş bırakın; Kaydet ve Doğrula bunu yetkili mağazanızdan keşfeder.

Sırlar (kullanılmadığında şifrelenir, salt yazılır)

Uygulama Anahtarı
TikTok Shop Partner uygulamanızın anahtarı.
Uygulama Sırrı
TikTok Shop Partner uygulamanızın gizli anahtarı.
Yenileme Jetonu
ROW_… — mağazanızdaki uygulamayı yetkilendirmekten. TikTok bunu her yenilemede döndürür; platform sizin için rotasyona devam eder.

Mağaza Şifresini boş bırakın — Kaydet ve Doğrula, yetkili mağazanızdan bunu keşfeder. TikTok, her yenilemede yenileme belirtecini döndürür; platform, eş zamanlı işlerin birbirini geçersiz kılmaması için döndürmeyi serileştirir ve kalıcı hale getirir.

// Marketplace credentials (Amazon / TikTok Shop) are saved + liveness-checked here.
// Open to team admins (org_owner / org_admin) and system admins; tenant-isolated —
// an admin can only ever read/write their OWN team's channels.
POST /api/admin/channels            { teamId, kind: "amazon" | "tiktok", name, config, secrets }
POST /api/admin/channels/{id}/ping  // re-verify the connection (discovers shop refs / cipher)
//
// Secrets (refresh_token, client_secret, app_secret, …) are AES-GCM encrypted the
// instant they arrive — write-only, never returned, never logged.

Kimlik bilgileri nasıl güvende tutulur?

Dinlenme sırasında şifrelendi

Her sır (erişim belirteci, yenileme belirteci, istemci/uygulama sırrı) geldiği anda AES-GCM ile şifrelenir. Sırlar salt yazılır; hiçbir zaman tarayıcıya geri gönderilmez, günlüklere veya e-postalara asla yazılmaz.

Kiracıya özel

Kanal kimlik bilgileri tek bir ekibe bağlıdır. Ekip yöneticileri (org_owner / org_admin) ve sistem yöneticileri bunları yönetir ve yalnızca kendi ekiplerinin bağlantılarını okuyabilir veya yazabilirler.

Doğrulayın, güvenmeyin

Amazon ve TikTok Shop için puanlar yalnızca platformun yetkili satıcı API'dan aldığı siparişler için verilir. Alıcının PII'si önce eşleştirilir, sonra atılır ve hiçbir zaman sipariş kaydında kalıcı olmaz.

İdempotent kazanç

Shopify sipariş web kancaları ve pazaryeri sipariş numaraları sipariş kimliğine göre anahtarlanır, bu nedenle tekrar oynatma veya kopya gönderim asla iki kez puan kazandırmaz.

İlgili: REST API · POS · OMS · ERP · Üye Portalı Gömme

Bir satış kanalı mı bağlıyorsunuz?

Shopify kapsamları, SP-API yetkilendirmesi, TikTok Mağaza İş Ortağı uygulamaları veya doğrulanmış sipariş puanlarının nasıl çalıştığı hakkında bir mühendisle görüşün.

Mühendislikle konuş