--- title: CSV ile Kişileri İçe Aktarın description: Twenty'ye kişileri içe aktarmaya yönelik eksiksiz, adım adım kılavuz. --- ## Genel Bakış Bu kılavuz, kişilerinizi (Kişiler) Twenty'ye içe aktarma sürecinde size yol gösterir. ## Başlamadan Önce ### Ön Koşul Kontrol Listesi Dosyanız CSV, XLSX veya XLS biçiminde Dosyada 10.000'den az kayıt var Dosyanızda yinelenen e-posta adresi yok **Şirketler önce içe aktarılmış** (Kişileri Şirketlere bağlayacaksanız) Tüm özel alanlar **Ayarlar → Veri Modeli**'nde mevcut **Kişilerden Önce Şirketleri İçe Aktarın** Kişileri Şirketlere bağlamak istiyorsanız, önce Şirketleri içe aktarın. Şirkete referans verebilmeden önce şirketin mevcut olması gerekir. ## Adım 1: Kişi Verinizi Hazırlayın ### Zorunlu ve Önerilen Alanlar | Alan | Zorunlu mu? | Biçim | Notlar | | ---------------- | ------------ | ----------------- | ----------------------------- | | **E-posta** | Önerilen | `name@domain.com` | Benzersiz olmalı | | **Ad** | Önerilen | Metin | | | **Soyadı** | Önerilen | Metin | | | **Şirket** | İsteğe bağlı | Alan adı veya ID | Mevcut bir Şirkete bağlanır | | **Telefon** | İsteğe bağlı | Birden çok sütun | Aşağıya bakın | | **İş Unvanı** | İsteğe bağlı | Metin | | | **Özel Alanlar** | İsteğe bağlı | Değişir | Veri Modeli'nde mevcut olmalı | ### E-posta Biçimi * Geçerli e-posta biçiminde olmalıdır: `name@domain.com` * **Benzersiz olmalı** — dosyanızda veya Twenty'de yinelenen olmamalı * Ek e-postalar için **Emails / Additional Emails** sütununu kullanın: ``` ["jane@twenty.com","jane.doe@twenty.com"] ``` ### Telefon Biçimi Telefon, birden çok sütun gerektiren **iç içe bir alan**dır: | Sütun | Örnek | | --------------------------------------- | ------------ | | **Phones / Primary Phone Number** | `4159095555` | | **Phones / Primary Phone Country Code** | `US` | | **Phones / Primary Phone Calling Code** | `+1` | ### Şirketlerle Bağlantı Kurma Şirketin benzersiz tanımlayıcısını içeren bir sütun ekleyin: | Sütun Adı | Biçim | Örnek | | --------------- | ---------- | -------------------------------------- | | `companyDomain` | URL biçimi | `https://acme.com` | | `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` | **Alan Adı URL biçimini kullanın** (`https://acme.com`), etiketi değil. Bu, Şirketlerin Twenty'de nasıl saklandığıyla uyumludur. ### Örnek CSV Yapısı ```csv firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US ``` **İpucu:** İçe aktarma sırasında **Örnek dosyayı indir**'i tıklayın ya da Twenty'nin beklediği tam sütun adlarını görmek için mevcut birkaç Kişiyi dışa aktarın. ## Adım 2: İçe Aktarma Özelliğine Erişin **Seçenek 1: Kişiler görünümünden** 1. Sol kenar çubuğunda **Kişiler**'e gidin 2. Sağ üstteki **⋮** simgesine tıklayın 3. **Kayıtları İçe Aktar**'ı seçin **Seçenek 2: Komut Menüsünü kullanma** 1. Mac'te `Cmd + K`, Windows'ta `Ctrl + K` tuşlarına basın 2. "import" yazın 3. **Kayıtları İçe Aktar**'ı seçin 4. **Kişiler**'i seçin ## Adım 3: Dosyanızı Yükleyin 1. **Dosya seç**'e tıklayın 2. CSV, XLSX veya XLS dosyanızı seçin 3. Twenty'nin dosyanızı analiz etmesini bekleyin ## Adım 4: Sütunlarınızı Eşleyin Twenty, sütunlarınızı alanlarla eşleştirmeyi otomatik olarak dener. Gözden geçirin ve ayarlayın: 1. **Otomatik eşlemeleri kontrol edin** — doğru olduklarını doğrulayın 2. **Yanlış eşlemeleri düzeltin** — doğru alanı seçmek için açılır menüye tıklayın 3. **Sütunları atlayın** — içe aktarmak istemediğiniz sütunlar için **Do not map** seçeneğini seçin ### Önemli Eşleme Kuralları | Sütun Türü | Eşlenecek Alan | Notlar | | ---------------- | ------------------------------ | ----------------------------------------------------- | | Şirket referansı | **Company** ilişki alanı | Alan adını YA DA id'yi kullanın, ikisini birden değil | | E-posta | **E-posta** | Birincil e-posta adresi | | Ek e-postalar | **Emails / Additional Emails** | Dizi biçimi | | Telefon | Ayrı sütunlar | Numara, Ülke Kodu, Arama Kodu | ### Şirket İlişkisinin Eşlenmesi Şirket sütununu eşlerken: 1. Şirket referans sütununuzu bulun (ör. `companyDomain`) 2. Bunu **Company** ilişki alanına eşleyin 3. Twenty, her Kişiyi eşleşen Şirkete bağlar **İlişkiler için yalnızca BİR benzersiz tanımlayıcıyı eşleyin.** Hem `companyId` hem de `companyDomain` eşlemeyin. Birini seçin — tercihen insanlar tarafından okunabildiği için alan adını. ## Adım 5: Seçim Alanı Değerlerini Eşleyin Seçim veya Çoklu Seçim alanlarınız varsa (örn. Potansiyel Müşteri Kaynağı): 1. Twenty, değerlerinizi mevcut seçeneklerin yanında gösterir 2. Dosyanızdaki her değeri bir Twenty seçeneğiyle eşleştirin 3. Gerekiyorsa yeni seçenekler oluşturun Seçim alanı seçenekleri, görüntü etiketlerini değil, **API adlarını** kullanır. API adlarını görmek için **Settings → Data Model** → **Advanced mode**'u etkinleştirin. ## Adım 6: Hataları Gözden Geçirin ve Düzeltin İçe aktarmayı tamamlamadan önce Twenty verilerinizi doğrular: 1. **Next Steps**'e tıklayın 2. Hata içeren satırlar **sarı** renkle vurgulanır 3. **Hataları doğrudan düzeltin** — bir hücreye tıklayın ve değeri düzenleyin 4. **Sorunlu satırları kaldırın** — o satırı atlamak için X'e tıklayın ### Yaygın Kişi İçe Aktarma Hataları | Hata | Neden | Çözüm | | --------------------------- | ------------------------------------------- | --------------------------------------------------- | | **Yinelenen e-posta** | E-posta Twenty'de veya dosyada zaten mevcut | Yineleneni kaldırın veya mevcut kaydı güncelleyin | | **Geçersiz e-posta biçimi** | E-posta biçimi hatalı | `name@domain.com` olarak düzeltin | | **İlişki bulunamadı** | Şirket mevcut değil | Önce Şirketleri içe aktarın veya referansı düzeltin | | **Gerekli alan eksik** | Gerekli alan boş | Değeri doldurun veya satırı kaldırın | ## Adım 7: İçe Aktarmayı Tamamlayın 1. İçe aktarma özetini gözden geçirin 2. İçe aktarmak için **Onayla**'ya tıklayın 3. İçe aktarmanın tamamlanmasını bekleyin 4. Birkaç kaydı ve Şirket bağlantılarını kontrol ederek doğrulayın ## Kişileri İçe Aktardıktan Sonra Kişileriniz artık Twenty'de! Sonraki adımlar: 1. **Şirket bağlantılarını doğrulayın** — doğru Şirkete bağlı olduklarını teyit etmek için birkaç Kişi kaydını açın 2. **Fırsatları içe aktarın** — gerekiyorsa bunları Kişiler ve Şirketlerle ilişkilendirin 3. **E-posta eşitlemesini ayarlayın** — kişi kayıtlarında e-posta geçmişini görmek için posta kutunuzu bağlayın ## Mevcut Kişileri Güncelleme Yeni kişiler oluşturmak yerine kişileri güncellemek için: 1. Dosyanıza `email` veya `id` sütununu ekleyin 2. Twenty, kayıtları bu benzersiz tanımlayıcıya göre eşleştirir 3. Mevcut kişiler güncellenir; yenileri oluşturulur Ayrıntılar için [Mevcut Kayıtlar Nasıl Güncellenir](/l/tr/user-guide/data-migration/how-tos/update-existing-records-via-import) bölümüne bakın. ## SSS E-posta, Twenty'de benzersiz bir tanımlayıcıdır. Bu, yinelenen kişileri önler ve e-posta eşitlemesinin e-postaları doğru kişiyle doğru şekilde ilişkilendirmesini sağlar. E-postayı boş bırakabilirsiniz. Ancak, daha iyi veri kalitesi ve e-posta eşitleme işlevi için mümkün olduğunda e-postaları eklemenizi öneririz. Şirketin alan adı (örn. `https://acme.com`) veya ID'si ile bir sütun ekleyin. Eşleme sırasında bu sütunu Şirket ilişki alanına bağlayın. Önce Şirketleri içe aktarın, ardından Kişileri içe aktarın. Şirkete referans verebilmeden önce şirketin mevcut olması gerekir. Evet! Dış ID'yi saklamak için veri modelinizde "unique" olarak işaretlenmiş özel bir alan oluşturun. Not: `id` alan adı Twenty'nin dahili ID'si için ayrılmıştır. Referans verdiğiniz Şirket mevcut değil. Ya önce Şirketi içe aktarın ya da alan adının/ID'nin mevcut bir Şirketle birebir eşleştiğini kontrol edin. ## Sorun Giderme Sorun mu yaşıyorsunuz? Şunları kontrol edin: * [İçe Aktarma Hataları Nasıl Düzeltilir](/l/tr/user-guide/data-migration/how-tos/fix-import-errors) * [İlişkiler Nasıl İçe Aktarılır](/l/tr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) * [Alan Eşleme Başvurusu](/l/tr/user-guide/data-migration/capabilities/field-mapping)