> 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/ru/faq-and-troubleshooting/iot-logic/how-to-connect-an-iot-logic-webhook-node-to-google-sheets.md).

# Как подключить узел Вебхук IoT Logic к Google Таблицам

Отправляйте телематические параметры из потока IoT Logic в Google Таблицы с помощью узла Вебхук. Описаны настройка узла, Apps Script и уровни доступа при развертывании.

В этом руководстве вы узнаете, как отправлять параметры телематики или значения внешнего Источника данных из потока Navixy IoT Logic в Google Sheets с помощью узла Вебхук.

<img src="https://2371323805-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">

## Шаг 1. Добавьте узел Вебхук

После создания потока IoT Logic добавьте узел Вебхук и подключите его к триггеру, который инициирует передачу данных.

Узел Вебхук работает по принципу «запустил и забыл». Это означает, что он немедленно отправляет HTTP-запрос при срабатывании, но не ожидает ответ сервера и не сохраняет его.

После добавления узла Вебхук настройте его следующим образом.

#### URL

Введите URL веб-приложения Google Apps Script, связанного с таблицей Google Sheets, в которую вы хотите отправлять информацию.

#### Заголовки

Добавьте следующий HTTP-заголовок:

| Ключ            | Значение         |
| --------------- | ---------------- |
| Тип содержимого | application/json |

#### Тело

Тело запроса должно быть в формате JSON. Оно должно включать ключ аутентификации и любые данные, которые вы хотите отправить в Google Sheets.

Пример:

*{*

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

*"event": "morning\_fuel\_report",*

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

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

*}*

Вы можете добавить любые дополнительные атрибуты IoT Logic или параметры телеметрии, используя соответствующие плейсхолдеры.

Примечание: Поле «key» обязательно, если ваш Google Apps Script использует общий секрет для аутентификации входящих запросов Вебхука. Замените «MY\_SUPER\_SECRET\_123» секретом, настроенным в вашем Google Apps Script.

<img src="https://2371323805-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">

## Шаг 2. Настройте Google Таблицу

Откройте свою Google Таблицу, нажмите «Расширения», а затем выберите Apps Script.

<img src="https://2371323805-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">

Это откроет файл Code.gs, в котором вы добавите скрипт, отвечающий за получение запросов Вебхука и запись данных в электронную таблицу.

<img src="https://2371323805-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">

Следующий пример кода можно использовать для получения значений, отправленных из узла Вебхука, и добавления их в виде новой строки в вашу Google Таблицу.

*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);*

*}*

**Примечание**: Замените пример кода выше на скрипт, приведенный ниже. Вы также можете настроить поля так, чтобы они соответствовали данным, отправляемым через ваш IoT Logic Вебхук.

Скрипт выше работает как конечная точка HTTP POST, которая принимает запросы, отправляемые из узла Вебхук IoT Logic.

При каждом получении запроса скрипт сначала проверяет общий секрет (SECRET\_KEY), чтобы убедиться, что записывать данные в Google Sheet разрешено только авторизованным Вебхук-запросам. Если аутентификация успешна, JSON-данные разбираются, и указанные параметры — такие как временная метка приема, имя устройства, ID устройства, долгота, широта или любые другие телеметрические значения — автоматически добавляются в таблицу в виде новой строки.

Наконец, сценарий возвращает ответ, указывающий, была ли операция успешно выполнена («Успех») или отклонена из-за недействительного ключа аутентификации («Доступ запрещен»).

Важно: имена полей, используемые в скрипте, должны точно совпадать с именами параметров, отправляемых через IoT Logic Вебхук. К каждому значению обращаются с помощью синтаксиса data.\<parameter\_name>, где \<parameter\_name> соответствует свойству JSON, полученному в запросе.

Например, если Вебхук отправляет следующий параметр:

*{*

*"Уровень топлива": 68,5*

*}*

В Apps Script к нему следует обращаться как:

*data.fuel\_level*

Если скрипт вместо этого ссылается на:

*data.Уровень топлива\_март*

Значение не будет заполнено, потому что во входящем JSON-полезной нагрузке нет параметра с таким именем. В результате соответствующая ячейка в Google Sheets останется пустой.

Это одна из самых распространенных ошибок конфигурации при интеграции Вебхука IoT Logic с Google Sheets. Всегда проверяйте, что имена параметров в теле Вебхука точно совпадают с теми, которые используются в Apps Script, включая регистр, подчеркивания и правописание.

После того как вы завершите сопоставление тела JSON с кодом Apps Script, нажмите кнопку Deploy.

В разделе Who has access обязательно выберите Anyone.

Этот параметр необходим, потому что, когда Узел Вебхук отправляет HTTP POST-запрос на URL веб-приложения Google Apps Script, запрос принимается как анонимный клиент (без учетных данных вашей учетной записи Google).

Если уровень доступа настроен следующим образом:

* Только я — Google отклонит запрос или потребует аутентификацию.
* Любой — Google примет POST-запрос, не требуя от отправителя входа в систему.

По этой причине Anyone — рекомендуемый уровень доступа при получении запросов от внешних провайдеров Вебхук, таких как Navixy, ngrok, Postman, curl или любой другой сторонний HTTP-клиент.<br>

<img src="https://2371323805-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">

Выберите New Deployment, а затем Web App в меню типа развертывания. Процесс развертывания может занять несколько минут. После его завершения будет сгенерирован URL веб-приложения. Скопируйте этот URL и вставьте его в поле URL узла Вебхук в вашем потоке IoT Logic. URL веб-приложения — это конечная точка, которая будет получать HTTP POST-запросы, отправляемые узлом Вебхук.

<img src="https://2371323805-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://2371323805-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">

#### Обновление Apps Script

Если позже вам потребуется изменить Apps Script, вам не нужно создавать новое развертывание.

Вместо этого нажмите Deploy → Manage Deployments, выберите существующее развертывание и нажмите Edit (значок карандаша). После сохранения и повторного развертывания обновленной версии изменения, внесенные в скрипт, сразу вступят в силу, при этом тот же URL веб-приложения сохранится.

Это позволяет обновлять скрипт без необходимости изменять конфигурацию Вебхука в IoT Logic.

<img src="https://2371323805-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">

После выполнения всех шагов, описанных в этом руководстве, соединение между IoT Logic и Google Sheets должно быть успешно установлено.

Эта интеграция предоставляет простой и эффективный способ записывать телеметрические данные, внешние параметры или пользовательские атрибуты IoT Logic для отчетности, анализа, аудита или интеграции с другими инструментами Google Workspace.

<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/ru/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.
