> 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-google-sheets.md).

# Import Kontak Melalui Google Sheets

Import kontak langsung dari Google Sheets, lalu atur sinkronisasi supaya isi list selalu mengikuti sheet: manual, per jam, per hari, atau per minggu.

Lewat pilihan **Google Sheets**, WatZap membaca kontak langsung dari sheet Kamu. Bedanya dengan import biasa: list yang dibuat dari Google Sheets tetap **terhubung** dengan sheet tersebut. Setiap kali sinkronisasi berjalan, isi list disamakan dengan isi sheet.

Prosesnya: **Preparation** → **Map Column** → **Duplicate Handling** → **Sync Schedule** → **Upload Contacts** → **Confirmation**.

{% hint style="info" %}
Import dan sinkronisasi Google Sheets hanya tersedia di paket **Premium**. Di paket Free, pilihan ini meminta Kamu upgrade paket. Di paket Personal dan Plus, pilihan ini tidak muncul.
{% endhint %}

## Sebelum mulai

1. **Siapkan sheet** dengan baris pertama berisi judul kolom, dan setiap baris berisi minimal nomor WhatsApp atau email. Nomor sebaiknya diawali kode negara, misalnya `628123456789`.
2. **Batas data**: maksimal **8 kolom** dan **5.000 baris** kontak.
3. **Beri akses Viewer ke WatZap.** Di Google Sheets, klik **Share** (kanan atas), lalu pilih salah satu:
   * **Disarankan (sheet tetap privat)**: di kolom **Add people**, tambahkan email `watzap-gsheets@watzap-ai.iam.gserviceaccount.com` sebagai **Viewer**.
   * **Atau publik**: di bagian **General access**, ubah **Restricted** menjadi **Anyone with the link** dengan akses **Viewer**.
4. **Kalau sheet punya beberapa tab**, buka dulu tab yang ingin diimport, baru salin link-nya. WatZap membaca tab yang terbuka saat link disalin. Kalau link tidak menyebut tab, yang dibaca adalah tab pertama.

![Contoh isi sheet: baris pertama berisi judul kolom](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FXfbx4mkuE8w4WbFlMb5V%2FJ3-2-00-contoh-sheet.png?alt=media)

## Langkah import dari Google Sheets

{% stepper %}
{% step %}

### Pilih Google Sheets

Di menu samping, klik **Lists**. Di halaman **Manage Lists**, klik **Create New List**, lalu pilih **Google Sheets** (1).

![Create New List → Google Sheets](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FryG773LgbsXa0V197WvI%2FJ3-2-01-create-google-sheets.png?alt=media)
{% endstep %}

{% step %}

### Lihat panduan berbagi sheet

Jendela **Import from Google Sheets** terbuka.

1. Klik **Cara import dari Google Sheets** untuk membuka panduan singkat cara berbagi sheet.
2. Klik **Copy** untuk menyalin email WatZap yang perlu Kamu tambahkan sebagai **Viewer** di sheet.

![Panduan berbagi sheet dan email WatZap](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F2Attj32S9ZSfGqnhUoeJ%2FJ3-2-02-cara-share.png?alt=media)
{% endstep %}

{% step %}

### Tempel link sheet dan beri nama list

1. **URL Google Sheets**: tempel link sheet, misalnya `https://docs.google.com/spreadsheets/d/...`. Kamu juga bisa klik **Paste** untuk menempelkan isi clipboard. Kalau browser menolak akses clipboard, tempel secara manual dengan **Ctrl+V**.
2. Klik **Fetch Sheet**. Tombol ini baru aktif setelah link berformat Google Sheets.
3. **Name Your List**: ketik nama list, misalnya `Pelanggan Google Sheets`. Maksimal 50 karakter.

![URL Google Sheets, Fetch Sheet, dan nama list](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FoVJK2OY0knRed5gXxwbu%2FJ3-2-03-url-fetch.png?alt=media)
{% endstep %}

{% step %}

### Pastikan sheet berhasil dibaca

1. Setelah sheet terbaca, muncul keterangan hijau, misalnya `✓ Fetched 5 rows. Ready. Click Next to map columns.` Angka ini ikut menghitung baris judul.
2. Tombol **Fetch Sheet** berubah menjadi **Cancel**. Klik **Cancel** kalau ingin mengganti link.
3. Klik **Next**.

![Sheet berhasil dibaca](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FiEeh8cwLJkIz348mB3UE%2FJ3-2-04-fetched.png?alt=media)
{% endstep %}

{% step %}

### Map Column: periksa jenis setiap kolom

Halaman **Identify Your Columns** menampilkan kolom dari sheet. Periksa jenis setiap kolom, sama seperti saat [Import Kontak dari File EXCEL/CSV/TXT](https://docs.watzap.id/help/list/import-kontak-dari-file-excel-csv-txt.md). Kolom teks seperti `Kota` bisa ikut terbaca sebagai **Full Name**. Ubah ke **Custom** bila perlu.

1. **Mapped**: kolom yang akan diimport.
2. Klik **Next**.

![Halaman Identify Your Columns](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FKLp70qrM1UNZZfWyeCNp%2FJ3-2-05-map-column.png?alt=media)
{% endstep %}

{% step %}

### Duplicate Handling

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

1. **Skip**: data lama dibiarkan. Ini pilihan bawaan.
2. **Update**: nama dan kolom tambahan diganti dengan data dari sheet. Nomor dan tanggal daftar tetap.
3. Klik **Next**.

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

{% step %}

### Sync Schedule: pilih frekuensi sinkronisasi

1. **Frekuensi sinkronisasi**: pilih seberapa sering list disamakan dengan sheet.
   * **Manual**: list hanya diperbarui saat Kamu klik **Sync now**.
   * **Per Jam**, **Per Hari**, **Per Minggu**: list diperbarui otomatis sesuai jadwal.
2. Baca peringatan **Sheet jadi acuan utama list**: kontak yang dihapus dari sheet juga ikut hilang dari list saat sinkronisasi berjalan.
3. Klik **Next** untuk mulai mengunggah.

![Langkah Sync Schedule](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FdfPwF6NenlG5yuGORwUu%2FJ3-2-06-sync-schedule.png?alt=media)

Sync manual lewat tombol **Sync now** tetap bisa dipakai kapan saja, apa pun frekuensi yang Kamu pilih.
{% endstep %}

{% step %}

### Upload Contacts dan Confirmation

WatZap mengunggah kontak, lalu menyimpan pengaturan sinkronisasi. Jangan tutup jendela sampai selesai.

1. Ringkasan hasil import, misalnya `4 new contacts added`.
2. Klik **Finish**.

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

Kalau kontak sudah terunggah tetapi pengaturan sinkronisasi gagal disimpan, muncul judul **Sync Google Sheets Belum Aktif**. Klik **Retry saving sync** untuk mencoba lagi.
{% endstep %}
{% endstepper %}

## Mengelola list yang terhubung Google Sheets

List yang terhubung ditandai label **Google Sheets** (1) di tabel **Manage Lists**.

![Label Google Sheets di Manage Lists](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FbNvnX6rjltx4Q3j1Gw3y%2FJ3-2-08-badge-google-sheets.png?alt=media)

Untuk mengubah pengaturannya, klik ikon **⋮** di baris list, lalu pilih **Settings** (1) di bagian **Google Sheets**.

![Menu ⋮ → Google Sheets → Settings](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FvQl4262xxNdc6bNCnWjH%2FJ3-2-09-menu-settings.png?alt=media)

Jendela **Pengaturan Sync** berisi:

1. **URL Google Sheets**: sheet sumber list ini. Klik ikon salin untuk menyalin link-nya.
2. **Frekuensi sinkronisasi**: ganti jadwal **Manual**, **Per Jam**, **Per Hari**, atau **Per Minggu**.
3. **Sync now**: samakan list dengan sheet sekarang juga. Di sebelahnya tertulis **Last sync**, waktu sinkronisasi terakhir.
4. **Stop Sync**: putuskan hubungan list dengan sheet. Kontak yang sudah ada tetap tersimpan di list, tetapi tidak lagi diperbarui dari sheet.
5. **Simpan**: simpan perubahan frekuensi.

![Jendela Pengaturan Sync](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fzc9M9cVt4DLIRh8kpBOl%2FJ3-2-10-pengaturan-sync.png?alt=media)

Setelah **Sync now** selesai, muncul ringkasan **Sync selesai**: jumlah kontak yang ditambahkan, diperbarui, dihapus dari list, dan dilewati.

![Ringkasan Sync selesai (angka pada contoh ini ilustrasi)](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F0SkwMqY40k1bimk29481%2FJ3-2-11-hasil-sync.png?alt=media)

Di halaman detail list, tombol **Add New** diganti tombol **Settings** (1), karena isi list mengikuti sheet. Di atas tabel juga ada **Last sync** dan tombol **Sync now** (2).

![Halaman list yang terhubung Google Sheets](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FLgj1JOUoh3POBuXTp8TB%2FJ3-2-12-detail-list.png?alt=media)

## Cara kerja sinkronisasi

* **Sheet adalah acuan utama.** Baris baru di sheet ditambahkan ke list, perubahan nama atau kolom diperbarui, dan kontak yang dihapus dari sheet ikut dihapus dari list.
* **Kontak ganda dideteksi dari nomor WhatsApp**, bukan dari nama. Nomor yang sama hanya disimpan 1 kali.
* **Kontak yang hanya punya email**: kalau sheet punya kolom nomor WhatsApp, kontak tanpa nomor di list tidak ikut terhapus. Kalau sheet memakai email sebagai identitas (tanpa kolom nomor), email itulah yang dicocokkan.
* **Pengaman**: kalau sheet gagal dibaca atau tidak berisi baris valid sama sekali, sinkronisasi dibatalkan dan tidak ada kontak yang dihapus.
* **Batas**: sinkronisasi dibatalkan bila sheet berisi lebih dari 5.000 baris valid.
* **Jadwal otomatis** butuh paket Premium yang aktif. Bila paket tidak lagi Premium, jadwal otomatis berhenti.

{% hint style="warning" %}
Google Sheets juga bisa dipilih lewat **Add New → Google Sheets** di list yang sudah berisi kontak. Setelah itu list tersebut ikut terhubung dengan sheet, sehingga kontak lama yang tidak ada di sheet akan terhapus saat sinkronisasi berikutnya. Kalau ingin aman, buat list baru khusus untuk sheet.
{% endhint %}

## Masalah umum

<details>

<summary>Muncul pesan "Sheet belum bisa diakses..."</summary>

WatZap belum punya akses ke sheet (1). Tambahkan `watzap-gsheets@watzap-ai.iam.gserviceaccount.com` sebagai **Viewer**, atau ubah **General access** menjadi **Anyone with the link** (Viewer), lalu klik **Fetch Sheet** lagi.

![Pesan sheet belum bisa diakses](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FCiG8NzgoPBOuGlfCOjVl%2FJ3-2-13-belum-dibagikan.png?alt=media)

</details>

<details>

<summary>Tombol Fetch Sheet tetap abu-abu</summary>

Link belum berformat Google Sheets. Pastikan link berisi `docs.google.com/spreadsheets/d/...`, bukan link folder Google Drive atau file Excel di Drive.

</details>

<details>

<summary>Muncul pesan "Spreadsheet tidak ditemukan. URL salah?"</summary>

Link salah atau sheet sudah dihapus. Buka link itu di browser untuk memastikan, lalu salin ulang dari tombol **Share → Copy link**.

</details>

<details>

<summary>Muncul pesan "Too many columns" atau "Max 5.000 Rows."</summary>

Sheet berisi lebih dari 8 kolom atau lebih dari 5.000 baris kontak. Pindahkan data ke tab baru yang hanya berisi kolom yang diperlukan, atau pecah menjadi beberapa sheet dan list.

</details>

<details>

<summary>Muncul pesan "Sync baru saja dijalankan. Coba lagi dalam ... detik."</summary>

**Sync now** hanya bisa diklik sekali per menit. Tunggu hitung mundur di tombol (**Coba lagi ...s**) selesai, lalu klik lagi.

</details>

<details>

<summary>Muncul pesan "Fitur Premium" saat memilih Per Jam, Per Hari, atau Per Minggu</summary>

Jadwal sinkronisasi otomatis hanya tersedia di paket **Premium**. Klik **Upgrade Now**, atau gunakan **Manual**.

</details>

<details>

<summary>Data yang masuk bukan dari tab yang Kamu maksud</summary>

WatZap membaca tab yang tercantum di link (bagian `#gid=` di akhir link). Buka tab yang benar di Google Sheets, salin ulang link-nya, lalu import ulang.

</details>
