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şleştirin. 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, özel alanlarınızdan herhangi biri 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.
    • Başlığı özel alanlarınızdan birinin adı olan bir sütun, otomatik olarak o alanla eşleştirilir. Büyük harf ve aksanlar önemli değildir, bu nedenle bir CPF sütunu, cpf adlı bir alanı bulur. Ayrıca herhangi bir sütun için istediğiniz özel alanı manuel olarak da seçebilirsiniz.
    • Henüz özel alanlarınızdan biri olmayan bir sütun, yeni bir alan haline gelebilir: seçicisinden Yeni özel alan: seçeneğini belirleyin; içe aktarma sırasında alan oluşturulacaktır.
    • Bir özel alanın bir türü varsa (Sayı, Onay Kutusu, Açılır Liste) ve sütundaki bazı değerler buna uymuyorsa, sihirbaz içe aktarma işleminden önce kaç satırın bundan etkileneceği konusunda sizi uyarır. Bu satırlar, ad ve e-posta dahil olmak üzere tamamen atlanır. Alanın türünü tek adımda değiştirmek için uyarı üzerindeki öğesini Metin olarak değiştir seçeneğine tıklayın, değerleri düzeltin veya sütunu İçe aktarma olarak ayarlayın.
    • Bir telefon numarası sütunu zorunludur — birini eşleştirmeden devam edemezsiniz.
    • Etiketler ile eşleştirilen 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. Seçim yapın:
    • Varsayılan kanal — WhatsApp Business, WhatsApp Web veya SMS. Bu, henüz bir kanal belirtilmemiş 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. Kişiler sayfası listelerinizden birini gösterirken içe aktarma işlemini açarsanız, o liste sizin için zaten seçilmiş olur; istemiyorsanız temizleyin.
    • Mevcut kişileri güncelle — varsayılan olarak kapalıdır. Kapalıyken, zaten sahip olduğunuz bir kişiyle eşleşen satırlar (aynı telefon numarası) kopya olarak atlanır: o kişide hiçbir şey değişmez, ancak bir liste seçtiyseniz zaten sahip olduğunuz kişi yine de o listeye eklenir. Açıkken, bu satırlar kişiyi günceller: dosyanızdaki ad, e-posta ve notlar mevcut olanların üzerine yazılır (boş hücreler mevcut değeri değiştirmez), satırdaki tüm etiketler eklenir ve kişi seçtiğiniz listeye eklenir. Zaten 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, (bu seçenek açık olduğunda) kaç mevcut kişinin güncellendiğini, halihazırda sahip olduğunuz kaç kişinin seçtiğiniz listeye eklendiğini ve eğer atlanan satırlar varsa bunların nedenlerini (geçersiz telefon numarası, eksik telefon numarası, kopya, kişi sınırına ulaşıldı vb.) gösteren bir sonuç ekranına yönlendirileceksiniz. Mevcut kişileri güncelle seçeneği kapalıysa ve bazı satırlar halihazırda sahip olduğunuz kişilerle eşleşiyorsa, sonuç ekranı bunu belirtir ve Bu kişileri güncelle seçeneğini sunar: tek bir tıklama ile sadece ilgili satırlar anahtar açık şekilde yeniden gönderilir, böylece dosyayı tekrar içe aktarmanıza gerek kalmaz.

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

  • Telefon, zorunlu olan tek sütundur. Hiç telefon numarası içermeyen satırlar içe aktarma öncesinde elenir 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 var olanları kullanır) ve bunları kişiye uygular; bunlar, filtreleme yaptığınız, yayınları hedeflediğiniz ve webhook’ları tetiklediğiniz etiketlerle aynıdır. Bir hücreye virgül veya noktalı virgül ile ayrılmış birden fazla etiket ekleyin. 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 tekrar içe aktarın; böylece etiketler düzgün bir şekilde uygulanacaktır (geriye kalan tags özel alanının bir zararı yoktur; her kişiden temizlenmesini isterseniz destek ekibine mesaj gönderebilirsiniz).
  • Özel alanlar — özel alanlarınızın her biri kendi hedefidir. Bir alanın adıyla eşleşen başlık sizin için seçilir; değer, dosyada olduğu gibi kişi üzerinde kaydedilir (Sayı, Tarih, Onay Kutusu veya Açılır Liste alanı, 19,99, 01/02/1990 veya yes gibi tanınabilir biçimleri dönüştürür). Bir sütundan alan oluşturmak için Yeni özel alan seçeneğini belirleyin. Mevcut kişileri güncelle seçeneği açıkken, dosyadaki özel alan değerleri mevcut kişilerinizi de günceller; boş hücreler ise mevcut değeri olduğu gibi bırakır.
  • Noktalar, tireler veya başında sıfır bulunan tanımlayıcıları (CPF, vergi numarası, posta kodu) tutan bir sütun, Metin alanına aittir. Sayı alanında bu değerler uyum sağlamaz ve satır atlanır.

İpuçları

  • Telefon numaralarının ülke kodunu içerdiğinden emin olun. Aksi takdirde mesajlar iletilmeyecektir 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ız tarafından sınırlandırılır. Bir içe aktarma işlemi sizi planınızın sınırının ü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; sonuç ekranında duplicate olarak görünür. İçe aktarma işlemi asla bir kişinin ikinci bir kopyasını oluşturmaz. Bir liste seçmek bu satırlarda yine de işe yarar: zaten sahip olduğunuz kişi listeye eklenir ve sonuç ekranında ayrı olarak sayılır, bu nedenle aynı dosyayı yeniden içe aktarmak, hesabınızda zaten bulunan kişilerle bir listeyi doldurmanın yoludur. Ayrıca alanlarını yenilemek (adları veya e-postaları düzeltmek, etiketler eklemek) 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 custom_company sütunu var — doğru şekilde eşleşir mi? Kendi başına hayır, çünkü başlık tam olarak company değil. O sütunun seçicisinden Özel alan: company seçeneğini belirleyin; böylece company alanına içe aktarılır. Yüklemeden önce başlığı company olarak yeniden adlandırmak, sihirbazın sizin için eşleştirme yapmasını sağlar.

Bazı satırlar “Bir özel alan değeri, o alanın türüne uymuyor” hatasıyla atlandı — neden? Sütun, türü belirlenmiş bir özel alanla (örneğin Sayı) eşleştirilmiştir ve bu satırlar, Sayı alanında 001.576.401-08 gibi başka bir değer içermektedir. Sütunları eşleştirme adımındaki uyarıda öğesini Metin olarak değiştir seçeneğine tıklayın (veya Özel alanlar altından türü değiştirin) ve Mevcut kişileri güncelle seçeneği açıkken dosyayı tekrar içe aktarın.

“Ş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