> For the complete documentation index, see [llms.txt](https://docs.watzap.id/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.watzap.id/help/list/import-kontak-melalui-paste-data.md).

# Import Kontak Melalui Paste Data

Salin data kontak dari Excel, Google Sheets, atau spreadsheet lain, lalu tempel langsung ke WatZap untuk membuat list atau menambah kontak ke list.

Dengan **Paste Data**, Kamu tidak perlu menyimpan file dulu. Cukup blok data kontak di Excel, Google Sheets, atau spreadsheet lain, salin, lalu tempel ke WatZap. WatZap mengenali kolomnya secara otomatis, lalu Kamu tinggal memeriksa jenis kolom sebelum kontak diimport.

Prosesnya sama dengan [Import Kontak dari File EXCEL/CSV/TXT](https://docs.watzap.id/help/list/import-kontak-dari-file-excel-csv-txt.md): **Preparation** → **Map Column** → **Duplicate Handling** → **Upload Contacts** → **Confirmation**.

{% hint style="info" %}
**Paste Data** hanya tersedia di paket **Premium**. Di paket Free, pilihan ini meminta Kamu upgrade paket. Di paket Personal dan Plus, pilihan ini tidak muncul. Gunakan [Import from File](https://docs.watzap.id/help/list/import-kontak-dari-file-excel-csv-txt.md) atau [Manual Input](https://docs.watzap.id/help/list/import-kontak-secara-manual.md).
{% endhint %}

## Sebelum mulai

Siapkan data di spreadsheet dengan aturan berikut:

1. **Baris pertama berisi judul kolom**, misalnya `Nama`, `No WhatsApp`, `Email`. Baris ini dipakai sebagai nama kolom, bukan sebagai kontak.
2. **Setiap baris punya minimal satu identitas**: nomor WhatsApp, email, atau keduanya. Baris tanpa keduanya akan dilewati.
3. **Nomor WhatsApp sebaiknya diawali kode negara**, misalnya `628123456789`. Nomor lokal seperti `08123456789` tetap diterima dan diubah otomatis ke format `62`.
4. **Batas data**: maksimal **8 kolom** dan **5.000 baris** kontak sekali tempel.

![Contoh data di spreadsheet yang akan disalin](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fr8uPN33MTmH8QcO6IQaC%2FJ3-1-00-contoh-data.png?alt=media)

Blok semua sel termasuk baris judul, lalu salin dengan **Ctrl+C** (di Mac: **Cmd+C**). Data yang disalin dari spreadsheet otomatis dipisahkan dengan tab. Data teks yang dipisahkan **koma** (`,`) atau **titik koma** (`;`) juga bisa ditempel.

## Langkah import melalui Paste Data

{% stepper %}
{% step %}

### Pilih Paste Data

Di menu samping, klik **Lists**. Di halaman **Manage Lists**, klik **Create New List**, lalu pilih **Paste Data** (1). Cara ini membuat list baru sekaligus mengisinya.

![Create New List → Paste Data](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FYbfjBtVt4Z5uepHdyi5w%2FJ3-1-01-create-paste-data.png?alt=media)

Ingin menambah kontak ke list yang sudah ada? Lihat bagian [Paste Data ke list yang sudah ada](#paste-data-ke-list-yang-sudah-ada).
{% endstep %}

{% step %}

### Kenali jendela Paste Data

Jendela **Paste Data** terbuka di langkah **Preparation**.

1. **Tempel data dari spreadsheet**: kotak untuk menempelkan data.
2. **Name Your List**: nama list baru.

![Jendela Paste Data](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FDR3TvBaxNwogluiSWR5B%2FJ3-1-02-modal-paste.png?alt=media)
{% endstep %}

{% step %}

### Tempel data dan beri nama list

1. Klik kotak **Tempel data dari spreadsheet**, lalu tempel data dengan **Ctrl+V** (di Mac: **Cmd+V**).
2. Klik di luar kotak, misalnya di kolom **Name Your List**. WatZap langsung memeriksa data dan menampilkan ringkasannya, misalnya `Detected: TAB delimited, 4 columns, 6 rows` dan `4 rows ready to import`. Baris tanpa nomor WhatsApp maupun email ditandai dengan warna oranye dan akan dilewati.
3. **Name Your List**: ketik nama list, misalnya `Pelanggan Toko Contoh`. Maksimal 50 karakter, berupa huruf, angka, spasi, atau tanda `#`, `@`, `.`.
4. Klik **Next**. Tombol ini baru aktif setelah data lolos pemeriksaan dan nama list diisi.

![Data sudah ditempel dan nama list diisi](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FNLWX5F0vWMh59Eesqs6q%2FJ3-1-03-data-ditempel.png?alt=media)

{% hint style="info" %}
Jumlah **rows** pada ringkasan ikut menghitung baris judul. Pada contoh di atas, `6 rows` berarti 1 baris judul dan 5 baris kontak.
{% endhint %}
{% endstep %}

{% step %}

### Map Column: periksa jenis setiap kolom

Halaman **Identify Your Columns** menampilkan kolom hasil tempel beserta dua contoh isinya. WatZap menebak jenis setiap kolom. Periksa hasilnya, terutama kolom teks seperti kota.

1. **Mapped**: kolom yang sudah punya jenis dan akan diimport.
2. Kolom `Kota` ikut terbaca sebagai nama.
3. Jenisnya **Full Name**. Kalau dibiarkan, isi kolom ini bisa menimpa nama kontak.

![Kolom Kota terbaca sebagai Full Name](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FZycxyoV5FdHFZwe6c0vW%2FJ3-1-04-kota-full-name.png?alt=media)

Klik dropdown jenis kolom `Kota`, gulir ke paling bawah, lalu pilih **Custom**. Di popup **Create New Column**, isi **Column Name** dengan `Kota`, lalu klik **Add New**.

1. Kolom `Kota` sekarang menjadi kolom tambahan bernama **Kota**.
2. Klik **Next**.

![Kolom Kota sudah menjadi kolom Custom](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FafqJqPQIUP1Y2lTxxQHm%2FJ3-1-05-kota-custom.png?alt=media)

Penjelasan lengkap setiap jenis kolom (**Skip**, **WhatsApp Number**, **Email**, **Full Name**, **First Name**, **Last Name**, **Custom**) dan tab **Configure** ada di [Import Kontak dari File EXCEL/CSV/TXT](https://docs.watzap.id/help/list/import-kontak-dari-file-excel-csv-txt.md).

{% hint style="warning" %}
Minimal satu kolom harus berjenis **WhatsApp Number** atau **Email**. Kalau belum, muncul pesan **Kolom Identitas Belum Dipilih** saat Kamu klik **Next**.
{% endhint %}
{% endstep %}

{% step %}

### Duplicate Handling: tentukan perlakuan data ganda

Pilih yang terjadi kalau kontak yang ditempel sudah ada di list:

1. **Skip**: data lama dibiarkan, baris yang ditempel tidak diimport ulang. Ini pilihan bawaan.
2. **Update**: nama dan kolom tambahan diganti dengan data baru. Nomor dan tanggal daftar tetap.
3. Klik **Next** untuk mulai mengunggah.

![Langkah Duplicate Handling](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F0hPJQVhDRlhilq6sbhvN%2FJ3-1-06-duplicate.png?alt=media)
{% endstep %}

{% step %}

### Upload Contacts dan Confirmation

WatZap mengunggah kontak di langkah **Upload Contacts**. Jangan tutup jendela sampai prosesnya selesai.

Setelah selesai, muncul **Progress is Completed**:

1. Ringkasan hasil import, misalnya `4 new contacts added` dan `1 row skipped (no valid WhatsApp number or email)`.
2. Klik **Finish**.

![Langkah Confirmation](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F3Bqd3zTExcHyf7eeuBAm%2FJ3-1-07-confirmation.png?alt=media)
{% endstep %}

{% step %}

### Cek hasilnya

List baru tampil di tabel **Manage Lists**. Klik nama list untuk melihat isinya. Kolom tambahan seperti `Kota` ikut tampil, nomor lokal sudah berubah ke format `62`, dan kontak tanpa email atau tanpa nomor ditandai `—`.

![Isi list hasil Paste Data](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FgkmdfdUx5RnT585CTKkv%2FJ3-1-08-isi-list.png?alt=media)
{% endstep %}
{% endstepper %}

## Paste Data ke list yang sudah ada

1. Di **Manage Lists**, klik nama list yang ingin ditambah kontaknya.
2. Klik **Add New** di kanan atas (atau **Add New Contact** di tengah halaman kalau list masih kosong), lalu pilih **Paste Data** (1).

![Add New → Paste Data di halaman list](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FqFdOatBWXDXvfNSC5uPE%2FJ3-1-09-add-new-paste.png?alt=media)

Langkahnya sama seperti di atas. Bedanya, **Name Your List** sudah terisi nama list dan tidak bisa diubah, dan kolom tambahan yang sudah ada di list bisa langsung dipilih dari bagian **CUSTOM COLUMNS** di langkah **Map Column**.

Sumber lain untuk mengisi list: [Import from File](https://docs.watzap.id/help/list/import-kontak-dari-file-excel-csv-txt.md), [Google Sheets](https://docs.watzap.id/help/list/import-kontak-melalui-google-sheets.md), [Manual Input](https://docs.watzap.id/help/list/import-kontak-secara-manual.md), [Sync from WhatsApp](https://docs.watzap.id/help/list/import-kontak-dari-whatsapp.md), dan [Group Grabber](https://docs.watzap.id/help/list/import-kontak-dari-group-grabber.md).

## Masalah umum

<details>

<summary>Muncul pesan "Too many columns"</summary>

Data yang ditempel berisi lebih dari 8 kolom (1). Hapus kolom yang tidak perlu di spreadsheet, salin ulang, lalu klik **Remove** dan tempel lagi.

![Pesan Too many columns](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Ftw271FKWhgQyEajw7Vxp%2FJ3-1-10-too-many-columns.png?alt=media)

</details>

<details>

<summary>Muncul pesan "Max 5.000 Rows."</summary>

Data berisi lebih dari 5.000 baris kontak. Pecah data menjadi beberapa bagian, lalu tempel satu per satu ke list yang sama lewat **Add New → Paste Data**.

</details>

<details>

<summary>Muncul pesan "We do not detect any values that recognized as a WhatsApp Number or an Email"</summary>

WatZap tidak menemukan kolom nomor WhatsApp maupun email. Pastikan baris pertama berisi judul kolom, nomor ditulis tanpa huruf, dan email ditulis lengkap.

</details>

<details>

<summary>Ringkasan tidak muncul dan tombol Next tetap abu-abu</summary>

Pemeriksaan data baru berjalan setelah Kamu klik di luar kotak tempel. Klik kolom **Name Your List**, lalu pastikan nama list sudah diisi.

</details>

<details>

<summary>Semua data terbaca sebagai satu kolom</summary>

Data tidak memakai pemisah yang dikenali. Salin langsung dari spreadsheet (pemisahnya tab), atau pastikan data teks dipisahkan dengan koma atau titik koma secara konsisten di setiap baris.

</details>

<details>

<summary>Jumlah kontak yang masuk lebih sedikit dari jumlah baris</summary>

Lihat ringkasan di langkah **Confirmation**. Baris bisa dilewati karena sudah ada di list (saat memilih **Skip**), atau karena tidak punya nomor WhatsApp maupun email yang valid.

</details>
