Genel Bakış
Bu kılavuz, kişilerinizi (Kişiler) Twenty’ye içe aktarma sürecinde size yol gösterir. Önce Şirketleri içe aktarın, Kişileri Şirketlere bağlamak istiyorsanız.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
Adım 1: Kişi Verinizi Hazırlayın
Zorunlu ve Önerilen Alanlar
| Alan | Zorunlu mu? | Biçim | Notlar |
|---|---|---|---|
| E-posta | Önerilen | [email protected] | 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:
[email protected] - Benzersiz olmalı — dosyanızda veya Twenty’de yinelenen olmamalı
- Ek e-postalar için Emails / Additional Emails sütununu kullanın:
Telefon Biçimi
Telefon, birden çok sütun gerektiren iç içe bir alandı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ı
İ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- Sol kenar çubuğunda Kişiler’e gidin
- Sağ üstteki ⋮ simgesine tıklayın
- Kayıtları İçe Aktar’ı seçin
- Mac’te
Cmd + K, Windows’taCtrl + Ktuşlarına basın - “import” yazın
- Kayıtları İçe Aktar’ı seçin
- Kişiler’i seçin
Adım 3: Dosyanızı Yükleyin
- Dosya seç’e tıklayın
- CSV, XLSX veya XLS dosyanızı seçin
- 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:- Otomatik eşlemeleri kontrol edin — doğru olduklarını doğrulayın
- Yanlış eşlemeleri düzeltin — doğru alanı seçmek için açılır menüye tıklayın
- 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:- Şirket referans sütununuzu bulun (ör.
companyDomain) - Bunu Company ilişki alanına eşleyin
- Twenty, her Kişiyi eşleşen Şirkete bağlar
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ğı):- Twenty, değerlerinizi mevcut seçeneklerin yanında gösterir
- Dosyanızdaki her değeri bir Twenty seçeneğiyle eşleştirin
- 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:- Next Steps’e tıklayın
- Hata içeren satırlar sarı renkle vurgulanır
- Hataları doğrudan düzeltin — bir hücreye tıklayın ve değeri düzenleyin
- 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ı | [email protected] 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
- İçe aktarma özetini gözden geçirin
- İçe aktarmak için Onayla’ya tıklayın
- İçe aktarmanın tamamlanmasını bekleyin
- 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:- Ş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
- Fırsatları içe aktarın — gerekiyorsa bunları Kişiler ve Şirketlerle ilişkilendirin
- 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:- Dosyanıza
emailveyaidsütununu ekleyin - Twenty, kayıtları bu benzersiz tanımlayıcıya göre eşleştirir
- Mevcut kişiler güncellenir; yenileri oluşturulur
SSS
Neden iki Kişinin aynı e-postası olamaz?
Neden iki Kişinin aynı e-postası olamaz?
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-postası olmayan kişilerim varsa ne yapmalıyım?
E-postası olmayan kişilerim varsa ne yapmalıyım?
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.
İçe aktarma sırasında Kişileri Şirketlerle nasıl ilişkilendiririm?
İçe aktarma sırasında Kişileri Şirketlerle nasıl ilişkilendiririm?
Ş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.Şirket henüz mevcut değilse ne yapmalıyım?
Şirket henüz mevcut değilse ne yapmalıyım?
Önce Şirketleri içe aktarın, ardından Kişileri içe aktarın. Şirkete referans verebilmeden önce şirketin mevcut olması gerekir.
Önceki CRM'imden ID'yi içe aktarabilir miyim?
Önceki CRM'imden ID'yi içe aktarabilir miyim?
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.'relation not found' hatalarını nasıl düzeltirim?
'relation not found' hatalarını nasıl düzeltirim?
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.