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ça; virgül, noktalı virgül veya sekme) ya da Excel .xlsx (ilk sayfa). En fazla 20 MB ve 100.000 satır. Eski bir Excel .xls dosyası reddedilir: Excel'de Dosya > Farklı Kaydet > Excel Çalışma Kitabı (.xlsx) veya CSV UTF-8 seçin.
• İ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ütununun bir Şu şekilde içe aktar kutusu vardır. İngilizce ve Arapça başlıklardan tahmin yaparız (الجوال → Telefon (WhatsApp), الاسم → Ad, bir özel alanla eşleşen başlık → o alan). İhtiyacınız olmayan sütunları İçe aktarılmasın olarak ayarlayın. Örnek, dosyadan bir değer gösterir. 4. Seçenekler altında: - Yerel numaralar için ülke: ülke kodu olmadan yazılmış numaralar (0501234567 veya Excel sıfırı düşürdüğünde 501234567) bu ülkenin numaraları olarak okunur. Arapça rakamlar (٠٥٠...) sorun değildir. Dosyadaki bir Ülke sütunu kendi satırı için önceliklidir. Başlangıçta şirketinizin ülkesidir. - 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 Atla. - İçe aktarılan herkes için ek etiketler (virgülle ayrılmış). 5. Devam 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. 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ç). 10. İçe aktarma tamamlandı. mesajını gördüğünüzde listeyi görmek için İçe aktarılan kişileri görüntüle veya errors.csv indir düğmesine basın. Toplamların altında Bu içe aktarmanın oluşturduğu veya güncellediği herkes "Import – customers.csv – 2026-09-24" listesinde (n kişi). ifadesi içe aktarmanın oluşturduğu listeyi adlandırır; Listeyi aç onu Kişiler → Hedef kitleler içinde açar (sonraki bölüme bakın).

İç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 (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 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ütunları adlandırmalıdır → bir başlık satırı ekleyin.
• Dosyada 100.000'den fazla satır var veya Dosya 20 MB'tan büyük → dosyayı bölün.
• 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 içindeki satırlar, nedenleriyle: Geçerli bir telefon numarası değil (ülke kodunu kontrol edin) (Yerel numaralar için ülke ayarını kontrol edin), 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 ayrıntıda belirtilir: bir seçim seçeneklerinden biri, bir tarih YYYY-AA-GG veya gün/ay/yıl, bir sayı yalnızca rakam olmalıdır), İzin sütunu evet veya hayır olmalıdır, Zaten bir kişi - atlandı, Kaydedilemedi (o satırı yeniden içe aktarmayı deneyin). errors.csv dosyanın kendi sütunlarına sahiptir, böylece satırları düzeltip yeni bir dosya olarak içe aktarabilirsiniz.
• İç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 alanını ve şunlardan en az birini doldurun: Telefon (WhatsApp) (ülke koduyla veya seçtiğiniz Ülke için yerel bir numara), E-posta ya da Platform ile birlikte Başka bir platformdaki kullanıcı adı.
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 düğmesine basın. {name} 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 birine ait; Kişiyi aç düğmesine basın.

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 tek bir kişi ekler (name, phone, email, handle + platform, country, tags, notes, attributes, consent: {channels, evidence}); 409 mevcut contactId değerini döndürür. İçe aktarmalar: POST .../contacts/imports (multipart file), GET .../contacts/imports/{id}, PATCH {mapping, options}, POST .../validate, POST .../run, POST .../cancel, GET .../errors.csv?lang=ar. Tamamlanmış bir içe aktarmanın GET yanıtı audience (id, name, memberCount) döndürür — yukarıdaki liste.

İlgili

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