Bir Google E-Tablosu’nu Yapay Zeka Asistanı ile Sorgulama

Aşağıdaki talimatlar yalnızca masaüstü ve dizüstü bilgisayarlar için geçerlidir.

Google E-Tablolar’ı Yapay Zeka Asistanı’na bağlayarak, YZ Temsilcinizin gerçek zamanlı tablo verilerini sohbetlere çekmesini sağlayabilirsiniz.
Bu özellik sayesinde envanter sorgulayabilir, rezervasyonları onaylayabilir, sipariş bilgilerini bulabilir veya müşteri kayıtlarını getirebilirsiniz, tüm bunları sohbet penceresinden ayrılmadan yapabilirsiniz.

Başlamadan önce

Şunlara sahip olduğunuzdan emin olun:

• Aktif ve ücretli bir Yapay Zeka Asistanı planı: Büyüme (Growth), İşletme (Business) veya Kurumsal (Enterprise).

• Kullanmak istediğiniz tabloya erişimi olan bir Google hesabı.

• Google Apps Script ve OpenAPI/YAML konusunda temel kodlama bilgisi.
  Kodlama konusunda deneyiminiz yoksa bir geliştiriciden yardım almanızı öneririz.
  Daha fazla bilgi için geliştirici portalını ziyaret edin.

Tablonuzu düzenli hale getirmek ve güvenilir sonuçlar almak için şu ipuçlarını izleyin:

• Açıklayıcı sütun adları içeren net bir başlık satırı kullanın.

• Doğrudan sorgulamalar için benzersiz bir kimlik sütunu ekleyin (örnek: SKU, Sipariş ID’si veya E-posta).

• Her sütunda yalnızca tek bir veri türü kullanın. Örneğin, tarihleri bir sütunda, sayıları başka bir sütunda tutun.

• Birleştirilmiş hücreler veya gizli sütunlardan kaçının. Verilerinizi tablo formatında tutarak erişilebilirliği artırın.

Google E-Tablonuz sipariş detaylarını, ürün açıklamalarını veya genel bilgileri içerebilir.

Örneğin:

Verileriniz bir dosyada bulunuyorsa, bunu kolayca Google E-Tablolar’a aktarabilirsiniz:

1. Google E-Tablolar’ı açın ve Dosya > İçe aktar’a tıklayın.

2. Yükle sekmesini seçin ve dosyanızı seçin veya pencereye sürükleyin.

3. Dosyayı nasıl içe aktarmak istediğinizi seçin:

   • Yeni bir elektronik tablo oluştur (önerilir)

   • Mevcut tabloya yeni sayfa ekle

   • Tabloyu değiştir veya sayfayı değiştir (dikkatli kullanın)

4. Verileri içe aktar’a tıklayın ve başlık satırı ile sütun türlerini doğrulayın.

Desteklenen dosya türleri: .xlsx, .xls, .csv, .tsv, .ods

1. Google E-Tablonuzda Uzantılar > Apps Script’e gidin.

2.Yeni sekmede Apps Script konsolu açılacaktır.
Burada, tablonuzu sorgulamak için kullanılacak yöntemleri tanımlayan bir Code.gs betiği girin.

Başlamak için GitHub’daki örnek Code.gs betiğini kullanabilirsiniz.
Bu örnek, belirli bir sütunda (örneğin SKU) arama yapar ve temel bir başlangıç noktasıdır. Betiği kendi verinize ve arama kurallarınıza göre düzenleyin. Özelleştirme hakkında daha fazla bilgi için buraya tıklayın.

3.Yayınla > Yeni yayın’a tıklayın.

4.Tür seç kısmındaki dişli simgesine tıklayın ve Web uygulaması’nı seçin.

5.Açıklama girin. Çalıştıran kısmını Ben olarak ayarlayın. Bu, betiğin tabloya erişmesini sağlar.

6.Web Uygulaması URL’sini kopyalayın ve saklayın. Bu adres, API tanımlarında kullanılacaktır.

Yapay Zeka Asistanı’nın web uygulamanızı çağırabilmesi için bir OpenAPI (YAML veya JSON) dosyasına ihtiyacı vardır.

Aşağıdaki örnekteki tanımı kopyalayabilirsiniz. Ancak şu değişiklikleri yapmanız gerekir:

• servers.urls değerini yukarıda Apps Script’ten kopyaladığınız Web Uygulaması URL’siyle değiştirin.

• URL’nin sonundaki /exec kısmını kaldırın.

• Parametreleri kendi verilerinize göre düzenleyin.
  Özelleştirme hakkında daha fazla bilgi için buraya tıklayın.

Swagger Editor gibi bir doğrulayıcı kullanarak YAML/JSON dosyanızı kontrol edin.

Ham dosya bağlantısını kopyalayın — bu bağlantıyı sonraki adımda kullanacaksınız.

Not: “title” alanı, tawk.to kontrol panelinizde entegrasyon adı olarak görünecektir.

Örnek:

Bu şekilde kontrol panelinizde görüntülenecektir:

Eğer birden fazla API entegrasyonunuz varsa, her birine açıklayıcı bir isim verin.

Not: Bu entegrasyonu gerçekleştirmek için ücretli bir Yapay Zeka Asistanı planına ihtiyacınız vardır.

1. tawk.to hesabınıza giriş yapın.

2. Doğru varlığı (property) seçin.

3. Üst menüden Eklentiler (Add-ons)’a tıklayın.

4. Yapay Zeka Asistanı bölümünde Ayarlar (Settings)’a tıklayın.

5. YZ Temsilcinizi seçin.

6. Entegrasyon / API sekmesini açın.

7. Araçlar (Tools) altında + Ekle’ye tıklayın.

8. API altında Add tool seçeneğine tıklayın.

9. Şema Dosyası URL’si (Schema File URL) alanına OpenAPI dosyanızın URL’sini girin.

10. API Base URL alanını boş bırakın.

11. Kimlik Doğrulama Yöntemi (Authentication method) seçeneğini No Auth olarak ayarlayın.

12. Kaydet (Save)’e tıklayın.

Sağ taraftaki sohbet aracı önizlemesini kullanarak entegrasyonu test edin.

• tawk.to kontrol panelindeki önizleme aracında yaygın ve uç senaryoları test edin.

• Apps Script içinde Logger.log() kullanın ve Yürütmeler (Executions) sayfasında hataları kontrol edin.

• OpenAPI şemanızın JSON çıktısıyla uyumlu olduğundan emin olun.

• Yanıtlar yavaşsa sık kullanılan sonuçları önbelleğe alın.

• Aynı alan adları ve veri türleriyle tutarlı yanıtlar sağlayın, böylece Yapay Zeka Asistanı bunları güvenilir biçimde yorumlayabilir.

• Hassas verileri işlerken dikkatli olun.
  Yapay Zeka Asistanı’nın yalnızca gerekli alanlara erişmesini sağlayın.

• Kullanımı izleyin ve olağan dışı etkinliklere karşı önlem alın.

Google Apps Script kotalarını göz önünde bulundurun ve hatalar veya gecikmeler için yeniden deneme mantığı tasarlayın.

Kişisel verileri döndürürken GDPR ve diğer geçerli gizlilik yasalarına uyun.

OpenAPI tanımınızı değiştirdiğinizde, sürümü artırın veya başlığı güncelleyin.
Bu, entegrasyonların açık ve düzenli kalmasını sağlar.

Geri bildiriminiz mi var veya daha fazla yardıma mı ihtiyacınız var:

• Canlı sohbet için yeşil sohbet simgesine tıklayın.
  
• Bizimle bir görüşme planlayın.
  
• Topluluk sayfamızı ziyaret edin.