Yardım Merkezi
Chatbot entegrasyonları

BigCommerce ile Entegrasyon

Son güncelleme:

BigCommerce mağazanızı ChatLab chatbotunuza bağlayın. Bağlantı kurulduktan sonra chatbot ürünlerinizi arar, tüm kataloğu AI Search için dizine ekler, müşterilerin sohbet içinden ürünleri sepete eklemesine olanak tanır ve siparişlerinin durumunu doğrudan mağazanızdan kontrol eder.

Örnek konuşma

Bir konuşmada görün

Bir siparişi kontrol edin

Bağlı bir mağaza ve etkinleştirilmiş sipariş eylemi gerektirir. Kullanılabilir alanlar entegrasyona bağlıdır. E-posta adresinin eşleşmesi kimlik kanıtı değildir.

ChatLab örneğiÖrnek konuşma

Ziyaretçi: Siparişim nerede?

Örneği oynatın veya aşağıdan okuyun. Gerçek müşteri verisi kullanılmaz.
1 / 5

Müşteri mevcut bir siparişi sorar.

Bu örnek ekrandan çıktığında oynatma duraklatılır. Bu bir simülasyondur, canlı sohbet değildir. Oynatma içindeki widget kontrolleri etkileşimli değildir.
Örneğin tamamını okuyun
  1. Müşteri mevcut bir siparişi sorar.

    Ziyaretçi: Siparişim nerede?

  2. Varsayılan arama her iki tanımlayıcıya da ihtiyaç duyar.

    Asistan: Lütfen sipariş numaranızı ve ödeme sırasında kullanılan e-posta adresini belirtin.

  3. Bu örnekte kurgusal veriler kullanın.

    Ziyaretçi: 41982, anna@example.com

  4. Eylem, bağlı mağazayı sorgular.

    41982 numaralı sipariş kontrol ediliyor...

  5. Yalnızca mağaza tarafından döndürülen bilgileri bildirin.

    Asistan: 41982 numaralı sipariş kargoya verildi olarak işaretlendi. Kargo firması DPD. Teslimat güncellemeleri için lütfen takip sayfasını kontrol edin.

Bu örnek, müşteri deneyimini göstermektedir. Kullanılabilen eylemler ve döndürülen bilgiler bu entegrasyona ve yapılandırmanıza bağlıdır.

Önemli: e-ticaret için en iyi uygulamalar

Aşağıdaki entegrasyonu tamamladıktan sonra, chatbotunuzu e-ticaret için optimize etmeye yönelik ayrıntılı rehberi okuyun: E-ticaret mağazanız için ChatLab kurulumu nasıl yapılır

Entegrasyonun sağladığı özellikler

Yapay zeka ile ürün arama - Müşteriler ihtiyaç duydukları şeyleri kendi ifadeleriyle tanımlar ve chatbot kataloğunuzda eşleşen ürünleri bulur. Yanıt şunları içerir:

  • Ürün adı ve açıklaması
  • Mağaza para biriminizdeki güncel fiyat ve indirimdeki ürünler için normal fiyat
  • Ürün görseli
  • Mağazanızdaki ürün sayfasına doğrudan bağlantı
  • Üründe mevcut olduğunda stok durumu, SKU, marka, kategoriler ve ürün seçenekleri (bedenler, renkler)

İfadeye göre ürün arama - BigCommerce kataloğunuzda basit bir anahtar kelime araması. Katalog dizine eklendiğinde yapay zeka ile ürün arama bunun yerini otomatik olarak alır.

Sipariş durumu - Müşteri sipariş numarasını ve ödeme sırasında kullanılan e-posta adresini iletir; chatbot ise sipariş durumu, sipariş edilen ürünler, toplam tutarlar ve sipariş kargoya verildiğinde kargo takip ayrıntılarıyla yanıt verir. Siparişler her zaman müşterinin e-posta adresiyle eşleştirilir, böylece tahmin edilen bir sipariş numarası asla başkasının siparişini açığa çıkarmaz.

Sepete ekle - Sohbetteki ürün kartlarında Add to cart (Sepete ekle) butonu gösterilebilir. BigCommerce vitrininizde bu buton ürünü doğrudan müşterinin sepetine atar ve sayfa üstbilgisindeki sepet sayacı güncellenir. Beden veya renk gibi seçenekleri olan ürünlerde müşteri varyantı önce sohbet içinden seçer. Sohbetin dolduramayacağı seçeneklere sahip ürünlerde (örneğin gravür için zorunlu bir metin alanı), buton ürün sayfasını açar.

Vitrininizde sohbet widget'ı - ChatLab, sohbet widget'ını BigCommerce Script Manager aracılığıyla sizin yerinize vitrininize ekler; dolayısıyla yapıştırmanız gereken bir kod yoktur.

Sepet deneyimini inceleyin

Bir sepet örneği ve vitrin testi talimatları için Sepete ürün ekleme sayfasına göz atın. Aşağıdaki sekans örnekleme amaçlıdır; gerçek bir BigCommerce sepet işlemi yürütmez.

Bir konuşmada görün

Sepete eklemeden önce bir varyant seçin

Örnek gösterim akışı: Gerçek sepet butonları ve varyant seçiciler platforma ve mağaza arayüzüne bağlıdır. Bu önizleme gerçek bir sepet işlemi gerçekleştirmez.

ChatLab örneğiÖrnek konuşma

Zümrüt yeşili kruvaze elbise, $79. Viskon, midi boy.

Örneği oynatın veya aşağıdan okuyun. Gerçek müşteri verisi kullanılmaz.
1 / 4

Arama sonuçları, desteklenen mağazalarda sepet kontrolü içeren bir ürün kartı sunar.

Bu örnek ekrandan çıktığında oynatma duraklatılır. Bu bir simülasyondur, canlı sohbet değildir. Oynatma içindeki widget kontrolleri etkileşimli değildir.
Örneğin tamamını okuyun
  1. Arama sonuçları, desteklenen mağazalarda sepet kontrolü içeren bir ürün kartı sunar.

    Zümrüt yeşili kruvaze elbise, $79. Viskon, midi boy.

  2. Müşteri, desteklenen sepet kontrollerini kullanarak bir ürün ve beden seçer.

    Ziyaretçi: Zümrüt yeşili kruvaze elbise, 38 beden.

  3. İşlem başarısını yalnızca mağaza arayüzü sepet işlemini onayladıktan sonra doğrulayın.

    Asistan: Örnek sonuç: Seçilen varyant mağaza sepetinize eklendi.

  4. Ödeme ve sipariş tamamlama mağazada gerçekleşir.

    Asistan: Miktar, fiyat ve teslimat bilgilerini onaylamak için mağazadaki sepetinizi inceleyin, ardından ödeme adımına geçin.

Entegrasyonun sağlamadığı durumlar

  • Sohbet içinden ödeme tamamlama. Müşteri satın alma işlemini BigCommerce mağazanızda tamamlar.
  • Canlı stok uyarıları. Fiyatlar ve stok durumu chatbot yanıt verirken BigCommerce üzerinden okunur, ancak chatbot sonraki değişiklikler hakkında müşterilere bildirim göndermez.
  • Headless vitrinlerde sepete ekleme. Sepete ekle butonu BigCommerce temaları üzerine inşa edilmiş vitrinlerde çalışır. Headless bir vitrinde bunun yerine ürün sayfasını açar ve sohbet widget'ının ilgili siteye manuel olarak eklenmesi gerekir.

Gereksinimler

  • Mağaza sahibi olduğunuz veya uygulama yükleme ya da API hesabı oluşturma yetkisine sahip bir kullanıcı olduğunuz bir BigCommerce mağazası.
  • ChatLab planınıza dahil edilmiş BigCommerce entegrasyonu.
  • Yapay zeka ile ürün arama için: Chatbota atanmış, görünür ürünleriniz için yeterli düzeydeki AI Search kapasitesi. Kullanılabilir kapasiteyi Shop > Products (Mağaza > Ürünler) bölümünden kontrol edin.
  • Aynı chatbota bağlı başka bir mağaza entegrasyonunun bulunmaması.

Aşağıdaki iki yöntemden birini seçin. Her ikisi de aynı sonuca ulaştırır.

Seçenek A: ChatLab uygulamasını yükleyin

  1. BigCommerce kontrol panelinizde Apps (Uygulamalar) bölümüne gidin, ChatLab'i bulun ve Install (Yükle) butonuna tıklayın.
  2. İzinleri inceleyin ve Confirm (Onayla) butonuna tıklayın. ChatLab; ürünler, siparişler, müşteriler ve mağaza bilgileri için salt okuma erişimi ile sohbet widget'ını eklemek üzere vitrin içeriğine erişim talep eder.
  3. ChatLab sayfası kontrol panelinizin içinde açılır. Continue setup (Kuruluma devam et) butonuna tıklayın. ChatLab ilk katılım süreci yeni bir tarayıcı sekmesinde açılır.
  4. ChatLab hesabınıza giriş yapın veya henüz bir hesabınız yoksa yeni bir hesap oluşturun.
  5. Mevcut bir chatbot seçin ya da bu mağaza için yeni bir tane oluşturun.

Hepsi bu kadar. ChatLab mağazayı seçilen chatbota bağlar, ürün arama ve sipariş durumu eylemlerini açar, kataloğunuzu dizine eklemeye başlar ve sohbet widget'ını vitrininize ekler. ChatLab'i dilediğiniz zaman kontrol panelinizin Apps menüsünden tekrar açabilirsiniz.

Uygulamanın BigCommerce üzerinden kaldırılması, entegrasyonu ChatLab tarafında kapatır ve sohbet widget'ını vitrininizden kaldırır. Chatbotunuz ve konuşmaları ChatLab hesabınızda kalmaya devam eder.

Seçenek B: Mağaza düzeyinde bir API hesabı ile bağlanın

Erişimi kendiniz oluşturmayı tercih ettiğinizde veya uygulamayı yüklemeden bir chatbot bağlamak istediğinizde bu seçeneği kullanın.

1. Adım: API hesabını BigCommerce üzerinde oluşturun

  1. BigCommerce kontrol panelinizde önce Settings (Ayarlar), ardından Store-level API accounts (Mağaza düzeyinde API hesapları) bölümüne gidin.
  2. Create API account (API hesabı oluştur) butonuna tıklayın ve örneğin ChatLab gibi bir isim verin.
  3. İzinleri ayarlayın:
    • Products (Ürünler) - salt okuma (read-only)
    • Orders (Siparişler) - salt okuma (read-only)
    • Customers (Müşteriler) - salt okuma (read-only)
    • Information & settings (Bilgiler ve ayarlar) - salt okuma (read-only)
    • Content (İçerik) - düzenleme (modify)
  4. Save (Kaydet) butonuna tıklayın. BigCommerce kimlik bilgilerini bir kez gösterir ve bunları bir metin dosyası olarak indirir.
  5. API path ve Access token değerlerini kopyalayın.

API yolu api.bigcommerce.com/stores/abc123/v3/ biçimindedir. stores/ ile /v3/ arasındaki kısım sizin mağaza kodunuzdur (store hash).

Erişim belirtecini (access token) gizli tutun. BigCommerce üzerindeki API hesabını silerek dilediğiniz zaman erişimi iptal edebilirsiniz.

2. Adım: Mağazayı ChatLab'e bağlayın

  1. ChatLab'de chatbotunuzu açın ve Shop bölümüne gidin.
  2. BigCommerce kutucuğuna tıklayın.
  3. API yolunu (veya yalnızca mağaza kodunu) Store hash or API path alanına, belirteci ise Access token alanına yapıştırın.
  4. Check connection (Bağlantıyı kontrol et) butonuna tıklayın. ChatLab mağaza profilini okur ve mağaza adını, vitrin adresini ve para birimini gösterir.
  5. Connect (Bağlan) butonuna tıklayın.

ChatLab bağlantıyı test eder; ürün arama ve sipariş durumu eylemlerini etkinleştirir. Chatbota AI Search kapasitesi atandığında katalog dizine ekleme işlemi hemen başlar ve onay penceresi bunu size bildirir. Aynı pencere, sohbet widget'ının vitrininize eklenip eklenmediğini de belirtir. Erişim belirteci şifrelenmiş olarak saklanır ve bir daha asla gösterilmez; yalnızca bağlantıyı güncellemek istediğinizde belirteç alanını boş bırakın.

Eylemleri yapılandırın

Settings > AI Actions (Ayarlar > Yapay Zeka Eylemleri) bölümüne gidin. BigCommerce için üç eylem mevcuttur:

  • BigCommerce - AI product search - dizine eklenen katalog üzerinde semantik arama. Ayarlarından yanıta tam ürün kartını dahil edebilir, sonuçları stoktaki ürünlerle sınırlandırabilir ve Add to cart butonunu etkinleştirebilirsiniz.
  • BigCommerce - product search - BigCommerce kataloğunda anahtar kelime araması; chatbot için AI Search kullanılabilir olmadığında kullanılır. Bu arama da stoktaki ürünlerle sınırlandırılabilir ve Add to cart butonunu gösterebilir.
  • BigCommerce - order details - sipariş durumu sorgulama. Eylem ayarlarında istek sınırlandırma (rate limiting) ve kişisel verilerin maskelenmesi özellikleri mevcuttur.

Her eylemin düzenlenebilir bir prompt'u ve chatbot çalışırken sohbette gösterilen bir eylem etiketi bulunur.

Kataloğu kontrol edin

Dizine ekleme sürecini takip etmek, dizine eklenen ürünlere göz atmak ve mağazadaki büyük değişikliklerin ardından kataloğu yeniden eğitmek için Training > E-commerce catalog (Eğitim > E-ticaret kataloğu) bölümünü açın. Mağazanızda görünür olmayan ürünler dizine eklenmez.

Açıklaması olmayan ürünler yalnızca ad, marka, kategoriler ve niteliklere göre dizine eklenir. BigCommerce'teki ürünlerinizin açıklaması yoksa kısa bir açıklama eklemek bile arama sonuçlarını belirgin şekilde iyileştirir.

Chatbotu web sitenizin sayfalarıyla da eğittiğinizde ChatLab bir BigCommerce mağazasını tanır; ürün, kategori ve marka sayfalarını atlar. Ürün verileri katalogdan geldiği için sayfalardan ikinci kez okunmasına gerek kalmaz.

Vitrininizdeki sohbet widget'ı

Mağaza uygulama üzerinden veya Content için düzenleme iznine sahip bir API hesabı aracılığıyla bağlandığında ChatLab, widget'ı sizin yerinize ekler. Bunu Storefront > Script Manager (Vitrin > Komut Dosyası Yöneticisi) altında ChatLab chatbot adıyla görebilirsiniz. Tüm vitrin sayfalarının altbilgisine (footer), Functional (İşlevsel) onay kategorisinde yerleştirilir ve mağaza bağlantısını kestiğinizde kaldırılır.

API hesabı Content erişimi olmadan oluşturulduysa, ya bu erişime sahip yeni bir API hesabı oluşturup tekrar bağlanın ya da widget'ı kendiniz ekleyin:

  1. ChatLab'de chatbotunuzu açın, Test & Deploy (Test Et ve Dağıt) bölümüne gidin, BigCommerce'i seçin ve kodu kopyalayın.
  2. BigCommerce kontrol panelinizde Storefront > Script Manager bölümüne gidin.
  3. Create a Script (Komut Dosyası Oluştur) butonuna tıklayın ve örneğin ChatLab gibi bir isim verin.
  4. Placement ayarını Footer, Location ayarını Storefront pages ve Script category ayarını Functional olarak belirleyin.
  5. Script type olarak Script seçeneğini seçin ve kodu Script contents alanına yapıştırın.
  6. Save butonuna tıklayın ve vitrininizi yenileyin. Chatbot her sayfanın alt köşesinde görünür.

Sorun giderme

  • "Failed to connect to the BigCommerce store. Check the store hash and the access token." - Belirteç eksik kopyalanmış, API hesabı silinmiş veya mağaza kodu farklı bir mağazaya ait. API hesabı oluşturulurken BigCommerce'in indirdiği dosyadan her iki değeri de tekrar kopyalayın.
  • Sohbet widget'ı otomatik olarak eklenmedi - API hesabının Content için düzenleme izni yoktur. Bu erişime sahip yeni bir API hesabı oluşturup tekrar bağlanın veya widget'ı yukarıda açıklandığı gibi Script Manager'a ekleyin.
  • Chatbot vitrinde görünmüyor - Komut dosyasının Storefront > Script Manager altında listelendiğini doğrulayın. Mağazanız bir çerez onay başlığı kullanıyorsa widget, ziyaretçi Functional kategorisini kabul ettikten sonra yüklenir.
  • Chatbot hiçbir ürün bulamıyor - Training > E-commerce catalog altındaki dizine ekleme durumunu kontrol edin ve ürünlerin mağazanızda görünür olduğundan emin olun.
  • Sipariş bulunamıyor - Chatbot, ödeme sırasında kullanılan e-posta adresine ve onay e-postasında gösterilen sipariş numarasına birlikte ihtiyaç duyar.
  • Sepete ekle butonu ürün sayfasını açıyor - Ürünün metin alanı gibi sohbette seçilemeyen zorunlu bir seçeneği vardır veya chatbot BigCommerce vitrininizin dışında çalışmaktadır.