Mengimpor kontak dari Excel atau CSV (dengan persetujuan)

Kontak → Impor (/app/contacts/import) memasukkan seluruh daftar pelanggan dari sebuah file. Tambah kontak di halaman Kontak menambahkan satu orang secara manual. Tidak ada yang disimpan sampai Anda memeriksa file dan menekan tombol impor.

Sebelum Anda mulai

• Mengimpor memerlukan tugas Impor kontak (secara default Pemilik dan Admin; Pemilik atau Admin dapat memberikannya kepada siapa pun melalui Edit akses di Pengaturan → Anggota, lihat Peran dan tugas). Tanpa tugas tersebut, tombol Impor disembunyikan dan halaman menampilkan Mengimpor kontak memerlukan tugas Impor kontak. Hubungi Owner atau Admin.
• Tambah kontak memerlukan tugas Kelola kontak (secara default Pemilik, Admin, dan Editor).
• File: CSV (UTF-8, UTF-16 atau Windows Arab; koma, titik koma, atau tab) atau Excel .xlsx (lembar pertama). Hingga 20 MB, 100.000 baris dan 200 kolom. Excel lama .xls ditolak: di Excel pilih File > Save As > Excel Workbook (.xlsx) atau CSV UTF-8.
• Baris pertama harus berisi nama kolom, misalnya Name, Phone, Email atau الاسم، الجوال، البريد الإلكتروني. Setiap orang memerlukan nomor telepon atau e-mail.
• Untuk mengimpor detail kustom (tingkat keanggotaan, ulang tahun...), buat kolomnya terlebih dahulu di Kolom kontak kustom.

Langkah demi langkah: mengimpor file

1. Di Kontak, tekan Impor.
2. File: tekan Pilih file, pilih file-nya, tekan Unggah. Anda melihat Membaca file…, lalu kolom-kolomnya.
3. Kolom: di bawah Cocokkan kolom setiap kolom file Anda memiliki kotak Impor sebagai . Kami menebak dari header dalam sepuluh bahasa aplikasi, dengan atau tanpa aksen ('الجوال', 'Téléphone', 'Handy' atau 'Cep telefonu' → Telepon (WhatsApp) 'الاسم', 'Nom complete' atau 'Nama' → Nama, sebuah header yang cocok dengan kolom khusus → bidang tersebut). Di samping kolom nama depan, 'Nom' atau 'Name' dipakai sebagai nama belakang; di samping kolom nama belakang, 'Nome' atau 'Nombre' sebagai nama depan. Atur kolom yang tidak perlu Anda Jangan impor. Contoh menunjukkan nilai dari file. Ketika kolom yang diatur ke Jangan impor terlihat seperti nomor telepon atau alamat email (dan tidak ada kolom lain yang diatur ke sana), garis kuning di bawahnya menunjukkan hal itu, misalnya Kolom ini terlihat seperti nomor telepon, tetapi diatur ke "Jangan impor", sehingga tidak akan diimpor. Pilih "Telepon (WhatsApp)" untuk mengimpornya.
4. Di bawah Opsi:

• Negara untuk nomor lokal: angka yang ditulis tanpa kode negara ('07400 123456', atau '7400 123456' saat Excel menurunkan angka nol) dibaca sebagai angka negara ini. Digit Arab (٠٥٠...) tidak masalah. Kolom Negara dalam file menang untuk barisnya. Pilihan ini dimulai dengan negara perusahaan Anda (jika belum diatur, tertulis Pilih negara, dan hanya nomor yang ditulis dengan kode negaranya yang dibaca); daftarnya berisi setiap negara, dinamai dalam bahasa Anda, berurutan menurut abjad di bawah Semua negara (negara tempat Anda berada menurut browser, jika diketahui, muncul pertama di bawah Disarankan).

• Orang yang sudah ada di Kontak (telepon atau e-mail sama): Perbarui dengan nilai dari file (sel yang terisi menggantikan data kontak sebelumnya, sel kosong tidak pernah menghapus apa pun, tag ditambahkan, telepon atau e-mail hanya ditambahkan jika kontak belum memilikinya) atau Lewati.
• Tag tambahan untuk semua yang diimpor (pisahkan dengan koma): hingga 10 tag, masing-masing hingga 50 karakter (tanda # di awal diabaikan). Lebih dari itu menampilkan Add at most 10 extra tags. Remove some, or add them later with Add tags. di bawah kotak, dan tag yang lebih panjang menampilkan A tag can be at most 50 characters. Shorten it, or split it with a comma.; Lanjutkan menunggu sampai isi kotak benar.

5. Tekan Lanjutkan.
6. Persetujuan: pilih Tidak - mereka belum setuju, atau saya tidak tahu atau Ya - mereka setuju, dan saya dapat menjelaskan caranya. Untuk ya, centang Saluran yang mereka setujui (WhatsApp, SMS, Email), pilih Di mana mereka menyetujuinya?, tulis Bagaimana orang-orang ini menyetujuinya? (minimal 10 karakter, misalnya "Mereka mencentang Kirimi saya penawaran di WhatsApp saat bergabung dengan program loyalitas kami"), isi Kapan mereka menyetujuinya (opsional) jika Anda mengetahuinya, dan centang Saya mengonfirmasi bahwa orang-orang ini memberikan persetujuan ini dan saya dapat menunjukkan buktinya jika diminta.
7. Tekan Periksa file. Pemeriksaan membaca setiap baris dan tidak menyimpan apa pun (Memeriksa n dari N baris…).
8. Hasil pemeriksaan menampilkan Siap diimpor, Bermasalah, Kontak baru, Sudah ada di Kontak, dan Berulang dalam file, serta Baris pertama yang bermasalah beserta alasannya. Ubah pengaturan membawa Anda kembali; Unduh errors.csv memberikan setiap baris yang bermasalah. Kontak dapat memiliki paling banyak 20 tag: jika ada orang yang akan melewati batas itu, pemeriksaan menyebutkannya, misalnya 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. File yang dibuat dengan Ekspor CSV dapat diimpor apa adanya: apostrof di depan nomor seperti '+447400123456 dihapus.
9. Tekan Impor n kontak. Mengimpor n dari N… menampilkan progresnya. Anda dapat meninggalkan halaman: impor tetap berjalan, dan Kontak → Impor → Impor terbaru membukanya kembali (Buka). File unggahan yang Anda tinggalkan sebelum impor (di Kolom, Persetujuan, atau setelah Periksa file) muncul di Impor terbaru sebagai Belum selesai, dengan Lanjutkan (kembali ke langkah terakhir) dan Buang. Buang menanyakan "Buang file unggahan "(file)"? Tidak ada isinya yang diimpor. Baris-barisnya dan file yang disimpan akan dihapus." lalu menghapusnya dari daftar. Unggahan yang dibiarkan belum selesai selama 7 hari dibuang secara otomatis; dalam kedua kasus, tidak ada yang berubah di Kontak.
10. Saat Anda melihat Impor selesai. tekan Lihat kontak yang diimpor untuk melihat daftar, atau Unduh errors.csv (ditampilkan, dengan baris Baris yang tidak diimpor, beserta alasannya, dalam kolom asli file. hanya ketika beberapa baris tidak diimpor). Di bawah total, Semua orang yang dibuat atau diperbarui oleh impor ini ada di daftar "Impor – customers.csv – 2026-09-24" (n orang). Sebutkan daftar yang diimpor; Buka daftar akan membuka di Kontak → Audiens (lihat bagian berikutnya).

Daftar hasil impor

Saat impor selesai, semua orang yang dibuat atau diperbarui olehnya dimasukkan ke daftar baru (audiens statis) bernama Import – <file name> – <date> (nama file dan tanggal), misalnya Import – customers.csv – 2026-09-24. Gunakan seperti daftar lainnya: pilih sebagai audiens siaran WhatsApp, buka di Kontak → Audiens, tambahkan atau keluarkan orang (Audiens).

• Orang yang dilewati (sudah ada di Kontak, dengan Lewati), baris yang bermasalah, dan baris yang tidak dapat disimpan tidak ada di dalamnya.
• Tanggalnya adalah hari saat impor selesai. Impor file yang sama lagi pada hari yang sama dan orang-orangnya akan masuk ke daftar yang sama; pada hari lain Anda mendapat daftar baru.
• Impor yang dibatalkan tidak mendapat daftar. Orang-orang yang sudah diimpor tetap memiliki tag impor tersebut, sehingga Anda tetap dapat menemukan mereka.
• Sebuah workspace menyimpan hingga 500 audiens. Jika sudah ada 500, impor selesai tanpa daftar dan menampilkan Tidak ada daftar yang dibuat untuk impor ini: workspace sudah menyimpan 500 audiens. Arsipkan daftar yang tidak lagi Anda perlukan di Kontak → Audiens; tag tetap menandai semua orang dari file tersebut.

Cara orang dicocokkan (tanpa duplikat)

• Sebuah baris dianggap orang yang sama dengan sebuah kontak jika nomor teleponnya (setelah ditulis sebagai +kode negara dan nomor) atau e-mailnya sudah ada di workspace ini, di saluran mana pun. Kontak yang digabungkan diperbarui sebagai satu orang.
• Dua baris dengan nomor atau e-mail yang sama dalam satu file menjadi satu kontak: yang pertama membuatnya, yang berikutnya memperbaruinya (atau dilewati jika Anda memilih Lewati).
• Kontak baru dengan nomor telepon dibuat sebagai kontak WhatsApp orang tersebut, sehingga saat mereka menulis kepada Anda, pesannya masuk ke kartu yang sama. Sumber-nya adalah Impor.
• Setiap kontak yang diimpor mendapat tag khusus impor tersebut, import: ditambah tanggal dan nama file (misalnya import:2026-09-24-customers-3f9a), sehingga Anda dapat menemukannya lagi di halaman Kontak (filter berdasarkan tag), selain melalui daftar hasil impor di atas.

Persetujuan: apa yang dicatat

• Dengan Ya, setiap orang mendapat catatan persetujuan per saluran yang dicentang, dengan sumber Impor dan pernyataan Anda, tempat, tanggal, dan nama file sebagai bukti, serta siapa yang memulai impor. Catatan ini tampil di bawah Riwayat persetujuan pada kontak (Persetujuan dan opt-out).
• Hanya saluran yang alamatnya dimiliki baris tersebut: WhatsApp dan SMS memerlukan nomor telepon, e-mail memerlukan alamat e-mail.
• Kolom Persetujuan pemasaran (ya / tidak) di dalam file: hanya baris yang berisi ya (yes, y, 1, نعم, موافق) yang mendapat persetujuan; baris yang berisi tidak atau kosong tidak mendapatkannya. Kolom seperti itu memerlukan pernyataan (Ya) atau harus diatur ke Jangan impor.
• Orang yang telah menarik persetujuan atau membalas STOP tetap dengan pilihannya (dihitung sebagai Penolakan sebelumnya dipertahankan). Impor tidak pernah menimpanya; hanya orang tersebut, atau rekan tim yang mencatat persetujuan barunya dengan Catat persetujuan, yang dapat melakukannya.
• Dengan Tidak, tidak ada yang mendapat persetujuan pemasaran. Mereka tetap dapat menerima balasan dalam jendela 24 jam dan pesan utilitas.

Jika terjadi masalah

• Ini adalah file Excel lama (.xls)... → simpan sebagai .xlsx atau CSV UTF-8 dan unggah lagi.
• Baris pertama harus memberi nama pada kolom → menambahkan baris header. File tersebut memiliki nama kolom tetapi tidak ada baris orang. → file memiliki baris header dan tidak ada apa-apa di bawahnya (atau hanya baris kosong); tambahkan satu baris per orang di bawah nama kolom dan unggah lagi. File kosong. berarti tidak ditemukan sama sekali dalam file.
• File memiliki lebih dari 100.000 baris atau File lebih besar dari 20 MB → dibagi. Pesan kedua juga muncul untuk file yang kecil tetapi berisi jutaan sel yang terisi setelah dibuka.
• File memiliki lebih dari 200 kolom. → menghapus kolom yang tidak Anda butuhkan. Nilai yang diketik jauh ke kanan, bahkan di kolom yang kosong, dihitung; sel kosong tidak dihitung.
• Petakan kolom telepon atau e-mail. → atur satu kolom ke Telepon (WhatsApp) atau Email.
• Dua kolom diatur ke "…" → atur salah satunya ke Jangan impor.
• Baris dalam errors.csv, dengan alasan: Bukan nomor telepon yang valid (periksa kode negara) (periksa Negara untuk nomor lokal), Tidak ada nomor telepon atau e-mail, Bukan alamat e-mail yang valid, Negara tidak dikenal, Bahasa tidak dikenal, Zona waktu tidak diketahui, Nilai kolom kustom tidak sesuai dengan kolomnya (field disebutkan dalam detail: pilihan harus menjadi salah satu opsinya, tanggal YYYY-MM-DD atau hari/bulan/tahun, hanya angka digit), Kolom persetujuan harus berisi yes atau no, Sudah menjadi kontak - dilewati, Tidak dapat disimpan (coba impor baris itu lagi). errors.csv memiliki kolom file sendiri, sehingga Anda dapat memperbaiki baris dan mengimpornya sebagai file baru. Aplikasi ini hadir dalam bahasa yang Anda gunakan untuk aplikasi: empat kolom pertama (baris, status, alasan, detail), status setiap baris dan alasannya dalam bahasa tersebut.
• Batalkan impor berhenti sebelum 1.000 baris berikutnya; kontak yang sudah diimpor tetap ada.
• Baris dan salinan file yang disimpan dihapus 30 hari setelah diunggah; setelah itu errors.csv tidak lagi tersedia (Baris file ini dihapus 30 hari setelah diunggah.). Total impor dan pernyataan persetujuan tetap disimpan.

Menambahkan satu kontak

1. Di Kontak, tekan Tambah kontak.
2. Isi Nama (hingga 120 karakter) dan setidaknya satu dari Telepon (WhatsApp) (dengan kode negara, atau nomor lokal Negara yang Anda pilih), Email, atau Handle di platform lain dengan Platform tersebut. Negara dimulai sebagai negara perusahaan Anda (Pengaturan → Perusahaan) dan mencantumkan setiap negara yang dinamai dalam bahasa Anda; jika tidak ada yang diatur, terbaca Pilih negara. Digit yang diketik pada keyboard Arab (٠٥٥...) menjadi 0-9 di Telepon (WhatsApp) saat Anda mengetik, sehingga angka terbaca dari kiri ke kanan sesuai urutan biasanya.
3. Opsional: Tag (pisahkan dengan koma), Catatan, dan di bawah Persetujuan pemasaran (opsional) saluran yang disetujui orang tersebut beserta Bagaimana mereka menyetujuinya?
4. Tekan Tambah kontak. Anda melihat [nama] telah ditambahkan. dan kontak terbuka.
5. Orang ini sudah ada di Kontak. → nomor atau email milik seseorang; tekan Buka kontak. Ketika satu kotak bermasalah, alasan muncul merah di bawah kotak itu, kotak berubah merah dan kursor bergerak ke dalamnya. Misalnya Nomor telepon tersebut bukan valid untuk negara yang dipilih. Masukkan nomor lokal negara tersebut, atau nomor lengkap yang dimulai dengan + dan kode negara. di bawah Telepon (WhatsApp) (tanpa Negara yang dipilih: Itu bukan nomor telepon yang valid. Periksa digit setelah + dan kode negara, atau pilih Negara di bawah dan masukkan nomor lokal.), Pilih platform handle tersebut. di bawah Platform (setiap kali handle diketik, bahkan dengan ponsel atau email), Persetujuan WhatsApp atau SMS membutuhkan nomor telepon. Masukkan nomornya, atau hapus centang WhatsApp dan SMS. di bawah Telepon (WhatsApp) Persetujuan e-mail membutuhkan alamat e-mail. Masukkan alamatnya, atau hapus centang E-mail. atau Masukkan alamat email seperti name@example.com. di Email, atau Jelaskan bagaimana orang tersebut menyetujuinya (minimal 3 karakter). di bawah Bagaimana mereka menyetujuinya? Setiap alasan ada dalam bahasa Anda. Perbaiki dan tekan Tambah kontak lagi. Pesan tentang formulir secara keseluruhan (Masukkan nomor telepon, e-mail, atau handle. muncul di bagian bawah.

Kontak yang ditambahkan hanya dengan handle mendapat kartu tersendiri; saat orang tersebut menulis kepada Anda dari platform itu, gabungkan keduanya dengan Gabungkan dengan… (Kontak).

Developer (API)

'POST /workspaces/{workspaceId}/contacts' menambahkan satu kontak ('name', 'phone', 'email', 'handle' + 'platform', 'country', 'tags', 'notes', 'attributes', 'consent: {channels, evidence}'); 409 mengembalikan 'contactId' yang sudah ada. Impor: 'POST .../contacts/imports' (multipart 'file'), 'GET .../contacts/imports/{id}', 'PATCH' '{mapping, options}', 'POST .../validate', 'POST .../run', 'POST .../cancel', 'GET .../errors.csv?lang=ar' ('lang': en, ar, fr, es, pt, de, tr, id, hi or your). 'GET' dari impor yang selesai mengembalikan 'audience' ('id', 'name', 'memberCount') — daftar di atas.

Terkait

• Kontak
• Daftar dan segmen (audiens)
• Persetujuan dan opt-out
• Kolom kontak kustom
• Siaran WhatsApp