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 Arabic; dipisahkan koma, titik koma, atau tab) atau Excel .xlsx (sheet pertama). Hingga 20 MB dan 100.000 baris. File 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 menebaknya dari header dalam bahasa Inggris dan Arab (الجوال → Telepon (WhatsApp), الاسم → Nama, header yang cocok dengan kolom kustom → kolom tersebut). Atur kolom yang tidak Anda perlukan ke Jangan impor. Contoh menampilkan sebuah nilai dari file. 4. Di bawah Opsi: - Negara untuk nomor lokal: nomor yang ditulis tanpa kode negara (0501234567, atau 501234567 jika Excel menghilangkan angka nol) dibaca sebagai nomor negara ini. Angka Arab (٠٥٠...) tidak masalah. Kolom Negara di dalam file berlaku untuk barisnya. Awalnya diisi dengan negara perusahaan Anda. - 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). 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. 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). 10. Saat Anda melihat Impor selesai., tekan Lihat kontak yang diimpor untuk melihat daftarnya, atau Unduh errors.csv. Di bawah total, Semua orang yang dibuat atau diperbarui oleh impor ini ada di daftar "Import – customers.csv – 2026-09-24" (n orang). menyebutkan daftar yang dibuat oleh impor; Buka daftar membukanya 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 berisi nama kolom → tambahkan baris header.
• File memiliki lebih dari 100.000 baris atau File lebih besar dari 20 MB → pisahkan file.
• 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 di errors.csv, beserta alasannya: 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 dikenal, Nilai kolom kustom tidak sesuai dengan kolomnya (kolomnya disebutkan dalam detail: pilihan harus salah satu opsinya, tanggal berformat YYYY-MM-DD atau hari/bulan/tahun, angka hanya berupa digit), Kolom persetujuan harus berisi yes atau no, Sudah menjadi kontak - dilewati, Tidak dapat disimpan (coba impor baris tersebut lagi). errors.csv memiliki kolom-kolom file Anda sendiri, sehingga Anda dapat memperbaiki baris-barisnya dan mengimpornya sebagai file baru.
• 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 dan setidaknya salah satu dari Telepon (WhatsApp) (dengan kode negara, atau nomor lokal dari Negara yang Anda pilih), Email, atau Handle di platform lain beserta Platform-nya.
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 {name} telah ditambahkan. dan kontak terbuka.
5. Orang ini sudah ada di Kontak. → nomor atau e-mail tersebut milik seseorang; tekan Buka kontak.

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. GET untuk impor yang sudah selesai mengembalikan audience (id, name, memberCount) — daftar di atas.

Terkait

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