CSV URL Entegrasyonu

Belgeleri, AI asistanınızın bilgi tabanına URL üzerinden kamuya açık CSV dosyalarından doğrudan içe aktarın.

---

Hızlı Başlangıç

3 adımda başlayın:

1. Gezinme: Yönetim → Asistanlarım → [Asistan Adı] → Entegrasyonlar → CSV URL
2. URL Ekle: Kamuya açık CSV URL'nizi girin ve içe aktarma türünü seçin (SSS/Ürün/Varsayılan)
3. İçe Aktar: "URL Ekle" butonuna tıklayın ve durumu izleyin

İpucu: Süreci anlamak için önce küçük bir CSV dosyası ile test edin.

---

Yapabilecekleriniz

• ✅ Kamuya açık HTTP/HTTPS CSV URL'lerinden içe aktarım
• ✅ Birden fazla URL'yi aynı anda toplu olarak içe aktarın
• ✅ CSV yapısını otomatik olarak algılar (SSS, Ürün veya Genel)
• ✅ Kategorileri atayın ve özel sütunları eşleyin
• ✅ İçe aktarma durumunu ve geçmişini takip edin

---

Ön Gereksinimler

• AI SmartTalk asistanınıza yönetici erişimi
• Kamuya açık CSV dosyaları (kimlik doğrulama gerektirmez)
• Sütun başlıkları ile uygun CSV yapısı
• UTF-8 kodlaması önerilir

---

İçe Aktarma Türleri

1. SSS İçe Aktarma

En iyi kullanım: Destek belgeleri, bilgi tabanları

Gerekli sütunlar:

• question
• answer

Örnek:

question,answer
"Şifremi nasıl sıfırlarım?","'Şifremi Unuttum' butonuna tıklayın ve talimatları izleyin."
"Çalışma saatleriniz nedir?","Pazartesi-Cuma, 9:00 - 18:00."

2. Ürün İçe Aktarma

En iyi kullanım: E-ticaret katalogları, envanter

Gerekli sütun:

• idProduct (veya özel eşlenmiş sütun)

Opsiyonel:

• name (veya özel eşlenmiş sütun)

Örnek:

idProduct,name,description,price
"PROD001","Premium Widget","Yüksek kaliteli widget","99.99"
"PROD002","Standard Widget","Temel widget","49.99"

3. Varsayılan İçe Aktarma

En iyi kullanım: Genel içerik, karışık veriler

• SSS veya Ürün yapısını otomatik olarak algılar
• Genel belge içe aktarmaya geri döner
• Çeşitli CSV formatlarını işler

---

Adım Adım Kılavuz

Adım 1: Entegrasyona Erişim

1. AI SmartTalk'a giriş yapın
2. Yönetim → Asistanlarım → [Asistanınız] bölümüne gidin
3. Entegrasyonlar → CSV URL'ye tıklayın

Adım 2: CSV URL Ekleme

Tek URL:

1. Yeni CSV URL Ekle'ye tıklayın
2. CSV dosya URL'sini girin
3. İsteğe bağlı isim verin
4. İçe aktarma türünü seçin (SSS/Ürün/Varsayılan)
5. Kategoriyi seçin (isteğe bağlı)
6. URL Ekle'ye tıklayın

Toplu İçe Aktarma:

1. Toplu URL İçe Aktar'a tıklayın
2. URL'leri girin (her satıra bir tane)
3. Paylaşılan ayarları yapılandırın
4. Tüm URL'leri İçe Aktar'a tıklayın

Adım 3: Sütun Eşleştirmesini Yapılandırma (Sadece Ürün)

CSV sütunlarınızı beklenen alanlara eşleyin:

• ID Ürün Sütunu: Varsayılan idProduct → product_id, sku vb. ile eşleyin
• İsim Sütunu: Varsayılan name → product_name, title vb. ile eşleyin

Adım 4: İçe Aktarmayı İzleme

İçe Aktarma Geçmişi'nde durumu takip edin:

• Beklemede: İşlem için bekliyor
• İçe Aktarıldı: Başarıyla tamamlandı
• Hata: Başarısız (ayrıntıları görüntüleyin)

Adım 5: Yeniden İçe Aktarma (Verileri Güncelleme)

1. Geçmişte URL'yi bulun
2. Yeniden İçe Aktar'a tıklayın
3. İşlemi onaylayın
4. Güncellenmiş durumu izleyin

Adım 6: İçe Aktarmayı Doğrulama

1. Yeni belgeler için Bilgi Tabanını kontrol edin
2. İçe aktarılan içerikle ilgili sorular sorarak sohbet botunu test edin

---

CSV Gereksinimleri

Geçerli URL'ler

✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv

❌ ftp://files.company.com/data.csv (FTP desteklenmiyor)
❌ https://private.site.com/auth-data.csv (Kimlik doğrulama gerekiyor)
❌ file:///local/data.csv (Yerel dosyalar desteklenmiyor)

Dosya Gereksinimleri

• Erişim: HTTP/HTTPS üzerinden herkese açık erişilebilir olmalıdır
• Başlıklar: İlk satır sütun adlarını içermelidir
• Ayrıcılar: Virgül (,) veya noktalı virgül (;)
• Kodlama: UTF-8 önerilir
• Boyut: Dosya başına maksimum 10MB

---

Sorun Giderme

Yaygın Hatalar

Hata	Çözüm
URL Erişilebilir Değil	URL'nin herkese açık ve geçerli olduğunu doğrulayın
Geçersiz Format	Ayrıcı ve başlıkları kontrol edin
Eksik Sütunlar	Gerekli sütunların mevcut olduğundan emin olun (soru/cevap veya idProduct)
Büyük Dosya Zaman Aşımı	Dosyayı bölün veya boyutunu 10MB'ın altına indirin

Çözüm Adımları

1. URL'yi tarayıcıda test edin
2. CSV yapısını ve kodlamayı doğrulayın
3. İçe aktarma geçmişindeki hata mesajlarını gözden geçirin
4. Daha küçük bir örnek dosya ile test edin
5. Sorun devam ederse destekle iletişime geçin

---

En İyi Uygulamalar

URL Yönetimi

• Stabil, kalıcı URL'ler kullanın
• Erişilebilirlik için URL'leri aylık olarak test edin
• Daha iyi performans için CDN kullanın
• Dosya adlarında versiyon ekleyin: products-v2024.csv

Veri Organizasyonu

• Açık kategori adları kullanın
• Tutarlı CSV formatlarını koruyun
• İçe aktarmadan önce verileri temizleyin (boş satırları kaldırın)
• Dosyaları 10MB altında tutun

Performans

• Öncelikle küçük örneklerle test edin
• Büyük içe aktarımları yoğun olmayan saatlerde işleyin
• Birden fazla ilgili URL için toplu içe aktarma kullanın
• İçe aktarma başarı oranını düzenli olarak izleyin

---

Güvenlik

• ✅ HTTPS şifreli transferler
• ✅ URL doğrulama
• ✅ İzin tabanlı erişim kontrolü
• ✅ Geçici dosya işleme (kalıcı depolama yok)
• ✅ Eski verilerin otomatik temizlenmesi
• ✅ Tüm aktiviteler için denetim günlükleri

---

İçe Aktarımdan Sonra

İçe aktarıldıktan sonra verileriniz:

1. Bilgi tabanında aranabilir hale gelir
2. Chatbot yanıtlarını hemen destekler
3. Kategorilere göre düzenli görünür
4. Bilgi Tabanı bölümünde doğrulanabilir

İçe aktarmanızı doğrulayın:

• Yeni belgeler için Bilgi Tabanını kontrol edin
• İçe aktarılan içerikle ilgili sorularla chatbotu test edin
• Kategorileri ve organizasyonu gözden geçirin

---

Destek

Yardıma mı ihtiyacınız var?

• 📧 E-posta: contact@aismarttalk.tech
• 📚 Belgeler: https://docs.aismarttalk.tech/

---

Özet

Artık şunları yapabilirsiniz:

• ✅ Kamuya açık URL'lerden CSV verisi içe aktarın
• ✅ SSS, Ürün ve genel veri türlerini yönetin
• ✅ Birden fazla kaynağı toplu olarak içe aktarın
• ✅ Ürünler için özel sütunları eşleyin
• ✅ İçe aktarımları izleyin ve yönetin
• ✅ Verileri yeniden içe aktararak güncelleyin

Sonraki adımlar:

1. Örnek bir CSV ile test edin
2. Üretim verilerinizi içe aktarın
3. Kategorileri ayarlayın
4. Düzenli yeniden içe aktarma planlayın
5. Performansı izleyin

Sorularınız mı var? Destek ekibimizle istediğiniz zaman iletişime geçin.