API и интеграции

Подключить n8n

Два рабочих маршрута n8n: принять webhook платформы и выполнить REST-запрос стандартным узлом HTTP Request.

Обновлено 31.08.2026
Время чтения 14 мин
Сложность Средний
Цель инструкции

Собрать и проверить безопасный маршрут «платформа → n8n → платформа».

Короткий маршрут

Что вы сделаете

Откройте нужный шаг сразу или идите по порядку. Проверка результата остаётся в самой инструкции.

  1. 01 Как устроено подключение
  2. 02 Шаг 1. Вход n8n
  3. 03 Шаг 2. REST-запрос из n8n
  4. 04 Защита от повторов
  5. 05 Проверка и отключение

Результат: n8n примет тестовое событие платформы и при необходимости получит актуальные данные через REST API.

Как устроено подключение

Отдельного официального узла платформы нет. Используйте стандартные узлы Webhook и HTTP Request. Webhook принимает событие, HTTP Request обращается к REST API.

Рабочий процесс n8n с узлами Webhook, HTTP Request и ответом
Минимальный сценарий: принять событие, проверить API платформы и вернуть подтверждение.

Шаг 1. Вход n8n

  1. Создайте сценарий и добавьте Webhook.
  2. Выберите POST и скопируйте рабочий URL.
  3. В кабинете откройте вкладку Webhook и создайте режим «Своя система: JSON».
  4. Добавьте URL n8n, выберите событие и задайте отдельный secret.
  5. Сверьте предпросмотр и выполните тест.
Выбор событий заявки для webhook платформы
Для первого теста достаточно application.created. Подключайте остальные события только если сценарий их различает.

Шаг 2. REST-запрос из n8n

  1. Создайте отдельный ключ платформы только с необходимыми правами API.
  2. В n8n создайте Header Auth credential: заголовок Authorization, значение Bearer ….
  3. Не помещайте значение в сам узел.
  4. В HTTP Request задайте GET и https://telegram.appsmax.ru/api/v1/me.
  5. Сначала проверьте ожидаемый 401 без credential, затем 200 с ним.
Форма проверки ключа платформы перед подключением n8n
Проверьте сохранённый ключ до настройки n8n. Успешный ответ подтверждает ключ и организацию, но не весь сценарий.

Защита от повторов

Webhook может доставляться повторно. Для заявки используйте сочетание event, application.id и фактического состояния объекта. Отдельный стабильный delivery ID сейчас не публикуется.

Проверка и отключение

  1. Отправьте одну заявку с маркером [TEST].
  2. Убедитесь, что n8n execution успешен и целевая запись одна.
  3. Найдите доставку в журнале платформы.
  4. Удалите тестовую запись.
  5. При отключении сначала деактивируйте webhook платформы, затем сценарий n8n и отзовите ключ.
Журнал доставки webhook платформы с маскированным адресом
Для диагностики сохраните время, HTTP-статус и request ID; полный URL и credential не передавайте.

Дальше: разбор ошибок в журнале.

Нужна помощь с запуском?

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