> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dripsender.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Mengatur Integrasi Google Sheets untuk Chat AI

> Panduan lengkap menghubungkan akun Google, menambahkan operasi Read (Lookup), Append baris baru, dan Delete data baris spreadsheet secara otomatis

Integrasi **Google Sheets Connector** memungkinkan Chat AI berinteraksi langsung dengan spreadsheet bisnis Anda. Bot dapat mencari (*lookup/read*), mencatat data baru (*append*), dan menghapus baris (*delete*) secara otomatis saat merespons pelanggan di WhatsApp.

## Prasyarat

> [!TIP]
>
> Akun Google aktif yang memiliki file spreadsheet Google Sheets.

> [!TIP]
>
> Spreadsheet sudah memiliki baris judul kolom di baris pertama (*header row*).

***

## 1. Menambahkan Akun Google

Sebelum membuat tool operasi spreadsheet, hubungkan akun Google Anda ke DripSender:

1. Buka menu **WhatsApp** > **Chat AI** > tab **Automation** > **Actions**.
2. Gulir ke bagian **Integrasi Tool AI**.
3. Di samping label *Akun Google Terhubung*, periksa apakah akun Anda sudah terdaftar.
4. Klik tombol **Tambah Integrasi**, lalu pilih konektor **Spreadsheet Google Sheets**:

![Pilihan Konektor Spreadsheet Google Sheets](https://mintcdn.com/dripsender/kIsn-jyNQ4PGY5vv/images/chat-ai/gs-menu-connectors.png?fit=max\&auto=format\&n=kIsn-jyNQ4PGY5vv\&q=85\&s=daba495f74e3e46cc44c8fa2a051f3e7)

5. Pada dropdown **Akun Google**, pilih opsi **＋ Hubungkan Akun Google Baru**.
6. Anda akan diarahkan ke halaman login dan persetujuan izin Google OAuth. Berikan izin akses Google Drive & Google Sheets, lalu selesaikan autentikasi.

![Menghubungkan Akun Google pada Integrasi Spreadsheet](https://mintcdn.com/dripsender/kIsn-jyNQ4PGY5vv/images/chat-ai/gs-account-connect.png?fit=max\&auto=format\&n=kIsn-jyNQ4PGY5vv\&q=85\&s=c97d752831e2b95e586d0e905f1e40df)

***

## 2. Menambahkan Read Integrasi (Tipe Operasi: Lookup / Search)

Operasi **Lookup / Search** digunakan saat AI perlu membaca atau mencari informasi data dari spreadsheet (contoh: mengecek sisa kuota paket umrah atau harga barang).

1. Buka formulir **Tambah Google Sheets**.
2. Pada dropdown **Tipe Operasi Tool**, pilih **Lookup / Search**.

![Memilih Tipe Operasi Lookup pada Google Sheets](https://mintcdn.com/dripsender/kIsn-jyNQ4PGY5vv/images/chat-ai/gs-operation-type.png?fit=max\&auto=format\&n=kIsn-jyNQ4PGY5vv\&q=85\&s=123a4a711483fb74aa4f9f7d67d7ebf9)

3. Lengkapi informasi dasar:
   * **Nama Integrasi:** `Cek Kuota Umrah`
   * **Function ID:** `check_kuota`
   * **Deskripsi untuk AI:** *"Panggil tool ini ketika user menanyakan sisa kuota seat untuk paket umrah pada bulan dan tahun tertentu."*
   * **Pilih Spreadsheet:** Pilih file spreadsheet dan nama sheet target.
4. **Parameter Input AI:** Klik **Tambah Parameter** untuk menentukan data yang harus diambil AI dari obrolan pelanggan (misal: parameter `nama_paket` dan `bulan_keberangkatan`).

![Menambahkan Parameter Input AI dan Mapping Kolom](https://mintcdn.com/dripsender/kIsn-jyNQ4PGY5vv/images/chat-ai/gs-parameters-mapping.png?fit=max\&auto=format\&n=kIsn-jyNQ4PGY5vv\&q=85\&s=92c09b3d26299a575f7c37b5636dd929)

5. **Mapping Kolom & Kondisi Filter:** Tentukan kondisi pencarian (*where clause*), contoh:
   * Kolom `Paket` = `nama_paket`
   * Kolom `Bulan` = `bulan_keberangkatan`
6. **Kolom Hasil Lookup (Output ke AI):** Tentukan kolom apa saja yang dikembalikan ke AI untuk dijawab ke pelanggan (misal kolom `Sisa_Seat`, `Harga`, dan `Status_Pendaftaran`).
7. Klik **Tambah Integrasi**.

***

## 3. Menambahkan Append (Pencatatan Data Baru)

Operasi **Append** digunakan untuk menambahkan baris data baru ke spreadsheet secara otomatis ketika pelanggan menyelesaikan pendaftaran, booking, atau pengisian formulir via chat WhatsApp.

![Menambahkan Operasi Append pada Google Sheets](https://mintcdn.com/dripsender/kIsn-jyNQ4PGY5vv/images/chat-ai/gs-append-operation.png?fit=max\&auto=format\&n=kIsn-jyNQ4PGY5vv\&q=85\&s=19980e5ffb7f3437c3ce3d9a1189dbed)

**1. 1. Pilih Tipe Operasi Append**

Buka formulir **Tambah Google Sheets**, lalu pada dropdown **Tipe Operasi Tool**, pilih opsi **Append**.

**2. 2. Tentukan Nama Integrasi dan Deskripsi**

* **Nama Integrasi:** `Catat Pendaftaran Jamaah`
* **Function ID:** `daftar_jamaah`
* **Deskripsi untuk AI:** *"Panggil tool ini setelah calon jamaah memberikan data lengkap (nama, nomor WA, paket, dan jumlah orang) untuk disimpan ke spreadsheet."*

**3. 3. Pilih Spreadsheet dan Sheet Target**

Tentukan file Google Sheets dan lembar kerja (*sheet tab*) tempat data baru akan dicatat.

**4. 4. Daftarkan Parameter Input AI**

Klik **Tambah Parameter** untuk setiap data yang harus diambil AI dari obrolan pelanggan:

* `nama_lengkap` (tipe: Text)
* `nomor_wa` (tipe: Text)
* `paket_pilihan` (tipe: Text)
* `jumlah_jamaah` (tipe: Angka)

**5. 5. Mapping Kolom Spreadsheet**

Pasangkan setiap parameter input AI ke kolom spreadsheet yang sesuai:

* Kolom A: `nama_lengkap`
* Kolom B: `nomor_wa`
* Kolom C: `paket_pilihan`
* Kolom D: `jumlah_jamaah`
* Kolom E: `Tanggal Input` (otomatis terisi timestamp waktu chat)

**6. 6. Simpan Integrasi**

Klik tombol **Tambah Integrasi** untuk mengaktifkan tool append.

***

## 4. Menambahkan Delete (Penghapusan Baris Data)

Operasi **Delete** digunakan ketika data baris di spreadsheet perlu dihapus secara otomatis berdasarkan kondisi tertentu (misalnya pembatalan booking atau nomor yang meminta berhenti berlangganan).

![Menambahkan Operasi Delete pada Google Sheets](https://mintcdn.com/dripsender/kIsn-jyNQ4PGY5vv/images/chat-ai/gs-delete-operation.png?fit=max\&auto=format\&n=kIsn-jyNQ4PGY5vv\&q=85\&s=a927eb189fbde361184a5df26ae763e0)

**1. 1. Pilih Tipe Operasi Delete**

Buka formulir **Tambah Google Sheets**, lalu pada dropdown **Tipe Operasi Tool**, pilih opsi **Delete**.

**2. 2. Tentukan Nama Integrasi dan Deskripsi**

* **Nama Integrasi:** `Hapus Booking Jamaah`
* **Function ID:** `cancel_booking`
* **Deskripsi untuk AI:** *"Panggil tool ini ketika jamaah menyatakan ingin membatalkan booking dengan menyebutkan nomor pesanan atau nomor WhatsApp terdaftar."*

**3. 3. Daftarkan Parameter Kunci Pencarian**

Klik **Tambah Parameter** dan daftarkan parameter unik sebagai acuan baris yang akan dihapus:

* `nomor_wa` (tipe: Text) atau `booking_id` (tipe: Text)

**4. 4. Tentukan Kondisi Baris yang Dihapus (Filter Clause)**

Cocokkan kolom spreadsheet dengan parameter input pencarian:

* Kolom `Nomor_WA` sama dengan (`=`) parameter `nomor_wa`.

**5. 5. Simpan Integrasi**

Klik tombol **Tambah Integrasi** untuk mengaktifkan tool delete.

***

## 5. Menguji Eksekusi Tool pada Obrolan WhatsApp

Setelah integrasi tersimpan dan statusnya aktif (*toggle hijau*):

1. Kirim pesan pengujian melalui WhatsApp:
   > *"Assalamu'alaikum, mau cek sisa seat untuk paket Umrah Reguler bulan November 2026 dong"*
2. AI secara cerdas akan:
   * Mendeteksi kebutuhan pengecekan data.
   * Memanggil fungsi Google Sheets `check_kuota`.
   * Mengambil angka sisa seat dari baris spreadsheet Anda.
   * Merespons calon jamaah dengan data kuota yang 100% akurat dan *real-time*.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.