Excel veya CSV'den kişileri içe aktarma (izinle birlikte)

Kişiler → İçe aktar (/app/contacts/import), bir dosyadan tüm müşteri listesini getirir. Kişiler sayfasındaki Kişi ekle, bir kişiyi elle ekler. Dosyayı kontrol edip içe aktarma düğmesine basana kadar hiçbir şey kaydedilmez.

Başlamadan önce

• İçe aktarma, Kişileri içe aktar görevini gerektirir (varsayılan olarak Sahipler ve Yöneticiler; bir Sahip veya Yönetici bu görevi Ayarlar → Üyeler sayfasında Erişimi düzenle ile herkese verebilir, bkz. Roller ve görevler). Bu görev olmadan İçe aktar düğmesi gizlenir ve sayfada Kişileri içe aktarmak için Kişileri içe aktar görevi gerekir. Bir Sahip veya Yöneticiye danışın. yazar.
• Kişi ekle, Kişileri yönet görevini gerektirir (varsayılan olarak Sahipler, Yöneticiler ve Editörler).
• Dosya: CSV (UTF-8, UTF-16 veya Windows Arapçası; virgül, nokta virgül veya sekme) veya Excel .xlsx (ilk sayfa). 20 MB'a kadar, 100.000 satır ve 200 sütun. Eski bir Excel .xls reddedilir: Excel'de Dosya > Kaydet Excel Çalışma Kitabı (.xlsx) veya CSV UTF->8 seçeneğini seçebilirsiniz.
• İlk satır sütunları adlandırmalıdır, örneğin Name, Phone, Email veya الاسم، الجوال، البريد الإلكتروني. Her kişinin bir telefon numarası veya e-postası olmalıdır.
• Özel ayrıntıları (üyelik seviyesi, doğum günü...) içe aktarmak için önce alanları Özel kişi alanları içinde oluşturun.

Adım adım: bir dosyayı içe aktarma

1. Kişiler sayfasında İçe aktar düğmesine basın.
2. Dosya: Bir dosya seçin düğmesine basın, dosyayı seçin, Yükle düğmesine basın. Dosya okunuyor… ve ardından sütunları görürsünüz.
3. Sütunlar: Sütunları eşleştirin altında dosyanızın her sütunu için bir Şu şekilde içe aktar kutusu bulunur. Uygulamanın on dilindeki başlıklardan, aksanlı veya aksansız olarak tahmin ederiz (الجوال, Téléphone, Handy veya Cep telefonu → Telefon (WhatsApp), الاسم, Nom complet veya Nama → Ad, özel bir alanla eşleşen başlık → o alan). Ad sütununun yanındaki tek başına Nom veya Name soyadı olarak alınır; soyadı sütununun yanındaki Nome veya Nombre ise ad olarak alınır. Gerekmeyen sütunları İçe aktarılmasın olarak ayarlayın. Örnek, dosyadan bir değer gösterir. İçe aktarılmasın olarak ayarlanmış bir sütun telefon numaraları veya e-posta adresleri gibi görünüyorsa (ve başka hiçbir sütun bunlara ayarlanmamışsa), altındaki sarı bir satır bunu belirtir; örneğin Bu sütun telefon numaraları gibi görünüyor ama "İçe aktarılmasın" olarak ayarlanmış, bu yüzden içe aktarılmayacaklar. İçe aktarmak için "Telefon (WhatsApp)" seçeneğini seçin.
4. Seçenekler altında:

• Yerel numaralar için ülke: Ülke kodu olmadan yazılmış sayılar ('07400 123456' veya Excel sıfırı düşürdüğünde '7400 123456') bu ülkenin numaraları olarak okunur. Arapça rakamlar (٠٥٠...) uygundur. Dosyadaki bir Ülke sütunu satırında kazanır. Şirketinizin ülkesi olarak başlar (hiç ayarlanmadığında Bir ülke seçin ve sadece ülke koduyla yazılan numaralar okunur); liste, dilinizde adlandırılmış her ülkeyi alfabetik sırayla Tüm ülkeler altında içerir (tarayıcınızda olduğunuzu belirten ülke, Önerilen altında önce gelir).
• Zaten Kişiler'de olanlar (aynı telefon veya e-posta): Dosyadaki değerlerle güncelle (dolu hücreler kişinin mevcut değerlerinin yerini alır, boş hücreler hiçbir şeyi silmez, etiketler eklenir, telefon veya e-posta yalnızca kişide yoksa eklenir) veya Bunları atla.
• İçe aktarılan herkes için ek etiketler (virgülle ayrılmış): her biri en fazla 50 karakter olmak üzere en fazla 10 etiket (baştaki # yok sayılır). Daha fazlası kutunun altında Add at most 10 extra tags. Remove some, or add them later with Add tags. gösterir, daha uzun bir etiket ise A tag can be at most 50 characters. Shorten it, or split it with a comma.; kutu doğru olana kadar Devam et bekler.

5. Devam et düğmesine basın.
6. İzin: Hayır - kabul etmediler veya bilmiyorum ya da Evet - kabul ettiler ve nasıl olduğunu söyleyebilirim seçeneğini seçin. Evet için Kabul ettikleri kanallar seçeneklerini işaretleyin (WhatsApp, SMS, E-posta), Nerede kabul ettiler? seçin, Bu kişiler nasıl kabul etti? alanına yazın (en az 10 karakter, örneğin "Sadakat programımıza katılırken WhatsApp'ta Bana teklif gönderin seçeneğini işaretlediler"), biliyorsanız Ne zaman kabul ettiler (isteğe bağlı) alanını doldurun ve Bu kişilerin bu izni verdiğini ve istenirse kanıt gösterebileceğimi onaylıyorum. seçeneğini işaretleyin.
7. Dosyayı kontrol et düğmesine basın. Kontrol her satırı okur ve hiçbir şey kaydetmez (N satırdan n tanesi kontrol ediliyor…).
8. Kontrol sonucu; İçe aktarılmaya hazır, Sorunlu, Yeni kişiler, Zaten Kişiler'de ve Dosyada tekrarlanan sayılarını ve nedenleriyle birlikte Sorunlu ilk satırlar listesini gösterir. Ayarları değiştir sizi geri götürür; errors.csv indir tüm sorunlu satırları verir. Bir kişinin en fazla 20 etiketi olabilir: bazı kişiler bu sınırı aşacaksa kontrol bunu söyler, örneğin 3 contacts would pass the limit of 20 tags. They keep their tags and get this import's own tag; the other new tags are added only while there is room. CSV dışa aktar ile oluşturulmuş bir dosya olduğu gibi içe aktarılır: '+447400123456 gibi bir numaranın önündeki kesme işareti kaldırılır.
9. n kişiyi içe aktar düğmesine basın. N kişiden n tanesi içe aktarılıyor… ilerlemeyi gösterir. Sayfadan ayrılabilirsiniz: içe aktarma devam eder ve Kişiler → İçe aktar → Son içe aktarmalar onu yeniden açar (Aç). İçe aktarmadan önce bıraktığınız bir yükleme (Sütunlar, İzin adımında veya Dosyayı kontrol et sonrasında) Son içe aktarmalar içinde Tamamlanmadı olarak, Devam et (kaldığınız yere döner) ve Vazgeç ile görünür. Vazgeç, ""(dosya)" yüklemesinden vazgeçilsin mi? Bu dosyadan hiçbir şey içe aktarılmadı. Satırları ve saklanan dosya silinir." diye sorar ve yüklemeyi listeden kaldırır. 7 gün boyunca tamamlanmayan yüklemelerden otomatik olarak vazgeçilir; her iki durumda da Kişiler’de hiçbir şey değişmez.
10. İçe aktarma tamamlandı. gördüğünüzde, listeyi görmek için İçe aktarılan kişileri görüntüle veya errors.csv indir (yalnızca bazı satırlar içe aktarılmadığında İçe aktarılmayan satırlar, nedeniyle birlikte, dosyanın kendi sütunlarında. birlikte gösteriliyor). Toplamlar altında, bu ithalatın oluşturduğu veya güncellendiği herkes "İçe aktarma – customers.csv – 2026-09-24" (n kişi) listesinde yer alır. Ithalatın yaptığı listeyi adlandırır; Listeyi aç , Kişiler → Hedef Kitleler sayfasında açılır (bir sonraki bölüme bakınız).

İçe aktarmanın listesi

Bir içe aktarma bittiğinde, oluşturduğu veya güncellediği herkes Import – <file name> – <date> adlı yeni bir listeye (statik bir hedef kitle) konur, örneğin Import – customers.csv – 2026-09-24. Onu diğer listeler gibi kullanın: bir WhatsApp yayınının hedef kitlesi olarak seçin, Kişiler → Hedef kitleler içinde açın, kişi ekleyin veya çıkarın (Hedef kitleler).

• Atlanan kişiler (Bunları atla seçiliyken zaten Kişiler'de olanlar), sorunlu satırlar ve kaydedilemeyen satırlar listede yer almaz.
• Tarih, içe aktarmanın bittiği gündür. Aynı dosyayı aynı gün yeniden içe aktarırsanız kişileri aynı listeye katılır; başka bir gün yeni bir liste alırsınız.
• İptal edilen bir içe aktarma liste almaz. Zaten içe aktardığı kişiler içe aktarmanın etiketini korur, böylece onları yine bulabilirsiniz.
• Bir çalışma alanı en fazla 500 hedef kitle tutar. Zaten 500 tane varsa, içe aktarma liste olmadan biter ve Bu içe aktarma için liste oluşturulmadı: çalışma alanında zaten 500 hedef kitle var. yazar. Artık ihtiyacınız olmayan listeleri Kişiler → Hedef kitleler içinde arşivleyin; etiket yine de dosyadan gelen herkesi işaretler.

Kişiler nasıl eşleştirilir (yinelenen kayıt olmadan)

• Bir satır, telefon numarası (+ülke kodu ve numara olarak yazıldıktan sonra) veya e-postası bu çalışma alanında herhangi bir kanalda zaten bulunuyorsa, bir kişiyle aynı kişidir. Birleştirilmiş bir kişi tek bir kişi olarak güncellenir.
• Bir dosyada aynı numaraya veya e-postaya sahip iki satır tek bir kişi olur: ilki kişiyi oluşturur, sonrakiler onu günceller (veya Bunları atla seçtiyseniz atlanır).
• Telefon numarası olan yeni bir kişi, o kişinin WhatsApp kişisi olarak oluşturulur; böylece size yazdığında mesajları aynı karta gelir. Kaynak değeri İçe aktarma olur.
• İçe aktarılan her kişi, içe aktarmanın kendi etiketini alır: import: artı tarih ve dosya adı (örneğin import:2026-09-24-customers-3f9a); böylece yukarıdaki içe aktarma listesinin yanı sıra onları Kişiler sayfasında (etikete göre filtreleyerek) yeniden bulabilirsiniz.

İzin: ne kaydedilir

• Evet ile her kişi, işaretlenen her kanal için İçe aktarma kaynağıyla ve beyanınız, yer, tarih ve dosya adı kanıt olarak, ayrıca içe aktarmayı kimin başlattığı bilgisiyle bir izin kaydı alır. Bu, kişide İzin geçmişi altında görünür (İzin ve abonelikten çıkma).
• Yalnızca satırın adresi olan kanallar: WhatsApp ve SMS telefon numarası, e-posta ise e-posta adresi gerektirir.
• Dosyadaki bir Pazarlama izni (evet / hayır) sütunu: yalnızca evet diyen satırlar (yes, y, 1, نعم, موافق) izin alır; hayır diyen veya boş olan satırlar almaz. Böyle bir sütun beyan (Evet) gerektirir ya da İçe aktarılmasın olarak ayarlanmalıdır.
• Geri çeken veya STOP yanıtı veren kişiler seçimlerini korur (Önceki hayır yanıtı korundu olarak sayılır). Bir içe aktarma bunu asla geçersiz kılmaz; yalnızca kişinin kendisi veya yeni kabulünü İzni kaydet ile kaydeden bir ekip arkadaşı bunu yapabilir.
• Hayır ile kimse pazarlama izni almaz. Kişiler yine de 24 saatlik pencere içinde yanıtları ve kullanım mesajlarını alabilir.

Bir şeyler ters giderse

• Bu eski bir Excel dosyası (.xls)... → dosyayı .xlsx veya CSV UTF-8 olarak kaydedin ve yeniden yükleyin.
• İlk satır sütunlara isim vermeli → başlık satırı eklemeli. Dosyada sütun isimleri var ama kişi satırları yok. → dosyanın bir başlık satırı var ve altında hiçbir şey yok (veya sadece boş satırlar); sütun adlarının altına kişi başına bir satır ekleyin ve tekrar yükleyin. Dosya boş. Dosyada hiçbir şey bulunmadığı anlamına gelir.
• Dosyanın 100.000'den fazla satırı vardır veya dosya 20 MB'den büyükse → bölebilirsiniz. İkinci mesaj ayrıca küçük olan ancak açıldıktan sonra milyonlarca dolu hücre barındıran bir dosya için de görünür.
• Dosyada 200'den fazla sütun var. → gerekmeyen sütunları silebilir. Sağa yazılmış bir değer, aksi takdirde boş bir sütunda bile sayılır; boş hücreler saymaz.
• Bir telefon veya e-posta sütunu eşleştirin. → bir sütunu Telefon (WhatsApp) veya E-posta olarak ayarlayın.
• İki sütun "…" olarak ayarlanmış → bunlardan birini İçe aktarılmasın olarak ayarlayın.
• errors.csv'de satırlar, sebepler: Geçerli bir telefon numarası değil (ülke kodunu kontrol edin) ( Yerel numaralar için ülke kontrol et), Telefon numarası veya e-posta yok, Geçerli bir e-posta adresi değil, bilinmeyen ülke, bilinmeyen dil, bilinmeyen saat dilimi, Bir özel alan değeri alana uymuyor (alan detaylarda adlandırılır: seçim seçeneklerinden biri olmalıdır, bir tarih YYYY-MM-DD veya gün/ay/yıl, sadece rakamlar), İzin sütunu evet veya hayır olmalıdır, Zaten bir kişi - atlandı, Kaydedilemedi (o satırı tekrar aktarmayı deneyin). errors.csv dosyanın kendi sütunlarına sahip, böylece satırları düzeltip yeni bir dosya olarak aktarabilirsiniz. Uygulamayı kullandığınız dilde gelir: ilk dört sütunu (satır, durum, sebep, detay), her satırın durumu ve nedeni o dilde.
• İçe aktarmayı iptal et, sonraki 1.000 satırdan önce durdurur; zaten içe aktarılan kişiler kalır.
• Satırlar ve dosyanın saklanan kopyası yüklemeden 30 gün sonra silinir; bundan sonra errors.csv artık kullanılamaz (Bu dosyanın satırları yüklemeden 30 gün sonra silindi.). İçe aktarmanın toplamları ve izin beyanı saklanır.

Tek bir kişi ekleme

1. Kişiler sayfasında Kişi ekle düğmesine basın.
2. Ad (en fazla 120 karakter) alanını ve Telefon (WhatsApp) (ülke koduyla ya da seçtiğiniz Ülke için yerel numara olarak), E-posta veya Başka bir platformdaki kullanıcı adı (Platform seçimiyle birlikte) alanlarından en az birini doldurun. Ülke, şirketinizin ülkesiyle başlar (Ayarlar → Şirket) ve tüm ülkeleri sizin dilinizdeki adlarıyla listeler; ülke ayarlanmamışsa Bir ülke seçin yazar. Arapça klavyede yazılan rakamlar (٠٥٥…) siz yazarken Telefon (WhatsApp) alanında 0-9'a dönüşür; böylece numara her zamanki sırasıyla soldan sağa okunur.
3. İsteğe bağlı: Etiketler (virgülle ayrılmış), Notlar ve Pazarlama izni (isteğe bağlı) altında kişinin kabul ettiği kanallar ile Nasıl kabul etti?
4. Kişi ekle'ye basın. [ad] eklendi. mesajını görürsünüz ve kişi açılır.
5. Bu kişi zaten Kişiler'de. → numara veya e-posta başka birine ait; Kişiyi aç düğmesine basın. Sorun tek bir kutudaysa neden o kutunun altında kırmızıyla görünür, kutu kırmızı olur ve imleç kutuya geçer. Örneğin Bu, seçilen ülke için geçerli bir telefon numarası değildir. O ülkenin yerel numarasını veya + ile başlayan tam numarayı ve ülke kodunu girin. mesajı Telefon (WhatsApp) altında (Ülke seçilmemişse: Bu geçerli bir telefon numarası değil. + ve ülke kodundan sonraki rakamları kontrol edin veya aşağıdan Ülke seçip yerel bir numara girin.), Kullanıcı adının platformunu seçin. mesajı Platform altında (bir kullanıcı adı yazıldığında, telefon veya e-posta girilmiş olsa bile), WhatsApp veya SMS izni için bir telefon numarası gereklidir. Numarayı girin veya WhatsApp ve SMS işaretlerini kaldırın. mesajı Telefon (WhatsApp) altında, E-posta onayı için bir e-posta adresi gereklidir. Adresi girin veya E-posta işaretini kaldırın. ya da name@example.com gibi bir e-posta adresi girin. mesajı E-posta altında, Kişinin nasıl kabul ettiğini yazın (en az 3 karakter). mesajı ise Nasıl kabul etti? altında görünür. Her neden sizin dilinizdedir. Sorunu düzeltip Kişi ekle düğmesine yeniden basın. Formun bütünüyle ilgili bir mesaj (Bir telefon numarası, e-posta veya kullanıcı adı girin.) en altta görünür.

Yalnızca kullanıcı adıyla eklenen bir kişi kendi kartını alır; kişi size o platformdan yazdığında ikisini Şununla birleştir… ile birleştirin (Kişiler).

Geliştiriciler (API)

'POST /workspaces/{workspaceId}/contacts' bir kişi ekler ('name', 'telefon', 'email', 'handle' + 'platform', 'country', 'tags', 'notlar', 'attributes', 'consent: {channels, evidence}'); 409 mevcut 'contactId'yi döndürür. İçe aktarmalar: 'POST .../contacts/imports' (çok parçalı 'dosya'), 'GET .../contacts/imports/{id}', 'PATCH' '{mapping, options}', 'POST .../validate', 'POST .../run', 'POST .../iptal', 'GET .../errors.csv?lang=ar' ('lang': en, ar, fr, es, pt, de, tr, id, hi veya your). Bitmiş bir ithalatın 'GET' işareti yukarıdaki listeyi 'audience' ('id', 'name', 'memberCount') geri getirir.

İlgili

• Kişiler
• Listeler ve segmentler (hedef kitleler)
• İzin ve abonelikten çıkma
• Özel kişi alanları
• WhatsApp yayınları