
# Mengimpor Kontak dari File

Jika Anda memiliki daftar kontak dalam spreadsheet, Anda dapat mengunggah semuanya sekaligus alih-alih menambahkannya satu per satu. Aplikasi ini menggunakan wizard 3 langkah — **Unggah → Petakan kolom → Tinjau** — yang berfungsi dengan file CSV yang sudah Anda miliki, tanpa perlu mengunduh templat terlebih dahulu.


---

## Cara Mengimpor Kontak

1. Klik **Contacts** di bilah sisi kiri, lalu klik **Import** di bagian atas halaman.
2. **Upload.** Seret file CSV Anda ke zona lepas (dropzone), atau klik untuk menelusuri. Tidak perlu mengunduh templat terlebih dahulu — gunakan file yang sudah Anda miliki.


3. **Petakan kolom.** Wizard akan membaca baris header file Anda dan mencoba mencocokkan setiap kolom secara otomatis ke bidang target: **Nama depan, Nama belakang, Telepon, Email, Tag, Catatan**, atau **Jangan impor**. Periksa tebakan setiap kolom dan perbaiki jika ada yang salah menggunakan pemilih di sebelahnya. Tabel pratinjau akan menampilkan beberapa baris pertama persis seperti saat diimpor nanti.
   * **Kolom nomor telepon wajib diisi** — Anda tidak dapat melanjutkan tanpa memetakan satu kolom pun.
   * Kolom yang dipetakan ke **Tag** akan menjadi tag nyata pada setiap kontak. Beberapa tag dalam satu sel tidak masalah — pisahkan dengan koma atau titik koma (`vip; newsletter; hotmart`). Tag yang belum ada akan dibuatkan untuk Anda; tag yang sudah ada akan digunakan kembali, dengan mengabaikan penggunaan huruf besar/kecil.


4. **Tinjau.** Pilih:
   * **Saluran default** — WhatsApp Business, WhatsApp Web, atau SMS. Ini berlaku untuk setiap kontak yang diimpor yang belum menentukan saluran.
   * **Daftar** — pilih daftar yang sudah ada dari menu tarik-turun, atau ketik nama untuk membuat daftar baru secara langsung. Anda hanya dapat memilih salah satu, tidak keduanya.
   * **Perbarui kontak yang ada** — nonaktif secara default. Jika nonaktif, baris yang cocok dengan kontak yang sudah Anda miliki (nomor telepon yang sama) akan dilewati sebagai duplikat: tidak ada yang berubah pada kontak tersebut dan kontak **tidak** ditambahkan ke daftar. Jika aktif, baris tersebut justru akan **memperbarui** kontak: nama, email, dan catatan dalam file Anda akan menimpa data yang ada (sel kosong akan membiarkan nilai saat ini tetap apa adanya), tag apa pun dalam baris tersebut akan ditambahkan, dan kontak akan ditambahkan ke daftar yang Anda pilih. Ini adalah cara Anda mengimpor ulang file untuk memperbaiki atau memperkaya kontak yang sudah Anda miliki.


5. Klik **Impor [count]**. Anda akan diarahkan ke layar hasil yang menunjukkan berapa banyak kontak yang dibuat, berapa banyak kontak yang ada yang diperbarui (saat opsi tersebut aktif), dan, jika ada baris yang dilewati, rincian alasannya (nomor telepon tidak valid, nomor telepon hilang, duplikat, batas kontak tercapai, dll.).

---

## Detail Pemetaan Kolom

* **Telepon** adalah satu-satunya kolom yang wajib diisi. Baris tanpa nomor telepon sama sekali akan dibuang sebelum impor dan dihitung secara terpisah di layar hasil.
* **Nama depan / Nama belakang / Email** dipetakan langsung ke bidang dasar kontak.
* **Catatan** dipetakan ke bidang [Catatan / Profil Prospek](custom-contact-fields.md#notes-lead-profile) kontak.
* **Tag** membuat (atau menggunakan kembali) tag nyata dan menerapkannya ke kontak — tag yang sama yang Anda gunakan untuk memfilter, menargetkan siaran, dan memicu webhook. Masukkan beberapa tag dalam satu sel yang dipisahkan dengan koma atau titik koma. Sebelum 19 Agustus 2026, kolom ini disimpan sebagai bidang kustom bernama `tags`; jika Anda mengimpor sebelum tanggal tersebut, impor ulang file yang sama dengan **Perbarui kontak yang ada** aktif dan tag akan diterapkan dengan benar (bidang kustom `tags` yang tersisa tidak akan menimbulkan masalah; hubungi dukungan jika Anda ingin menghapusnya dari setiap kontak).
* Saat ini tidak ada pemetaan kolom untuk bidang kustom arbitrer (seperti kolom `custom_<fieldname>` klasik) — lihat [Pemuatan Massal Bidang Kustom](custom-contact-fields.md#bulk-loading-custom-fields) untuk solusi saat ini.

---

## Tips

- Periksa kembali apakah nomor telepon menyertakan kode negara. Tanpanya, pesan tidak akan terkirim — dan baris tanpa nomor telepon yang dapat digunakan akan dilewati sepenuhnya.
- Anda tidak perlu menghapus spasi, tanda hubung, atau tanda kurung dari nomor telepon — pengimpor menoleransi pemformatan umum, tetapi tetap memerlukan kode negara.
- File diurai sepenuhnya di browser Anda, jadi tidak ada batas ukuran unggahan tetap dari wizard itu sendiri — tetapi jumlah total kontak Anda tetap dibatasi oleh paket Anda. Jika impor membuat Anda melebihi batas paket, baris tersebut akan ditolak dan muncul di layar hasil sebagai `contact_limit_reached`.
- Jika kontak dengan nomor telepon yang sama sudah ada, baris tersebut akan dilewati secara default — baris tersebut muncul sebagai `duplicate` di layar hasil. Impor tidak akan pernah membuat salinan kedua dari seseorang. Untuk mengedit massal kontak yang sudah Anda miliki (memperbaiki nama atau email, menambahkan tag, memasukkannya ke daftar), aktifkan **Perbarui kontak yang ada** pada langkah Tinjau dan impor ulang file tersebut.

---

## Pertanyaan yang Sering Diajukan

**CSV saya memiliki kolom `custom_company` dari ekspor lama — apakah akan dipetakan dengan benar?**
Tidak secara otomatis. Pencocokan otomatis wizard hanya mengenali header nama/telepon/email/tag/catatan; yang lainnya secara default menjadi **Jangan impor**, jadi kolom `custom_company` tidak akan mengisi kolom kustom `company` dengan sendirinya. Tambahkan nilainya setelahnya melalui [Kolom Kustom](custom-contact-fields.md), atau melalui API.

**Ke mana perginya tombol "Unduh Templat"?**
Tombol tersebut sudah tidak ada — wizard bekerja langsung dengan CSV apa pun yang sudah Anda miliki dan memungkinkan Anda memperbaiki kolom yang tidak cocok di langkah Petakan.

**Saya sudah mengimpor kontak saya — bagaimana cara menambahkan tag atau memperbaiki bidang untuk semuanya sekaligus?**
Impor ulang file yang sama (atau file yang diperbarui) dengan **Perbarui kontak yang ada** diaktifkan pada langkah Tinjau. Baris yang cocok dengan nomor telepon yang ada akan memperbarui kontak tersebut — nama, email, catatan, tag, dan daftar — alih-alih dilewati. Hanya nomor telepon yang digunakan untuk mencocokkan, jadi pertahankan kolom tersebut persis seperti sebelumnya.

**Bisakah saya mengimpor kontak Instagram atau Messenger dari sebuah file?**
Tidak. Impor hanya mendukung WhatsApp Business, WhatsApp Web, dan SMS, karena saluran tersebut menjangkau orang melalui nomor telepon. Sebaliknya, Instagram dan Messenger mengidentifikasi orang berdasarkan akun sosial mereka, sehingga kontak tersebut dibuat secara otomatis saat seseorang mengirim pesan kepada Anda di saluran tersebut.

**Bisakah saya mengimpor kontak sebagai tidak aktif bot?**
Tidak ada kolom per baris untuk itu. Impor batch terlebih dahulu, lalu gunakan tindakan massal **Bot mati** pada kontak yang diimpor — lihat [Mengecualikan Kontak dari Bot AI](excluding-contacts-from-bot.md).

---

## Langkah Selanjutnya

- [Mengatur Daftar & Kontak](list-and-contact-management.md) — mengelola dan mengurutkan kontak yang baru saja Anda impor.
- [Beralih dari Kampanye ke Siaran & Agen](../moving-from-campaigns.md) — mulai mengirim pesan ke daftar yang telah Anda impor.
- [Bidang Kustom, Profil Prospek & Catatan](custom-contact-fields.md) — lengkapi detail yang lebih kaya setelah impor.
