CSV URL Entegrasyonu

Belgeleri, AI asistanınızın bilgi tabanına URL üzerinden doğrudan herkese açık CSV dosyalarından 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"ye tıklayın ve durumu izleyin

İpucu: Süreci daha iyi 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 içe aktarma
• ✅ CSV yapısını otomatik olarak algılama (SSS, Ürün veya Genel)
• ✅ Kategorileri atama ve özel sütunları eşleme
• ✅ İçe aktarma durumunu ve geçmişini takip etme

---

Ön Koşullar

• AI SmartTalk asistanınıza yönetici erişimi
• Kamuya açık CSV dosyaları (kimlik doğrulama gerektirmeyen)
• 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 alanı: Destek belgeleri, bilgi tabanları

Gerekli sütunlar:

• question
• answer

Örnek:

question,answer
"Şifremi nasıl sıfırlarım?","'Şifremi Unuttum'a' 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 alanı: E-ticaret katalogları, envanter

Gerekli sütun:

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

İsteğe bağlı:

• 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 alanı: Genel içerik, karışık veri

• 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 seçeneğine tıklayın

Adım 2: CSV URL Ekle

Tekil URL:

1. Yeni CSV URL Ekle butonuna 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 butonuna tıklayın

Toplu İçe Aktarma:

1. Toplu URL İçe Aktar butonuna tıklayın
2. URL'leri girin (her biri bir satıra)
3. Paylaşılan ayarları yapılandırın
4. Tüm URL'leri İçe Aktar butonuna 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 (detayları görüntüleyin)

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

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

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

1. Bilgi Tabanı'nda yeni belgeleri kontrol edin
2. İçe aktarılan içerikle ilgili sorularla chatbot'u 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 gerekli)
❌ 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şilemiyor	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 kodlamasını 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
• İthalattan önce verileri temizleyin (boş satırları kaldırın)
• Dosyaları 10MB altında tutun

Performans

• Öncelikle küçük örneklerle test edin
• Büyük ithalatları yoğun saatler dışında işleyin
• Birden fazla ilgili URL için toplu ithalat kullanın
• İthalat 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

---

İthalattan Sonra

İthalat tamamlandıktan sonra verileriniz:

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

İthalatınızı doğrulayın:

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

---

Destek

Yardım mı gerekiyor?

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

---

Özet

Artık:

• ✅ Kamu URL'lerinden CSV verisi ithal edebilirsiniz
• ✅ SSS, Ürün ve genel veri türlerini işleyebilirsiniz
• ✅ Birden fazla kaynağı toplu olarak ithal edebilirsiniz
• ✅ Ürünler için özel sütunları eşleyebilirsiniz
• ✅ İthalatları izleyip yönetebilirsiniz
• ✅ Verileri yeniden ithalat yoluyla güncelleyebilirsiniz

Sonraki adımlar:

1. Örnek bir CSV ile test edin
2. Üretim verilerinizi ithal edin
3. Kategorileri ayarlayın
4. Düzenli yeniden ithalatlar planlayın
5. Performansı izleyin

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