> ## 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.

# Cara Mengatur Integrasi Google Sheets pada Agent AI

> Panduan langkah demi langkah menghubungkan Google Sheets sebagai tool AI: menghubungkan akun Google, mengatur operasi Read (Lookup), Append baris baru, Update, dan Delete data baris

Integrasi **Google Sheets** memungkinkan Agent AI berinteraksi langsung dengan spreadsheet bisnis Anda secara realtime. Bot dapat membaca data stok/harga (*Lookup / Search*), mencatat prospek atau pesanan baru (*Append*), memperbarui status transaksi (*Update*), serta menghapus data baris (*Delete*) secara otomatis saat sedang melayani pelanggan di WhatsApp.

## Prasyarat

> [!TIP]
>
> File Google Spreadsheet Anda sudah memiliki baris header kolom (misalnya: `Nama`, `Nomor_WA`, `Produk`, `Harga`, `Status`).

> [!TIP]
>
> Akun Google (Gmail/Google Workspace) yang memiliki akses edit ke spreadsheet tersebut sudah siap.

> [!TIP]
>
> Akun Anda memiliki akses ke instance WhatsApp di portal DripSender.

***

## 1. Memilih Google Sheets pada Menu Integrasi (Step 1)

1. Buka menu **Agent AI** di portal DripSender, lalu klik tab **Tools**.
2. Pada bagian bawah kartu **Integrasi**, klik tombol **Tambah Integrasi**.
3. Di jendela pemilihan konektor, pilih kartu **Spreadsheet - Google Sheets** yang ditandai kotak merah:

![Memilih Spreadsheet Google Sheets pada Modal Connector](https://mintcdn.com/dripsender/VKy8eMl5dLP2MOYU/images/agent-ai/gsheet-01-pilih.png?fit=max\&auto=format\&n=VKy8eMl5dLP2MOYU\&q=85\&s=0488f8616f53223008e145bbd24bb365)

***

## 2. Menghubungkan Akun Google dan Memilih Tipe Operasi (Step 2)

Di jendela konfigurasi **Tambah Google Sheets**, perhatikan bagian **1 Koneksi & Operasi Tool**:

![Formulir Bagian 1 Koneksi dan Operasi Tool Google Sheets](https://mintcdn.com/dripsender/VKy8eMl5dLP2MOYU/images/agent-ai/gsheet-02-koneksi-operasi.png?fit=max\&auto=format\&n=VKy8eMl5dLP2MOYU\&q=85\&s=bcc5f6b36038c9caaaad6fb7269d6af2)

### Menghubungkan Akun Google (Google OAuth)

1. Pada baris **Akun Google**, klik tombol biru **Hubungkan Google Sheets** jika belum ada akun terhubung.
2. Jendela otorisasi Google akan terbuka. Pilih akun Google Anda dan berikan izin akses (*permission*) agar DripSender dapat mengakses Google Drive & Spreadsheet Anda.
3. Setelah terhubung, email Google Anda akan ditampilkan sebagai akun aktif.

### Memilih Tipe Operasi Tool

Pilih salah satu dari 4 jenis operasi pada menu dropdown:

* **Lookup / Search (Read)**: Mencari dan membaca data baris spreadsheet (misal cek status pesanan, kuota, atau harga).
* **Append**: Menambahkan baris data baru ke baris paling bawah spreadsheet (misal mencatat pesanan baru atau formulir pendaftaran).
* **Update**: Mencari baris yang cocok lalu memperbarui nilai kolom tertentu (misal mengubah status pesanan dari `Pending` menjadi `Lunas`).
* **Delete**: Mencari dan menghapus baris data (misal membatalkan antrean atau pemesanan).

4. Masukkan **Nama Integrasi** (contoh: `Cari Stok & Harga Kopi`) dan tuliskan **Deskripsi untuk AI** yang menjelaskan kapan tool ini harus dieksekusi.

***

## 3. Menentukan Parameter Input AI (Step 3)

Pada bagian **2 Parameter Input AI**, tentukan data apa saja yang perlu dikumpulkan oleh model AI dari chat pelanggan sebelum menjalankan operasi spreadsheet:

![Bagian 2 Parameter Input AI Google Sheets](https://mintcdn.com/dripsender/VKy8eMl5dLP2MOYU/images/agent-ai/gsheet-03-parameter.png?fit=max\&auto=format\&n=VKy8eMl5dLP2MOYU\&q=85\&s=57ee165d535428b7b5a05d06de81a177)

1. Klik tombol **Tambah Parameter**.
2. Masukkan nama parameter input (misalnya: `nama_produk` atau `nomor_wa`).
3. Parameter ini akan digunakan sebagai variabel pencocokan baris pada langkah berikutnya.

***

## 4. Mengatur Mapping Kolom dan Kondisi Filter (Step 4)

Pada bagian **3 Mapping Kolom & Kondisi (Lookup / Search)**:

![Bagian 3 Mapping Kolom dan Kondisi Filter](https://mintcdn.com/dripsender/VKy8eMl5dLP2MOYU/images/agent-ai/gsheet-04-mapping.png?fit=max\&auto=format\&n=VKy8eMl5dLP2MOYU\&q=85\&s=17553d63a05d76e63bbd857c54f0a083)

1. Tentukan kondisi pencocokan (*Where Clause*):
   Pilih kolom spreadsheet yang menjadi acuan (misal kolom `Produk` di Google Sheets) dan cocokkan dengan parameter input AI `{{nama_produk}}`.
2. AI akan memindai baris spreadsheet yang memiliki nilai kolom yang cocok dengan input pelanggan tersebut.

***

## 5. Menentukan Kolom Hasil Output ke AI (Step 5)

Pada bagian **4 Kolom Hasil Lookup (Output Data ke AI)**, tentukan kolom data spreadsheet mana saja yang ingin diambil dan dikembalikan ke AI untuk dijawab ke pelanggan:

![Bagian 4 Kolom Hasil Lookup Output Data ke AI](https://mintcdn.com/dripsender/VKy8eMl5dLP2MOYU/images/agent-ai/gsheet-05-hasil.png?fit=max\&auto=format\&n=VKy8eMl5dLP2MOYU\&q=85\&s=4c64a1cbd80bf84fa1a217b7d972f69c)

1. Klik tombol **+ Hasil**.
2. Pilih kolom data yang relevan (misalnya: kolom `Harga`, `Stok`, dan `Deskripsi`).
3. Model AI akan membaca nilai dari kolom-kolom ini lalu menyusun kalimat balasan yang ramah dan rapi ke pelanggan WhatsApp.
4. Klik tombol biru **Tambah Integrasi** untuk menyimpan konfigurasi.

***

## 6. Contoh Skenario Tambahan: Operasi Append dan Delete

### Operasi Append (Mencatat Pesanan Baru)

* Pilih tipe operasi **Append**.
* Daftarkan parameter input: `nama_pelanggan`, `nama_produk`, `alamat`.
* Petakan ke kolom Google Sheets:
  * Kolom `Nama` diisi `nama_pelanggan`.
  * Kolom `Produk` diisi `nama_produk`.
  * Kolom `Alamat` diisi `alamat`.
  * Kolom `Waktu` diisi tanggal otomatis.

### Operasi Delete (Membatalkan Booking)

* Pilih tipe operasi **Delete**.
* Tentukan kondisi filter: baris di mana kolom `Kode_Booking` sama dengan parameter input pelanggan `{{kode_booking}}`.
* Saat pelanggan meminta pembatalan di chat, baris data tersebut akan otomatis dihapus dari spreadsheet.

***

## 7. Menguji Integrasi di Playground

1. Buka tab [Uji Coba (Playground)](https://docs.dripsender.id/agent-ai/playground.md).
2. Kirim pesan pengujian:
   * Untuk **Lookup**: *"Tolong cek apakah Arabica Gayo stoknya masih ada?"*.
   * Untuk **Append**: *"Saya mau pesan Arabica Gayo 2 pack, nama Budi Santoso alamat Menara Sudirman Lantai 12"*.
3. Periksa file Google Spreadsheet Anda secara langsung untuk memastikan data berhasil terbaca, bertambah, atau terupdate secara otomatis.


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