Shopify bağlayıcısı
Şunlarla çalışır Shopify
Konuşmaların eşleşen müşteri siparişlerini ve satın alma bağlamını göstermesi için Shopify'ı FreeScout'a bağlayın. Shopify yöneticinizde salt okunur bir özel uygulama oluşturur ve erişim belirtecini FreeScout'a yapıştırırsınız, böylece Partner hesabı veya uygulama incelemesi gerekmez. ReplyRabbit ayrıca ürün sahipliği bağlamını AI katmanına besler, böylece taslaklar bir müşterinin ne satın aldığına atıfta bulunabilir.
Genel bakışı mı arıyorsunuz?
Genel bakış
Shopify bağlayıcısı FreeScout konuşmalarına bir sipariş kenar çubuğu ekler. Bir konuşmada müşteri e-posta adresi olduğunda, bağlayıcı mağazanızdaki Shopify GraphQL Admin API'sini eşleşen siparişler için sorgular ve bunları konuşmanın yanında gösterir.
Kenar çubuğu bir müşteri paneli, tam sipariş geçmişi, miktar ve fiyatlarla sipariş başına satır öğeleri, finansal toplamlar, müşteri yaşam boyu değeri (CLV), ortalama sipariş değeri (AOV) ve daha alakalı taslaklar için ReplyRabbit AI bağlamına akan ürün sahipliği hakkı gösterir.
Yüklenecek tek bileşen vardır: FreeScout Shopify bağlayıcı modülü. Özel bir uygulamadan alınan Admin API erişim token'ını kullanarak Shopify GraphQL Admin API'sini HTTPS üzerinden okur, ardından sipariş kenar çubuğunu oluşturur. FreeScout'ta kendi posta kutusu başına ayarlar sayfası vardır.
Sipariş kenar çubuğu kendi başına çalışır. AI taslaklarına akan ürün sahipliği yetkisi, ReplyRabbit'i kullanan kısımdır.
Ön koşullar
Başlamadan önce şunlara sahip olduğunuzdan emin olun:
- Çalışan bir FreeScout kurulumu.
- Şurada bir Shopify mağazası
your-store.myshopify.comalan adı (veya birine eşlenen özel bir alan adı), uygulama geliştirmek için personel izinleriyle. - AI taslaklarında ürün sahipliği bağlamı istiyorsanız ReplyRabbit kuruldu ve etkinleştirildi.
- Bir Shopify Connector lisansı (tek seferlik 18 EUR, bir FreeScout kurulumu için) veya bunu içeren aktif bir ReplyRabbit Pro ya da Team planı.
ReplyRabbit henüz kurulu değilse, şununla başlayın ReplyRabbit modülü nasıl kurulur, ardından tamamlayın ReplyRabbit nasıl kurulur.
Shopify'da özel bir uygulama oluşturun
Bağlayıcı, kendi mağazanızın içinde bulunan özel bir uygulamadan alınan bir Admin API erişim belirteciyle kimlik doğrular.
Uygulamaları geliştir'i aç
Shopify yöneticisinde şuraya gidin Ayarlar, ardından Uygulamalar ve satış kanalları, ardından Uygulama geliştir. İstenirse, özel uygulama geliştirmeye izin verin.Uygulamayı oluşturun
Tıklayın Uygulama oluşturun, adını "ReplyRabbit Connector" koyun ve oluşturun.Admin API kapsamlarını ayarlayın
Aç Admin API kapsamlarını yapılandırın ve işaretleyinread_customers,read_orders, veread_products. İşaretleyinread_all_orders60 günden eski sipariş geçmişini istiyorsanız da. Kaydedin.Belirteci kurun ve kopyalayın
Tıklayın Uygulamayı kur, ardından Token'ı bir kez göster ve şunu kopyalayın: Yönetici API erişim belirteci (şununla başlarshpat_). Shopify bunu yalnızca bir kez gösterir, bu yüzden güvenli bir yerde saklayın.
Yalnızca okuma erişimi
FreeScout bağlayıcı modülünü kurun
Bağlayıcı modülünü indir
FreeScout bağlayıcı modülü ZIP'ini şuradan indirin: ReplyRabbit kontrol paneli. İndirme, bağlayıcıyı satın aldığınızda veya etkin bir ReplyRabbit Pro ya da Team planına sahip olduğunuzda görünür.FreeScout'a yükle
FreeScout'ta şuraya gidin Modüller, yükleme düğmesine tıklayın, ZIP'i seçin ve yükleyin.Modülü etkinleştir
Şunu etkinleştir Shopify Entegrasyonu modülünü Modüller listesinden.
Posta kutusu başına yapılandırın
Bağlayıcı ayarlarını açın
FreeScout'ta Shopify sipariş verilerini göstermesi gereken posta kutusunu açın, posta kutusu ayarları menüsünü açın ve şunu seçin Mağaza Bağlayıcısı. Bu, Shopify bağlayıcısının ayarlar sayfasıdır, ReplyRabbit ayarları içindeki bir bölüm değildir.Mağaza alan adını ve erişim tokenını girin
Mağaza alan adınızı girin, örneğinyour-store.myshopify.com, ve Admin API erişim token'ını yapıştırın. Kaydedin. Bağlayıcı, token'ı saklamadan önce mağazanıza karşı token'ı ve kapsamları kontrol eder; token şifrelenmiş olarak saklanır ve bir daha asla gösterilmez.Bağlayıcı lisans anahtarınızı ekleyin
Bağlayıcıyı satın aldıysanız, şunu ayarlayınSHOPIFYINTEGRATION_LICENSE_KEYFreeScout'unuzda.envlisans anahtarına. Etkin bir ReplyRabbit Pro ya da Team planı kurulumu kapsıyorsa bu adımı atlayın.Test
Müşteri e-postasının bir Shopify siparişiyle eşleştiği bir FreeScout konuşması açın ve sipariş kenar çubuğunun göründüğünü doğrulayın.
Her FreeScout posta kutusu kendi mağaza alan adını ve erişim token'ını saklar, böylece farklı posta kutularını farklı mağazalara bağlayabilirsiniz.
Bağlayıcı neleri gösterir
- Konuşmadaki kişi için bir müşteri paneli.
- Sipariş numarası, tarih, durum ve toplam ile tam sipariş geçmişi.
- Miktarlar ve fiyatlarla sipariş başına satır öğeleri.
- Finansal toplamlar (ara toplam, indirim, kargo, vergi, iadeler).
- Müşteri yaşam boyu değeri (CLV) ve ortalama sipariş değeri (AOV).
- Yapay zeka taslakları için ürün sahipliği hakkı.
Bağlayıcı nasıl alınır
Shopify Bağlayıcısı ücretli bir modüldür. Onu iki şekilde edinebilirsiniz:
- Shopify Connector'ı bir FreeScout kurulumu için tek seferlik lisans olarak 18 EUR'ya satın alın, ardından lisans anahtarını şu şekilde ayarlayın
SHOPIFYINTEGRATION_LICENSE_KEYFreeScout içinde.env. - Bağlayıcıyı ekstra maliyet olmadan içeren etkin bir ReplyRabbit Pro veya Team planı kullanın.
Lisansı satın alın veya connector'ı şuradan indirin ReplyRabbit kontrol paneli. Şurayı ziyaret edin: fiyatlandırma sayfası ReplyRabbit plan seçenekleri için. Etkin bir ReplyRabbit Pro veya Team planı kurulumu kapsıyorsa, bağlayıcı yapılandırıldıktan sonra ayrı bir lisans anahtarı gerekmeden çalışır.
Sorun giderme
| Belirti | Neleri kontrol etmeli |
|---|---|
| Kaydederken "Shopify bağlantıyı reddetti" | Belirteç yanlış yazıldı, iptal edildi veya farklı bir mağazaya ait. Özel uygulamayı yeniden yükleyerek yeni bir belirteç ortaya çıkarın ve tekrar yapıştırın. |
| Kaydederken "Bu Admin API kapsamları eksik" | Özel uygulamayı açın, eksik kapsamları şunun altına ekleyin: Admin API kapsamlarını yapılandırın, kaydedin ve uygulamayı yeniden yükleyin. Yeniden yükleme yeni bir token oluşturur. |
| Mağaza alan adı reddedildi | Şunu kullanın your-store.myshopify.com alan adı veya ona eşlenen özel bir alan adı. Özel ana makineler ve IP adresleri reddedilir. |
| Sipariş kenar çubuğu görünmüyor | Posta kutusu panelinin etkin olduğunu ve bağlantının ayarlar sayfasında bağlı olarak göründüğünü doğrulayın. |
| Bilinen bir müşteri için siparişler boş | FreeScout konuşmasındaki müşteri e-postasının Shopify siparişlerindeki e-postayla eşleştiğini doğrulayın. |
| Yalnızca son 60 günün siparişleri gösterilir | Şunu ekleyin read_all_orders özel uygulamaya kapsam verin, yeniden yükleyin ve yeni belirteci yapıştırın. |
| Satır öğeleri, finansallar veya CLV görünmüyor | Bağlayıcı lisans anahtarının kaydedildiğini veya etkin bir ReplyRabbit Pro ya da Team planının kurulumu kapsadığını doğrulayın. |
| Ürün sahipliği bağlamı taslaklarda görünmüyor | Bağlayıcının lisanslı olduğunu, ReplyRabbit'in kurulu olduğunu, bağlayıcının sipariş döndürdüğünü ve yapay zeka bağlam özelliğinin posta kutusu için etkin olduğunu doğrulayın. |
Daha geniş sorunlar için bkz. ReplyRabbit sorun giderme.
Gizlilik ve veri işleme
Bağlayıcı Shopify'ı sorguladığında, müşteri e-posta adresini özel uygulamanızın tokenını kullanarak HTTPS üzerinden Shopify GraphQL Admin API'sine gönderir. Mağazanızdan dönen sipariş verileri FreeScout kenar çubuğunu doldurur ve ReplyRabbit ile taslaklar için AI bağlamını oluşturur.
Özel uygulama yalnızca okuma kapsamlarına sahiptir, bu nedenle bağlayıcı mağazanıza asla yazmaz. Erişim belirteci FreeScout'ta şifreli olarak saklanır ve giden istekler TLS'i doğrular ve hiçbir yönlendirmeyi izlemez.
Shopify sipariş verileri, yalnızca AI bağlam özelliği kullandığında posta kutusu için seçilen AI sağlayıcısı dışında üçüncü taraflara gönderilmez. Politikanız sipariş verilerinin tamamen kendi sunucularınızda kalmasını gerektiriyorsa posta kutusu için yerel bir AI sağlayıcısı (örneğin Ollama) kullanın.
Sonraki adımlar
- Bitir ReplyRabbit nasıl kurulur posta kutusu hâlâ sağlayıcı, bağlam veya üslup ayarlarına ihtiyaç duyuyorsa.
- WooCommerce veya Magento'da da mı var? Şuna bakın WooCommerce bağlayıcısı ve Magento bağlayıcısı kılavuzlar.
SSS
Shopify bağlayıcısı mağazama nasıl bağlanır?
Shopify yöneticisinde oluşturduğunuz özel bir uygulamayla (Ayarlar, Uygulamalar ve satış kanalları, Uygulamalar geliştir). Ona read_customers, read_orders ve read_products kapsamlarını verin, kurun ve Admin API erişim tokenını mağaza alan adınızla birlikte FreeScout bağlayıcı ayarlarına yapıştırın. Bağlayıcı, kaydetmeden önce tokenı mağazanıza karşı doğrular.
Shopify Partner hesabına veya App Store listesine ihtiyacım var mı?
Hayır. Özel bir uygulama kendi mağaza yöneticiniz içinde oluşturulur ve Partner hesabı, uygulama incelemesi veya genel bir liste kaydı gerektirmez.
Shopify Bağlayıcısı ne kadar tutar?
Shopify Bağlayıcısı, etkin bir ReplyRabbit Pro veya Team planıyla birlikte gelir. Aksi takdirde, bir FreeScout kurulumu için tek seferlik lisans olarak 18 EUR tutarındadır. Satın alırsanız, lisans anahtarını FreeScout .env dosyanızda SHOPIFYINTEGRATION_LICENSE_KEY olarak ayarlayın.
Neden yalnızca son 60 günün siparişlerini görüyorum?
Shopify, uygulama read_all_orders kapsamına sahip olmadıkça uygulamaları 60 günlük sipariş geçmişiyle sınırlar. Tam geçmişi görmek için özel uygulamayı yapılandırırken read_all_orders seçeneğini işaretleyin.
Her FreeScout posta kutusu farklı bir Shopify mağazasına bağlanabilir mi?
Evet. Her posta kutusu kendi mağaza alan adını ve erişim token'ını bağlayıcı ayarlarında saklar, böylece farklı mağazalar farklı posta kutularına bağlanabilir.