Kontak Listeleri ve CSV İçe Aktarma
Elindeki 500 kişilik Excel listesini kampanyaya sokmak için kişileri tek tek girmene gerek yok. Bir CSV yükle; Purvisor sütunları otomatik tanır, telefonları doğrular, aynı numarayı iki kez eklemez ve istersen kişileri doğrudan bir kampanyaya bağlar. Tek seferde 10.000 kişiye kadar. Aramaların gecikmeden başlaması için listeyi doğru hazırlamak, dönüşümün ilk adımıdır.
Nasıl çalışır?
CSV hazırla (tek zorunlu sütun: Telefon)
↓ (Kontaklar → İçe Aktar · ya da kampanyaya bağlı içe aktarma)
Purvisor başlıkları otomatik tanır (TR + EN sütun adları)
↓
Her satır doğrulanır → telefon 7–15 hane · geçersiz/boş satır atlanır
↓
Mükerrer temizliği → aynı hesapta son 10 hanesi eşleşen kişi tekrar açılmaz
↓
Yeni kişiler oluşturulur (durum: new) + (varsa) kampanyaya eklenir
↓
Özet döner: kaç eklendi · kaç atlandı · kaç kampanyaya bağlandıKontakları kampanyaya eklemenin yolları
Purvisor’da bir kampanya, aranacak kontak listesi üzerinde çalışır. Kişileri şu yollarla eklersin:
| Yöntem | Ne zaman? |
|---|---|
| Tek tek ekleme | Elde birkaç kişi varsa; hızlı manuel giriş. |
| CSV içe aktarma | Elinde hazır bir liste (Excel, CRM dışa aktarımı, form çıktısı) varsa — bu sayfanın odağı. |
| Mevcut kontakları seçme | Zaten Purvisor’da kayıtlı kişileri kampanya oluştururken seçip bağlarsın. |
CSV’yi bir kampanya seçili şekilde içe aktarırsan, hem yeni hem de mükerrer (zaten kayıtlı) kişiler o kampanyaya bağlanır — kimse listede eksik kalmaz.
CSV dosyanı hazırla
İlk satır başlık satırı olmalı. Purvisor başlıkları küçük/büyük harf farkı gözetmeden tanır; hem Türkçe hem İngilizce adları anlar. Tek şart: bir telefon sütunu bulunması.
Örnek CSV:
Ad,Soyad,Telefon,E-posta,Şirket,Ünvan,Notlar
Ayşe,Yılmaz,+90 532 111 22 33,ayse@ornek.com,Örnek A.Ş.,Satın Alma,Web formundan geldi
Mehmet,Demir,05426183835,mehmet@ornek.com,Demir Ltd.,Kurucu,İlk aramada meşguldü
Zeynep,Kaya,5321114455,,,,Fuar standındanTelefonu farklı biçimlerde yazabilirsin:
+90 532 111 22 33,05321112233ve5321112233aynı kişi sayılır (bkz. mükerrer temizliği).
Ayrı Ad ve Soyad sütunun yoksa, tek bir “Ad Soyad” sütunu da yeterli — Purvisor onu ilk boşluktan bölerek ada ve soyada ayırır.
Sütun eşleştirme
| Alan | Tanınan başlıklar | Zorunlu |
|---|---|---|
| Ad | ad, isim, first_name, firstname, name | Hayır — boşsa “İsimsiz” yazılır |
| Soyad | soyad, soyisim, last_name, lastname | Hayır |
| Telefon | telefon, phone, phone_number, tel, gsm, cep | Evet |
| E-posta | e-posta, eposta, email, mail | Hayır |
| Şirket | şirket, sirket, company, firma | Hayır |
| Ünvan | ünvan, unvan, title, pozisyon | Hayır |
| Notlar | notlar, not, notes, açıklama | Hayır |
| Ad Soyad (birleşik) | ad soyad, tam ad, full_name, fullname | Ayrı Ad/Soyad yoksa buradan bölünür |
Telefon sütunu bulunamazsa içe aktarma hiç başlamaz ve şu hata döner: “CSV’de telefon sütunu bulunamadı. Sütun adı ‘Telefon’, ‘Phone’ veya ‘GSM’ olmalıdır.” Önce başlık satırını kontrol et.
İçe aktarma adımları
Listeyi CSV olarak dışa aktar
Excel veya Google Sheets’te Farklı Kaydet → CSV (virgülle ayrılmış) seç. Türkçe karakter sorununu önlemek için mümkünse UTF-8 kodlamasını tercih et. (Purvisor dosya başındaki görünmez BOM işaretini otomatik temizler.)
Kontaklar sayfasında İçe Aktar’a tıkla
Panelde Kontaklar → İçe Aktar ile dosyanı yükle. Kişileri aynı anda bir kampanyaya bağlamak istersen, kampanyayı içe aktarma sırasında seçebilirsin.
📸 [Ekran görüntüsü: Kontaklar sayfası — “İçe Aktar” ekranı, dosya seçimi + (opsiyonel) kampanya seçimi]
Özeti oku
İçe aktarma bitince bir özet dönersin:
{
"success": true,
"imported": 87,
"skipped": 12,
"linked": 99,
"total": 99,
"errors": ["Satır 5: Geçersiz telefon numarası (123)"]
}Alanların anlamı: imported = yeni oluşturulan kişi, skipped = mükerrer olduğu için atlanan, linked = kampanyaya bağlanan (yeni + mevcut), total = dosyadaki geçerli satır, errors = ilk 10 hatalı satır (varsa). Hatalı satırlar atlanır; tek bir bozuk satır tüm içe aktarmayı durdurmaz.
Sınırlar
| Sınır | Değer |
|---|---|
| Dosya biçimi | .csv veya .txt (CSV içerikli metin) |
| En büyük dosya boyutu | 10 MB — aşan dosyalar reddedilir |
| Tek içe aktarımda satır | En fazla 10.000 veri satırı (başlık hariç) |
| Plan kişi kotası | Ücretsiz planda hesap başına toplam 50.000 kişi; ücretli planlarda sınırsız |
| Zorunlu sütun | Telefon |
| Geçerli telefon | 7–15 rakam; yalnızca rakam, +, parantez, tire ve boşluk |
| Mükerrer kontrolü | Son 10 haneye göre, yalnız aynı hesap içinde |
Kişi kotası içe aktarma başlamadan önce kontrol edilir: dosyadaki satır sayısı mevcut kişi sayına eklenip plan limitiyle karşılaştırılır. Limit aşılıyorsa dosyanın tamamı 403 quota_exceeded ile reddedilir ve hiçbir kayıt yazılmaz — yarısı yazılıp yarısı reddedilen bir içe aktarma oluşmaz. Sayım dosyadaki tüm veri satırlarını kapsar; mükerrer ve geçersiz satırlar da bu peşin sayıma dahildir. Bu kontrol 10.000 satır sınırından önce çalıştığı için, kotayı aşan çok büyük bir dosyada satır-sınırı hatasını değil kota hatasını görürsün.
Mükerrer temizliği neden son 10 hane? Türk numaralarında ülke kodu (90) ve baştaki 0 atıldığında kalan 10 hane kişiyi benzersiz belirler. Böylece +90…, 0… ve yalın biçim aynı kişi sayılır. Kontrol her zaman hesap bazlıdır — aynı numara başka bir Purvisor hesabında ayrı bir müşteri olabilir, birbirine karışmaz.
10.000’den fazla kişin mi var? Listeyi parçalara bölüp birden çok dosyayla aktar; mükerrer temizliği sayesinde parçalar çakışsa bile kimse iki kez eklenmez. Yalnız şunu bil: kota kontrolü mükerrer temizliğinden önce ve ham satır sayısıyla yapılır — çakışan bir parçayı yeniden yüklemek tek kişi eklemese bile kotada satır sayısı kadar boş yer ister. Bu yüzden parçaları gereksiz yere üst üste yükleme.
Toplu işlemler
Kontakları içe aktardıktan sonra listede birden çok kişiyi seçip toplu işlem yapabilirsin.
- Toplu güncelleme — Seçili kişilerin şu alanlarını tek hamlede değiştir: durum (
new,contacted,qualified,proposal,negotiation,closed), pipeline aşaması, ısı (hot/warm/cold) ve öncelik (0–10). Tek seferde en fazla 100 kişi güncellenebilir. - Toplu silme — Seçili kişileri listeden kaldırır. Bu bir yumuşak silmedir: kayıt arşivlenir (arama geçmişi korunur), kalıcı olarak silinmez. Kalıcı silme (KVKK) ayrı bir akıştır — bkz. KVKK ve Veri Yönetimi.
Ayrıntı ve ekran akışı için: Toplu İşlemler.
KVKK ve rıza listeleri
Bir listeyi içe aktarıp aramak, o kişileri aramak için hukuki dayanağın olduğu anlamına gelir. Yalnızca açık rıza vermiş ya da meşru bir ilişkin olan kişileri yükle. Satın alınmış veya kazınmış (scraped) listeler KVKK ve İYS (İleti Yönetim Sistemi) açısından risklidir.
- Rızayı belgele — Numaranın nereden geldiğini (form, sözleşme, etkinlik) CSV’nin Notlar sütununda taşı; ileride kanıt niteliği taşır.
- Aranmak istemeyeni dışla — Bir kişi görüşmede “beni aramayın” derse asistan onu otomatik olarak
doNotCallişaretler ve tüm kampanyalardan çıkarır. Bu kişileri tekrar içe aktarma. - Kim olduğunu söylet — Asistanın açılışında firma adını ve arama nedenini net belirtsin (bkz. Prompt Yazma Rehberi).
Sorun giderme
| Belirti | Olası neden / çözüm |
|---|---|
| ”Telefon sütunu bulunamadı” | Başlıktaki telefon sütunu tanınmıyor → adını Telefon, Phone veya GSM yap. |
Çok sayıda satır atlandı (skipped yüksek) | Kişiler zaten kayıtlı (mükerrer) → normaldir; linked sayısına bak, kampanyaya yine de bağlanmışlardır. |
| ”Geçersiz telefon numarası” hataları | Numarada harf/simge var ya da 7 rakamdan az → sütunu temizle, dahili uzantıları çıkar. |
| ”Dosya boyutu 10 MB sınırını aşıyor” | Dosya çok büyük → gereksiz sütunları sil veya listeyi böl. |
| ”Tek seferde en fazla 10000 kayıt…“ | 10.000’den fazla satır → dosyayı parçalara ayır. |
”kişi limitine ulaştınız…” (quota_exceeded, HTTP 403) | Mevcut kişi sayın + dosyadaki satır sayısı plan kotanı aşıyor → kullanılmayan kişileri sil, dosyayı küçült ya da planını yükselt (Planlar). Hiçbir satır yazılmadığı için düzeltip yeniden yükleyebilirsin. |
| Türkçe karakterler bozuk göründü | CSV UTF-8 değil → Excel’de “CSV UTF-8” olarak yeniden kaydet. |
| İçe aktardım ama kampanyada görünmüyor | İçe aktarırken kampanya seçilmemiş → kampanyayı seçerek tekrar aktar (mükerrerler yeniden açılmaz, yalnız bağlanır). |