## Langkah 1. Tambahkan node Webhook
Setelah aliran IoT Logic Anda dibuat, tambahkan node Webhook dan hubungkan ke pemicu yang akan memulai transmisi data.
Node Webhook bekerja sebagai mekanisme fire-and-forget. Ini berarti node tersebut mengirim permintaan HTTP segera saat dipicu, tetapi tidak menunggu atau menyimpan respons server.
Setelah menambahkan node Webhook, konfigurasikan sebagai berikut.
#### URL
Masukkan URL Web App Google Apps Script yang terkait dengan Google Sheet tempat Anda ingin mengirim informasi.
#### Header
Tambahkan header HTTP berikut:
| Kunci | Nilai |
| ----------- | ---------------- |
| Tipe konten | application/json |
#### Badan
Isi permintaan harus dalam format JSON. Isi tersebut harus menyertakan kunci autentikasi dan data apa pun yang ingin Anda kirim ke Google Sheets.
Contoh:
*{*
*"key": "MY\_SUPER\_SECRET\_123",*
*"event": "laporan\_bahan\_bakar\_pagi",*
*"device\_id": "{{device\_label}}",*
*"timestamp": "{{comb\_current\_time}}"*
*}*
Anda dapat menyertakan atribut IoT Logic atau parameter telemetri tambahan dengan menggunakan placeholder yang sesuai.
Catatan: bidang "key" diperlukan jika Google Apps Script Anda menggunakan rahasia bersama untuk mengautentikasi permintaan Webhook yang masuk. Ganti "MY\_SUPER\_SECRET\_123" dengan rahasia yang dikonfigurasikan di Google Apps Script Anda.
## Langkah 2. Siapkan Google Sheet
Buka Google Sheet Anda, klik Extensions, lalu pilih Apps Script.
Ini akan membuka file Code.gs, tempat Anda akan menambahkan skrip yang bertanggung jawab untuk menerima permintaan Webhook dan menulis data ke dalam spreadsheet.
Contoh kode berikut dapat digunakan untuk menerima nilai yang dikirim dari node Webhook dan menambahkannya sebagai baris baru di Google Sheet Anda.
*function doPost(e) {*
*var SECRET\_KEY = "MY\_SUPER\_SECRET\_123";*
*var data = JSON.parse(e.postData.contents);*
*if (data.key !== SECRET\_KEY) {*
*return ContentService.createTextOutput("Access Denied").setMimeType(ContentService.MimeType.TEXT);*
*}*
*var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();*
*sheet.appendRow(\[*
*new Date(),*
*data.name || "",*
*data.device\_id || "",*
*data.longitud || "",*
*data.latitud || ""*
*]);*
*return ContentService.createTextOutput("Success").setMimeType(ContentService.MimeType.TEXT);*
*}*
**Catatan**: Ganti contoh kode di atas dengan skrip yang disediakan di bawah. Anda juga dapat menyesuaikan bidang agar sesuai dengan data yang dikirim dari Webhook IoT Logic Anda.
Skrip di atas berfungsi sebagai endpoint HTTP POST yang menerima permintaan yang dikirim dari node Webhook IoT Logic.
Setiap kali sebuah permintaan diterima, skrip terlebih dahulu memvalidasi rahasia bersama (SECRET\_KEY) untuk memastikan bahwa hanya permintaan Webhook yang berwenang yang diizinkan menulis data ke Google Sheet. Jika autentikasi berhasil, payload JSON diurai dan parameter yang ditentukan—seperti stempel waktu penerimaan, nama perangkat, ID perangkat, bujur, lintang, atau nilai telemetri lainnya—secara otomatis ditambahkan sebagai baris baru di spreadsheet.
Akhirnya, skrip mengembalikan respons yang menunjukkan apakah operasi telah selesai dengan berhasil (Berhasil) atau ditolak karena kunci autentikasi yang tidak valid (Akses Ditolak).
Penting: Nama field yang digunakan dalam skrip harus persis cocok dengan nama parameter yang dikirim oleh IoT Logic Webhook. Setiap nilai diakses menggunakan sintaks data.\
Pilih New Deployment, lalu pilih Web App dari menu jenis deployment. Proses deployment mungkin memerlukan beberapa saat. Setelah selesai, URL Web App akan dibuat. Salin URL ini dan tempelkan ke kolom URL pada simpul Webhook di aliran IoT Logic Anda. URL Web App adalah endpoint yang akan menerima permintaan HTTP POST yang dikirim oleh simpul Webhook.
#### Memperbarui Apps Script
Jika Anda perlu memodifikasi Apps Script nanti, Anda tidak perlu membuat deployment baru.
Sebagai gantinya, klik Deploy → Manage Deployments, pilih deployment yang sudah ada, lalu klik Edit (ikon pensil). Setelah menyimpan dan menerapkan ulang versi yang diperbarui, perubahan yang dibuat pada skrip akan langsung berlaku sambil tetap menggunakan URL Web App yang sama.
Ini memungkinkan Anda memperbarui skrip tanpa harus memodifikasi konfigurasi Webhook di IoT Logic.
Setelah menyelesaikan semua langkah yang dijelaskan dalam panduan ini, koneksi antara IoT Logic dan Google Sheets seharusnya berhasil dibuat.
Integrasi ini menyediakan cara yang sederhana dan efektif untuk mencatat data telemetri, parameter eksternal, atau atribut kustom IoT Logic untuk pelaporan, analisis, audit, atau integrasi dengan alat Google Workspace lainnya.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/expert-center/id/faq-and-troubleshooting/iot-logic/how-to-connect-an-iot-logic-webhook-node-to-google-sheets.md?ask=