> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/id/faq-and-troubleshooting/iot-logic/how-to-connect-an-iot-logic-webhook-node-to-google-sheets.md).

# Cara menghubungkan node Webhook IoT Logic ke Google Sheets

Kirim parameter telematika dari alur IoT Logic ke Google Sheets menggunakan node Webhook. Mencakup penyiapan node, Apps Script, dan tingkat akses penerapan.

Dalam panduan ini, Anda akan mempelajari cara mengirim parameter telematika atau nilai Sumber Data eksternal dari aliran IoT Logic Navixy ke Google Sheets menggunakan simpul Webhook.

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-f544d4617278d8ad1629d66b08f1e877b9f454e5%2Funknown.png?alt=media" alt="" height="236" width="624">

## Langkah 1. Tambahkan simpul Webhook

Setelah aliran IoT Logic Anda dibuat, tambahkan simpul Webhook dan hubungkan ke pemicu yang akan memulai transmisi data.

Simpul Webhook bekerja sebagai mekanisme kirim-sekali tanpa menunggu balasan. Ini berarti simpul ini mengirim permintaan HTTP segera saat dipicu, tetapi tidak menunggu atau menyimpan respons server.

Setelah menambahkan simpul Webhook, konfigurasikan seperti 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 |

#### Bodi

Badan permintaan harus dalam format JSON. Badan tersebut harus menyertakan kunci autentikasi dan data apa pun yang ingin Anda kirim ke Google Sheets.

Contoh:

*{*

*"key": "MY\_SUPER\_SECRET\_123",*

*"peristiwa": "laporan Bahan bakar pagi",*

*"device\_id": "{{device\_label}}",*&#x20;

*"timestamp": "{{comb\_current\_time}}"*

*}*

Anda dapat menyertakan atribut IoT Logic atau parameter telemetri tambahan apa pun dengan menggunakan placeholder yang sesuai.

Catatan: Kolom "key" diperlukan jika Google Apps Script Anda menggunakan rahasia bersama untuk mengautentikasi permintaan Webhook yang masuk. Ganti "MY\_SUPER\_SECRET\_123" dengan rahasia yang dikonfigurasi di Google Apps Script Anda.

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-00188a71e0e15866ed18ed4b944814c83b3e6fba%2Funknown.png?alt=media" alt="" height="497" width="309">

## Langkah 2. Siapkan Google Sheet

Buka Google Sheet Anda, klik Extensions, lalu pilih Apps Script.

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-23be490316c154d0e6539b82d26208a63ed4ee77%2Funknown.png?alt=media" alt="" height="277" width="624">

Ini akan membuka file Code.gs, tempat Anda akan menambahkan skrip yang bertanggung jawab untuk menerima permintaan Webhook dan menulis data ke dalam spreadsheet.

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-3889c1c758b5da1d2052650f7bd31f9e99bbfc9f%2Funknown.png?alt=media" alt="" height="249" width="624">

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 ini. Anda juga dapat menyesuaikan field agar sesuai dengan data yang dikirim dari IoT Logic Webhook.

Skrip di atas berfungsi sebagai titik akhir 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 sah yang diizinkan menulis data ke Google Sheet. Jika autentikasi berhasil, muatan JSON diurai dan parameter yang ditentukan—seperti stempel waktu penerimaan, nama perangkat, ID perangkat, garis bujur, garis lintang, atau nilai telemetri lainnya—secara otomatis ditambahkan sebagai baris baru di spreadsheet.

Akhirnya, skrip mengembalikan respons yang menunjukkan apakah operasi telah diselesaikan dengan sukses (Berhasil) atau ditolak karena kunci autentikasi yang tidak valid (Akses ditolak).

Penting: Nama field yang digunakan dalam skrip harus persis sama dengan nama parameter yang dikirim oleh Webhook IoT Logic. Setiap nilai diakses menggunakan sintaks data.\<parameter\_name>, di mana \<parameter\_name> sesuai dengan properti JSON yang diterima dalam permintaan.

Misalnya, jika Webhook mengirim parameter berikut:

*{*

*"fuel\_level": 68,5*

*}*

Apps Script harus merujuknya sebagai:

*data.fuel\_level*

Jika skrip justru mereferensikan:

*data.fuel\_level\_march*

Nilai tidak akan terisi karena tidak ada parameter dengan nama tersebut dalam payload JSON masuk. Akibatnya, sel yang sesuai di Google Sheets akan tetap kosong.

Ini adalah salah satu kesalahan konfigurasi paling umum saat mengintegrasikan IoT Logic Webhook dengan Google Sheets. Selalu verifikasi bahwa nama parameter dalam isi Webhook benar-benar cocok dengan yang digunakan dalam Apps Script, termasuk kapitalisasi, garis bawah, dan ejaan.

Setelah Anda selesai mencocokkan isi JSON dengan kode Apps Script Anda, klik tombol Deploy.

Pada bagian Who has access, pastikan untuk memilih Anyone.

Pengaturan ini diperlukan karena ketika simpul Webhook mengirim permintaan HTTP POST ke URL Web App Google Apps Script, permintaan tersebut diterima sebagai klien anonim (tanpa kredensial akun Google Anda).

Jika tingkat akses dikonfigurasi sebagai:

* Only myself – Google akan menolak permintaan atau meminta autentikasi.
* Anyone – Google akan menerima permintaan POST tanpa mengharuskan pengirim masuk.

Karena itu, Anyone adalah tingkat akses yang direkomendasikan saat menerima permintaan dari penyedia webhook eksternal seperti Navixy, ngrok, Postman, curl, atau klien HTTP pihak ketiga lainnya.<br>

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-75f2f29d302d081f1a91fc18078928f13531fbda%2Funknown.png?alt=media" alt="" height="409" width="390">

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.

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-c0d55c1a53f44bb4a731d7db1636db165f8af7f5%2Funknown.png?alt=media" alt="" height="494.99999999999994" width="624">

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-c72e2379c933d6df12872170d95f73244d54323b%2Funknown.png?alt=media" alt="" height="492" width="624">

#### Memperbarui Apps Script

Jika Anda perlu mengubah 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 segera berlaku sambil mempertahankan URL Web App yang sama.

Ini memungkinkan Anda memperbarui skrip tanpa harus mengubah konfigurasi Webhook di IoT Logic.

<img src="https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-49dd76a248491b77a8588be9fcaa675b7070ae61%2Funknown.png?alt=media" alt="" height="613" width="624">

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.

<br>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
