> 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/user/ru/guide/account/iot-logic/nodes/webhook-node.md).

# Вебхук

Отправляйте HTTP POST-запросы внешним API, когда IoT Logic получает данные устройства. Формируйте собственные JSON-нагрузки со статическими значениями и динамическими атрибутами телеметрии.

## Технический обзор и возможности

{% columns %}
{% column width="58.333333333333336%" %}
**Вебхук** Узел обеспечивает запуск в реальном времени определенных действий во внешних системах. Он отправляет HTTP POST-запросы в указанные конечные точки при получении данных от подключенных узлов. Затем он формирует пользовательские JSON-пейлоады как со статическими, так и с динамическими атрибутами и выполняет вызовы API к сторонним сервисам.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-0b4156bcc8f11f49a91ad380aa20bf05842c617b%2Fiot-logic-webhook-tile.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Этот узел расширяет возможности IoT Logic за пределы обработки и передачи данных, обеспечивая прямую интеграцию с платформами обмена сообщениями, системами ERM и CRM и пользовательскими приложениями для запуска автоматических действий на основе конфигурации вашего потока.

{% hint style="info" %}
Узлы Вебхук настраиваются отдельно для каждого потока в интерфейсе платформы Navixy. Узлы Вебхук служат конечными точками в потоке и для работы требуют как минимум одного входящего соединения. Они не могут передавать данные последующим узлам.
{% endhint %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-21ecc9198943832f7ef089cac12b989f3aa37aec%2Fiot-logic-webhook-in-flow.png?alt=media" alt=""><figcaption></figcaption></figure>

### Как работают узлы Вебхук

Когда данные достигают узла Вебхук через входящее соединение, он немедленно выполняет HTTP POST-запрос к настроенной конечной точке. Узел:

1. Собирает текущие значения всех атрибутов из подключенных предыдущих узлов
2. Заменяет ссылки на динамические атрибуты (например, `{{speed}}`) на фактические значения из входящего сообщения
3. Формирует полный JSON-пейлоад, сохраняя заданную структуру
4. Отправляет HTTP POST-запрос с указанными заголовками к целевой конечной точке
5. Продолжает работу, не дожидаясь ответа, позволяя потоку сразу перейти к следующему шагу

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

Каждый **Вебхук** результат срабатывания узла появляется в [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) в виде атрибута с именем, совпадающим с **ID узла** (показан в диалоге настройки узла, например `Вебхук_1a2b3c4d`). Значение равно `0` когда узел не сработал и `1` когда это так, что позволяет вам подтверждать доставку и различать несколько узлов Вебхук в одном потоке.

### Интеграция с архитектурой потока

Вебхук-узлы выполняют роль конечных точек, которые преобразуют обработанные данные устройства во внешние API-вызовы. Вместо того чтобы непрерывно передавать все данные устройства, как это делают узлы типа «Узел передачи данных», вебхуки выполняют целевые API-запросы с точно настроенными полезными нагрузками. Такая архитектура позволяет:

* **Автоматизации, запускаемые событиями**: Запускайте внешние рабочие процессы на основе условий устройства, вычисленных метрик или определённых ранее в потоке шаблонов данных
* **Выборочная передача данных**: Отправляйте только релевантные атрибуты во внешние системы, сокращая ненужную передачу данных и расходы на API
* **Параллельное выполнение**: Работает параллельно с другими выходными узлами, позволяя одновременно запускать вебхуки и непрерывно передавать данные в разные назначения
* **Многоисточниковая интеграция**: Принимает входящие соединения из нескольких параллельных ветвей и получает доступ к атрибутам всех подключенных узлов

### Возможности узла

Этот **Узел Вебхука** предлагает:

* **Выполнение HTTP POST**: Отправляет настраиваемые HTTP POST-запросы в любую доступную конечную точку с использованием протоколов HTTP или HTTPS (рекомендуется HTTPS)
* **Динамическое формирование полезной нагрузки**: Формирует JSON-тела запросов, объединяя статические значения с динамическими атрибутами из любой точки потока с помощью `{{attribute_name}}` синтаксис
* **Настройка пользовательских заголовков**: Поддерживает до 10 пользовательских HTTP-заголовков для аутентификации и требований, специфичных для API
* **Поддержка вложенных атрибутов**: Ссылается на сложные структуры атрибутов, включая вложенные объекты и массивы в JSON-полезной нагрузке
* **Независимое выполнение**: Срабатывает, не дожидаясь ответов и не блокируя поток, обеспечивая надёжную работу независимо от доступности внешней системы

## Параметры конфигурации

{% columns %}
{% column valign="middle" %}
Узел Вебхук позволяет вам определить, как ваш поток будет взаимодействовать с внешними системами через вызовы HTTP API.
{% endcolumn %}

{% column %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-11bf6de89a59cf76114222886657ad0d1edcd308%2FWebhook_node_edit.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Давайте посмотрим, какие элементы использует этот узел и что можно настроить при работе с ним.

### Этапы настройки

{% stepper %}
{% step %}

#### Укажите имя узла

Введите описательное имя, которое определяет назначение вебхука.

* Используйте имена, которые указывают на целевой сервис или действие (например, «Slack Speed Контроль событий» или «создание тикетов в CRM»)
* Это имя отображается на схеме потока для удобства идентификации
  {% endstep %}

{% step %}

#### ID узла (генерируется автоматически)

Под полем «Имя» в диалоге отображается **ID узла** (например, `Вебхук_1a2b3c4d`). Это поле доступно только для чтения — вы не можете редактировать или задавать его значение.

* ID генерируется автоматически при создании узла и остается неизменным на протяжении всего срока его существования
* Используйте его, чтобы отличать результаты этого узла от результатов других узлов Вебхук в [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md), где он отображается как атрибут со значением `0` (не сработало) или `1` (сработало)
  {% endstep %}

{% step %}

#### Настройте URL конечной точки

Введите полный URL, на который отправляются POST-запросы.

* Укажите протокол: `http://` или `https://` (HTTPS настоятельно рекомендуется)
* Убедитесь, что URL указывает на действующую конечную точку API, которая принимает POST-запросы
* Пример: `https://api.example.com/v1/webhooks/device-alerts`
  {% endstep %}

{% step %}

#### Определите HTTP-заголовки

Добавьте любые заголовки, требуемые вашим целевым API.

1. Нажмите **Добавить заголовок** для создания пар «ключ-значение» заголовка\
   Все заголовки настраиваются пользователем, включая Content-Type. К распространённым заголовкам относятся:
   * `Content-Type: application/json` (обязательно для JSON-полезных нагрузок)
   * `Авторизация: Bearer <token>` (для аутентификации API)
   * Пользовательские Управление API ключами или заголовки аутентификации в соответствии с требованиями сервиса
2. Нажмите значок удаления, чтобы удалить отдельные заголовки

{% hint style="info" %}
Поддерживается максимум 10 заголовков
{% endhint %}
{% endstep %}

{% step %}

#### Сформируйте тело запроса

Переключитесь на **Тело** вкладке и задайте структуру JSON, которая отправляется в конечную точку:

* Введите корректный синтаксис JSON в поле Body
* Используйте `{{attribute_name}}` чтобы ссылаться на любой атрибут из связанных узлов
* Поддерживает вложенные структуры JSON и массивы
* Ссылки на атрибуты работают с вложенными путями (например, `{{location.latitude}}`)
* Если указанный атрибут имеет значение null или не существует, значение `null` передается в JSON

**Пример тела Вебхука с динамическими атрибутами:**

```json
{
  "alert_type": "speed_violation",
  "device_id": "{{device_id}}",
  "current_speed": "{{speed_mph}}",
  "threshold_exceeded": 80,
  "location": {
    "lat": "{{latitude}}",
    "lng": "{{longitude}}"
  },
  "timestamp": "{{message_time}}", 
  "Водитель": "{{hardware_key}}"
}
```

{% endstep %}

{% step %}

#### Сохраните конфигурацию

Нажмите **Примените изменения** чтобы сохранить настройки узла Вебхука.
{% endstep %}
{% endstepper %}

## Поведение выполнения Вебхука

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

{% hint style="danger" %}
В настоящее время выполнение Вебхука не включает автоматические повторные попытки, ведение журнала неудачных попыток или обработку ответов. Если конечная точка возвращает ошибку или истекает время ожидания, Вебхук сработает снова при следующем входящем сообщении. В будущих обновлениях могут появиться лимиты запросов, задаваемые получателем, и очереди запросов.
{% endhint %}

### Вебхук против непрерывной потоковой передачи данных

**Узел Вебхука** принципиально отличается от **Узел передачи данных** по назначению и схеме выполнения:

| Узел Вебхука                                                                                                                                                                                                                        | Узел передачи данных                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Выполняет отдельные API-вызовы при каждом сообщении, отправляя настраиваемые полезные нагрузки, которые вы задаёте. Идеально подходит для запуска внешних действий, отправки уведомлений или передачи выборочных данных в REST API. | Поддерживает непрерывные потоки данных через MQTT, передавая полные данные устройства в формате Navixy Generic Protocol. Предназначен для непрерывного сбора телеметрии и мониторинга в реальном времени. |

Выбирайте вебхуки, когда нужно запускать внешние автоматизации или отправлять только определённые атрибуты в конечные точки API. Используйте выходные конечные точки для непрерывных потоков данных в аналитические платформы или системы мониторинга. Оба варианта могут сосуществовать в одном потоке.

### Интеграция с внешними системами

Вебхук-узлы отлично подходят для запуска событийно-ориентированных действий в системах, предоставляющих REST API. К распространённым схемам интеграции относятся:

* **Платформы обмена сообщениями**: Отправляйте уведомления в Slack, Microsoft Teams, WhatsApp или Telegram, когда условия на устройстве соответствуют заданным критериям
* **ERP-системы**: Синхронизируйте данные устройства с платформами планирования ресурсов предприятия, чтобы обновлять уровни запасов, запускать процессы закупок или регистрировать использование оборудования для планирования техобслуживания
* **Системы управления заявками**: Автоматически создавайте заявки в службу поддержки или запросы на обслуживание в CRM-платформах при обнаружении проблем с устройством
* **Сервисы оповещений**: Запускайте SMS-, email- или push-уведомления через такие сервисы, как Twilio, SendGrid или Firebase, когда пороговые значения превышены
* **Автоматизация бизнес-процессов**: Запускайте рабочие процессы в таких инструментах, как Zapier, Make (Integromat) или n8n, на основе телеметрии устройства
* **Телематические системы**: Запускайте определенные действия или автоматизации в сторонних телематических решениях на основе обработанных данных, обеспечивая сценарии, управляемые событиями, такие как пересчет маршрутов, уведомления водителей или обновление статусов во внешних системах управления транспортом
* **Пользовательские приложения**: Активируйте проприетарную бизнес-логику, публикуя события устройства во внутренние API

## Часто задаваемые вопросы

#### Как настроить срабатывание вебхуков только при определенных условиях?

Используйте **IF/THEN Логика** узел для реализации условной логики перед Вебхуком. Этот **IF/THEN Логика** узел может оценивать атрибуты устройства и направлять данные к Вебхуку только при выполнении условий. Подробнее см. [IF/THEN Логика](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/logic-node.md).

#### Могу ли я использовать несколько узлов Вебхука в одном и том же потоке?

Да. Используйте несколько **узлов Вебхука** с разными конфигурациями, чтобы запускать различные внешние системы на основе одних и тех же данных устройства. Каждый Вебхук срабатывает независимо при получении данных.

#### Что произойдет, если запрос Вебхука завершится сбоем?

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

#### Как мне пройти аутентификацию во внешних API?

Настройте аутентификацию полностью через пользовательские заголовки. Распространенные подходы:

* **Bearer-токены**: Добавьте заголовок `Authorization` со значением `Bearer your_token_here`
* **Управление API ключами**: Добавьте пользовательские заголовки, как указано вашим поставщиком API
* **Базовая аутентификация**: Добавьте заголовок `Authorization` со значением `Basic base64_encoded_credentials`

Всегда указывайте `Content-Type: application/json` в качестве заголовка при отправке JSON-нагрузки.

#### Могу ли я использовать атрибуты из нескольких связанных узлов?

Да. Узел Вебхук может получать доступ к атрибутам из любого узла, подключенного к нему, включая параллельные ветви. Если несколько узлов отправляют данные в Вебхук, он срабатывает по одному разу для каждого входящего сообщения и может ссылаться на атрибуты из пути источника этого сообщения.

#### Какие данные я могу включить в тело Вебхука?

Вы можете включить любую комбинацию из:

* Статические значения, заданные непосредственно в вашей JSON-конфигурации
* Динамические атрибуты из потока с помощью `{{attribute_name}}` синтаксис
* Вложенные атрибуты из сложных структур данных
* Атрибуты, вычисленные в **узлах «Вычисление атрибута»** или обработанные через **IF/THEN Логика** узлы

Тело должно быть валидным JSON. Если указанного атрибута не существует или он содержит значение null, `null` отправляется в JSON.

#### Как я могу проверить свою конфигурацию вебхука?

Открыть [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) для потока и выберите запускающее устройство. Найдите атрибут, соответствующий ID этого узла: его значение переключается на `1` каждый раз, когда срабатывает вебхук, `0` в противном случае. Это подтверждает, что вебхук сработал без необходимости доступа к конечной точке назначения.

Чтобы убедиться, что пункт назначения действительно получил ожидаемые данные, во время разработки можно использовать сервисы «Вебхук» для тестирования, например webhook.site или RequestBin, и проверять точные отправляемые запросы.


---

# 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/user/ru/guide/account/iot-logic/nodes/webhook-node.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.
