Your AI Connector Docs

Dosyadan Kişi İçe Aktarma

Eğer bir elektronik tabloda kişi listeniz varsa, bunları tek tek eklemek yerine hepsini aynı anda yükleyebilirsiniz. Uygulama, önceden bir şablon indirmenize gerek kalmadan, elinizdeki CSV dosyasıyla çalışan 3 adımlı bir sihirbaz kullanır: Yükle → Sütunları eşle → Gözden geçir.

Kişiler Nasıl İçe Aktarılır

  1. Sol kenar çubuğunda Kişiler’e tıklayın, ardından sayfanın üst kısmındaki İçe Aktar’a tıklayın.
  2. Yükle. CSV dosyanızı sürükleyip bırakma alanına sürükleyin veya göz atmak için tıklayın. Önce indirmeniz gereken bir şablon yoktur; elinizdeki dosyayı doğrudan kullanabilirsiniz.
  1. Sütunları eşleyin. Sihirbaz, dosyanızın başlık satırını okur ve her sütunu bir hedef alanla otomatik olarak eşleştirmeye çalışır: Ad, Soyad, Telefon, E-posta, Etiketler, Notlar veya İçe aktarma. Her sütun için yapılan tahmini kontrol edin ve yanlış olanları yanındaki seçiciyi kullanarak düzeltin. Bir önizleme tablosu, ilk birkaç satırın tam olarak nasıl içe aktarılacağını gösterir.
    • Bir telefon numarası sütunu zorunludur — bunu eşleştirmeden devam edemezsiniz.
    • Etiketler ile eşlenen bir sütun, her kişi üzerinde gerçek etiketlere dönüşür. Bir hücrede birden fazla etiket olması sorun değildir; bunları virgül veya noktalı virgül (vip; newsletter; hotmart) ile ayırın. Henüz var olmayan etiketler sizin için oluşturulur; halihazırda var olan etiketler ise büyük/küçük harf duyarlılığı dikkate alınmadan yeniden kullanılır.
  1. Gözden Geçir. Şunları seçin:
    • Varsayılan kanal — WhatsApp Business, WhatsApp Web veya SMS. Bu, halihazırda bir kanal belirtmemiş olan tüm içe aktarılan kişiler için geçerlidir.
    • Liste — açılır menüden mevcut bir listeyi seçin veya anında yeni bir liste oluşturmak için bir ad yazın. Sadece birini yapabilirsiniz, ikisini birden değil.
    • Mevcut kişileri güncelle — varsayılan olarak kapalıdır. Kapalıyken, halihazırda sahip olduğunuz bir kişiyle eşleşen satırlar (aynı telefon numarası) kopya olarak kabul edilip atlanır: o kişi üzerinde hiçbir şey değişmez ve kişi listeye eklenmez. Açıkken, bu satırlar kişiyi günceller: dosyanızdaki ad, e-posta ve notlar mevcut verilerin üzerine yazılır (boş hücreler mevcut değeri korur), satırdaki tüm etiketler eklenir ve kişi seçtiğiniz listeye eklenir. Halihazırda sahip olduğunuz kişileri düzeltmek veya zenginleştirmek için bir dosyayı bu şekilde yeniden içe aktarırsınız.
  1. [count] öğesini içe aktar düğmesine tıklayın. Kaç kişinin oluşturulduğunu, kaç mevcut kişinin güncellendiğini (bu seçenek açık olduğunda) ve eğer atlanan satırlar varsa bunların nedenini (geçersiz telefon numarası, eksik telefon numarası, kopya, kişi limitine ulaşıldı vb.) gösteren bir sonuç ekranına yönlendirileceksiniz.

Sütun Eşleme Ayrıntıları

  • Telefon zorunlu olan tek sütundur. Hiç telefon numarası içermeyen satırlar içe aktarma öncesinde atılır ve sonuç ekranında ayrı olarak sayılır.
  • Ad / Soyad / E-posta doğrudan kişinin temel alanlarıyla eşleşir.
  • Notlar, kişinin Notlar / Müşteri Profili alanıyla eşleşir.
  • Etiketler, gerçek etiketler oluşturur (veya yeniden kullanır) ve bunları kişiye uygular; bunlar filtreleme yaptığınız, yayınları hedeflediğiniz ve webhook’ları tetiklediğiniz etiketlerin aynısıdır. Bir hücreye virgül veya noktalı virgül ile ayrılmış birkaç etiket koyun. 19 Ağustos 2026’dan önce bu sütun tags adlı bir özel alan olarak kaydediliyordu; eğer o tarihten önce içe aktarma yaptıysanız, aynı dosyayı Mevcut kişileri güncelle seçeneği açıkken yeniden içe aktarın; böylece etiketler düzgün bir şekilde uygulanacaktır (kalan tags özel alanının bir zararı yoktur; her kişiden temizlenmesini isterseniz destek ekibine mesaj gönderin).
  • Şu anda isteğe bağlı özel alanlar için (klasik custom_<fieldname> sütunları gibi) bir sütun eşlemesi bulunmamaktadır; mevcut geçici çözüm için Özel Alanları Toplu Yükleme bölümüne bakın.

İpuçları

  • Telefon numaralarının ülke kodunu içerdiğinden emin olun. Ülke kodu olmazsa mesajlar iletilmez ve kullanılabilir bir telefon numarası olmayan satırlar tamamen atlanır.
  • Telefon numaralarındaki boşlukları, tireleri veya parantezleri kaldırmanıza gerek yoktur; içe aktarıcı yaygın biçimlendirmeleri tolere eder ancak yine de ülke koduna ihtiyaç duyar.
  • Dosyalar tamamen tarayıcınızda ayrıştırılır, bu nedenle sihirbazın kendisinde sabit bir yükleme boyutu sınırı yoktur; ancak toplam kişi sayınız yine de planınızla sınırlıdır. Bir içe aktarma işlemi sizi planınızın limitinin üzerine çıkaracaksa, bu satırlar reddedilir ve sonuç ekranında contact_limit_reached olarak görünür.
  • Aynı telefon numarasına sahip bir kişi zaten mevcutsa, bu satır varsayılan olarak atlanır ve sonuç ekranında duplicate olarak görünür. İçe aktarma işlemi asla bir kişinin ikinci bir kopyasını oluşturmaz. Halihazırda sahip olduğunuz kişileri toplu olarak düzenlemek (adları veya e-postaları düzeltmek, etiket eklemek, listeye koymak) için Gözden Geçir adımında Mevcut kişileri güncelle seçeneğini açın ve dosyayı yeniden içe aktarın.

Sıkça Sorulan Sorular

CSV dosyamda eski bir dışa aktarmadan kalma bir custom_company sütunu var — doğru şekilde eşleşir mi? Otomatik olarak hayır. Sihirbazın otomatik eşleştiricisi yalnızca ad/telefon/e-posta/etiketler/notlar başlıklarını tanır; diğer her şey varsayılan olarak İçe aktarma seçeneğine ayarlanır, bu nedenle bir custom_company sütunu company özel alanını kendi başına doldurmaz. Değerleri daha sonra Özel Alanlar aracılığıyla veya API üzerinden ekleyin.

“Şablonu İndir” düğmesi nereye gitti? Kaldırıldı; sihirbaz elinizdeki herhangi bir CSV dosyasıyla doğrudan çalışır ve Eşleme adımında eşleşmeyen sütunları düzeltmenize olanak tanır.

Kişilerimi zaten içe aktardım; hepsine aynı anda nasıl etiket ekleyebilirim veya alanları nasıl düzeltebilirim? Aynı dosyayı (veya güncellenmiş bir sürümünü), Gözden Geçir adımında Mevcut kişileri güncelle seçeneği açıkken yeniden içe aktarın. Mevcut bir telefon numarasıyla eşleşen satırlar, atlanmak yerine o kişiyi (ad, e-posta, notlar, etiketler ve liste) günceller. Eşleştirme için yalnızca telefon numaraları kullanılır, bu yüzden o sütunu olduğu gibi tutun.

Instagram veya Messenger kişilerini bir dosyadan içe aktarabilir miyim? Hayır. İçe aktarma özelliği yalnızca WhatsApp Business, WhatsApp Web ve SMS’i destekler, çünkü bu kanallar insanlara telefon numarası aracılığıyla ulaşır. Instagram ve Messenger ise kişileri sosyal medya hesapları üzerinden tanımlar; bu nedenle bu kişiler, biri size o kanaldan mesaj gönderdiğinde otomatik olarak oluşturulur.

Kişileri bot-aktif değil şeklinde içe aktarabilir miyim? Bunun için satır bazlı bir sütun yoktur. Önce toplu içe aktarmayı yapın, ardından içe aktarılan kişiler üzerinde toplu Bot kapalı eylemini kullanın — Kişileri Yapay Zeka Botundan Hariç Tutma bölümüne bakın.

Sonraki Adımlar