Подключение сервисов: блоки, API, вебхуки

Готовые блоки

Сценарий почти всегда соединяет несколько сервисов: форму, таблицу, почту, мессенджер, систему учёта. Подключить сервис можно тремя способами, от простого к сложному: готовый блок, универсальный запрос и вебхук.

Готовый блок — самый простой путь. Для популярных сервисов в системе автоматизации есть блоки: «добавить строку в таблицу», «отправить письмо», «отправить сообщение», «создать сделку». У каждого — понятные поля: какую таблицу, какой лист, что записать. В n8n таких блоков сотни (по состоянию на 25.09.2026), и примерно так же в других системах.

Чтобы блок работал, его нужно подключить к вашему аккаунту в сервисе. Обычно два пути:

• вход через аккаунт — нажимаете «подключить», сервис спрашивает, разрешить ли доступ, вы соглашаетесь. Пароль системе автоматизации не передаётся;
• ключ доступа — длинная строка, которую сервис выдаёт в своих настройках. Её вставляют в систему автоматизации (глава 4 — как хранить).

Подключение сохраняется в системе отдельно от сценариев и используется многими сценариями сразу. В n8n это называется учётными данными (по состоянию на 25.09.2026).

Проверка подключения — первый шаг: сделайте самое простое действие (прочитать одну строку, отправить себе сообщение) и убедитесь, что доступ есть, прежде чем строить на нём сценарий.

API и коды ответа

Если готового блока нет или он не умеет нужного, остаётся универсальный запрос к сервису — через его API. API — это «вход для программ»: сервис описывает, какие запросы он принимает и что на них отвечает.

• адрес — куда обращаться, его даёт документация сервиса;
• метод — что сделать: получить данные или отправить. В документации это слова GET (получить) и POST (отправить);
• ключ — кто спрашивает; обычно передаётся в заголовке запроса;
• данные — что отправляем: поля записи в формате, который описан в документации;
• ответ — данные от сервиса и код ответа.

Всё это берут из документации сервиса — страницы для разработчиков. Звучит сложно, но на практике это чаще всего пример запроса, который копируют и меняют под себя. Многие системы умеют вставить готовый пример целиком.

Код ответа — главный ориентир. Если сценарий упал на запросе, первым делом смотрят код: 4xx — ошибка в вашем запросе (ключ, данные, адрес), 5xx — сбой у сервиса, и помогает повтор позже.

Вебхуки

Третий способ — вебхук. До сих пор сценарий сам ходил в сервисы. Вебхук работает наоборот: у сценария появляется свой адрес, и другая система сама отправляет на него данные, когда что-то случилось. Это тот самый «вызов извне» из урока 2 — мгновенный триггер.

Так подключают формы сайтов, платёжные системы, чат-ботов, конструкторы сайтов: в их настройках есть поле «адрес для уведомлений», куда вставляют адрес сценария.

Что важно знать о вебхуках:

• тестовый и рабочий адрес — многие системы дают два: тестовый работает, пока вы смотрите на сценарий, рабочий — когда сценарий включён. В n8n так и есть (по состоянию на 25.09.2026). Частая ошибка — вставить в форму тестовый адрес и удивляться, что после включения ничего не приходит;
• адрес — это дверь. Любой, кто знает адрес, может отправить на него что угодно. Поэтому адрес не публикуют, а важные вебхуки защищают: секретным словом в запросе или проверкой подписи, если сервис это умеет;
• ответ отправителю — сервис ждёт, что сценарий ответит «принял». Если ответа нет, он может повторить отправку — и данные придут дважды (урок 7 о дублях).

Если сценарий работает на своём компьютере, а не на сервере, внешняя система его просто не найдёт: у компьютера дома нет адреса в интернете. Где запускать сценарии — урок 9.

Ключи доступа

И готовые блоки, и запросы работают через ключи доступа. Ключ — это как пароль: кто им владеет, тот действует от вашего имени в сервисе. Поэтому с ключами обращаются как с паролями.

• хранить в учётных данных системы, а не вписывать в текст шага или в выражение. Текст шага видят все, кто открывает сценарий, он попадает в копии и выгрузки;
• минимальные права — если сервис позволяет выбрать, что может ключ, давайте только нужное: читать таблицу, а не удалять аккаунт;
• не пересылать в мессенджерах и письмах, не выкладывать на скриншотах;
• отзывать — при подозрении на утечку, при уходе человека, при смене подрядчика. Сервис выдаст новый ключ, старый перестанет работать.

Хорошая привычка — записать, какой ключ для чего используется и где он выдан. Через год, когда ключ истечёт или его придётся отозвать, эта запись сэкономит часы поисков.

Подключения — место, где автоматизация встречается с безопасностью. Подробнее о том, где запускать сценарии и как беречь данные клиентов, — в уроке 9.