Что такое Webhook и как с ним работать: гайд для digital-специалистов

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

А главное — покажем на практике, как работать с вебхуками без строчки кода с помощью платформы Альбато. В статье вас также ждут реальные примеры интеграций с amoCRM, SMS и Google Sheets и подробный гайд по настройке.

Что такое вебхук простыми словами

Вебхук (Webhook) — это механизм, который позволяет одним приложениям мгновенно отправлять данные другим при наступлении определенного события. Проще говоря, вебхук — это уведомление «наоборот». Если классическое API требует, чтобы мы сами пришли и запросили данные, то с вебхуком данные приходят к нам сами, как только что-то произошло.

Представьте ситуацию: вы ждете посылку и каждый час звоните на почту с вопросом: «Посылка уже приехала?». Так работает API.

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

Webhook vs API: в чем разница

API (Application Programming Interface) обычно работает по принципу запроса: одно приложение делает запрос (например, «отдай данные о новых заявках») и получает ответ. 

Webhook  работает по принципу события: одно приложение пересылает данные другому автоматически, как только случилось событие (например, «появилась новая заявка, вот ее данные»).

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

Таким образом, вебхуки экономят время и ресурсы. Вам не нужно постоянно опрашивать сервис о новых событиях — он сам уведомит вас, когда нужно. Это особенно важно для digital-сервисов: лид-формы, CRM, аналитика — данные поступают в реальном времени, без задержек. API же полезны, когда нужно получить данные по запросу или выполнить действия по расписанию, но для оперативной передачи данных вебхуки часто эффективнее.

Стоит отметить, что вебхуки и API не взаимоисключают друг друга. Вебхук обычно является частью API-возможностей сервиса. Просто это разные подходы к взаимодействию: “получать по требованию” (API) против “отдать по событию” (Webhook).

Как работают вебхуки

Механизм вебхука можно описать тремя шагами: событие — запрос — ответ. Когда в приложении-источнике происходит заданное событие, оно сформировывает сообщение с данными (это называется payload) и отправляет его по специальному URL — это и есть ваш вебхук-адрес. Приложение-получатель принимает этот HTTP-запрос, обрабатывает данные и обычно возвращает технический ответ (статус «200 OK» — мол, всё получил).

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

Важно понимать: вебхук — это просто URL-адрес, на который одно приложение отправляет HTTP-запрос. Обычно используется метод POST и формат JSON, но детали могут различаться. Чтобы начать пользоваться вебхуком, вам нужно:

• Сгенерировать URL вебхука (например, в приемнике данных или интеграционной платформе).
• Указать этот URL в настройках отправителя (в том сервисе, откуда будут идти данные) — обычно в разделе “Webhook” или “Callbacks”.
• Настроить обработку данных на стороне получателя — что делать с пришедшей информацией.

Выглядит немного сложно, но дальше мы покажем, как это настраивается визуально и без написания кода через Альбато. Даже если вы далеки от программирования, не волнуйтесь — сейчас разложим всё по полочкам.

Альбато: вебхуки и интеграции без единой строчки кода

Чтобы подружить ваши облачные сервисы между собой, вовсе не обязательно самому писать код и разбираться в тонкостях API. Альбато делает интеграции доступными любому пользователю. Это no-code сервис, позволяющий за считанные минуты связать между собой разные приложения. Более 800 сервисов уже готовы к интеграции, и если нужного вы вдруг не найдете — все равно есть способ подключить и его. Но обо всем по порядку.

Почему Альбато упрощает жизнь digital-специалистам? 

1. Вы создаете связки (сценарии) в удобном визуальном конструкторе. Выбираете, что будет источником (триггером) и что делать с данными (действия), а платформа сама позаботится о передаче данных и запросах. 
2. Никакого кода — даже новичок настроит вебхук, следуя подсказкам интерфейса. 
3. Экономия времени: вместо того чтобы просить разработчиков написать интеграцию или прыгать между CSV-файлами, вы автоматизируете задачу за пять минут и забываете о рутине.

Как создать входящий вебхук на Альбато (пошагово)

Рассмотрим, как настроить входящий вебхук — то есть как принять данные от внешнего сервиса в Альбато для дальнейшей обработки. Например, у вас есть сайт на Tilda с формой заявки, и вы хотите, чтобы все новые заявки автоматически улетали в amoCRM. Используем вебхук как «мост» между Tilda и amoCRM через Альбато.

1. Создаем связку и выбираем источник «Webhook». В кабинете Альбато нажмите «Создать связку» (интеграцию) и в качестве триггера выберите сервис Webhook. Платформа сгенерирует URL — это уникальный адрес, куда можно отправлять данные. Он будет вида https://hook.albato.com/… (конкретная ссылка появится в интерфейсе). Это и есть ваш вебхук-URL.

2. Указываем URL в сервисе-источнике. В настройках Tilda найдите интеграции для форм. Tilda позволяет отправлять данные формы на сторонний URL (через вебхук). Вставьте скопированный URL из Альбато в соответствующее поле на Tilda и сохраните изменения. Теперь при каждой новой заявке Tilda будет делать POST-запрос на ваш Альбато-вебхук.

3. Настраиваем действия в Альбато. Возвращаемся в Альбато и добавляем шаги, что делать с пришедшими данными. В нашем случае цель — создать сущности в amoCRM. Добавляем действие: amoCRM – Создать новую компанию, затем еще одно: amoCRM – Создать новый контакт, далее amoCRM – Создать новую сделку и, например, amoCRM – Добавить примечание (чтобы прикрепить к сделке комментарий с дополнительными данными заявки). Настраиваем поля: какие данные из вебхука пойдут в название компании, контакт и т.д. Это делается через удобный мэппинг полей в интерфейсе Альбато (просто выбираете нужные переменные из пришедших данных).
4. Запускаем и тестируем. Сохраняем и включаем связку. Отправьте тестовую заявку с формы на Tilda и посмотрите в журнале Альбато, успешно ли прошел вебхук и создались ли элементы в amoCRM. Если все сделано правильно, новый лид мгновенно появится в вашей CRM со всеми нужными данными.

Вот так без единой строчки кода мы связали сайт и CRM. На скриншоте ниже показано, как выглядит настроенная связка Tilda → amoCRM на Альбато:

Пример сценария на Альбато: Шаг 1 — «Вебхук: Получен входящий webhook» (Альбато принимает данные, отправленные с Tilda). Далее Шаги 2–5 — действия amoCRM: создание компании, контакта, сделки и примечания. Все эти шаги выполняются автоматически за секунды после отправки формы. Таким образом, лид с сайта сразу появляется в amoCRM со всей информацией.

Практические сценарии использования вебхуков через Альбато

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

1. Заявки с сайта (Tilda) в CRM (amoCRM). Этот кейс мы уже рассмотрели: вебхук ловит новую заявку и создает сущности в CRM. В итоге менеджеры моментально получают новый лид в работу, ничего не упустив. Экономия времени очевидна: не нужно вручную переносить контакты или регулярно выгружать файлы с заявками — интеграция работает в фоновом режиме.
2. Уведомления из ресторанной системы (iiko) в SMS. Представьте, что в системе автоматизации ресторана iiko оформлен новый заказ, и вы хотите уведомить клиента или менеджера по SMS. Iiko может отправлять вебхук при новых событиях (например, при закрытии заказа). Настраиваем входящий вебхук в Альбато и указываем его в iiko. Затем в Альбато добавляем действие отправки SMS через подходящий сервис (например, SMS/profi). В результате, как только заказ проведен в iiko, Альбато получит вебхук с данными (например, номер телефона клиента и сумма заказа) и тут же запустит SMS-рассылку с нужным текстом.
   Сценарий iiko → SMS на Альбато: Шаг 1 — входящий вебхук (данные от iiko поступают на Альбато), Шаг 2 — действие «SMS/profi: Отправка SMS». Вебхук содержит телефон и текст, а Альбато автоматически подставляет их в отправку SMS. Клиент мгновенно получает сообщение, никаких задержек.

3. События через Webhook в Google Sheets. Вебхуки удобно использовать для сбора данных в таблицу. Например, сервис, с которым нет прямой интеграции, может отправлять вам вебхук, а Альбато запишет эти данные в Google Sheets. 

Скажем, вы проводите опрос или конкурс и собираете ответы: каждое новое участие отправляется вебхуком, Альбато принимает и добавляет строку в вашу таблицу Google. Таким образом формируется живой реестр данных без ручного копирования. (Кстати, для Google Sheets на Альбато есть готовые действия — добавление строк, обновление ячеек и пр., что делает этот процесс очень простым.)

Конечно, это лишь несколько примеров. Вебхуки универсальны — они работают с чем угодно: CRM, сайты и лендинги, сервисы рассылок, коллтрекинг, IP-телефония, онлайн-оплата, ERP-системы. Если сервис умеет отправлять уведомления о событиях — его можно подключить через вебхук. А Альбато свяжет все воедино: хоть подписку из формы в UniSender, хоть звонок из телефонии в таск-трекер.

Сейчас в Альбато действует акция: мы бесплатно помогаем с настройкой автоматизаций. Заполните форму — расскажем, как настроить интеграцию, и всё подключим. 👉 https://albato.ru/support_proposal

Исходящие вебхуки и кастомные API: когда нужен свой запрос

Мы рассмотрели входящие вебхуки, то естькогда Альбато получает данные. Но сервис умеет и отправлять вебхуки наружу. Это бывает нужно, если вы хотите передать данные в сторонний сервис по его API, которого нет среди готовых интеграций Альбато. Для этого в Альбато есть инструмент HTTP-запрос (Custom API request). Он позволяет настроить любой запрос к API вручную: указать URL, метод (GET, POST, DELETE ), заголовки, тело запроса и даже обрабатывать ответ.

Зачем это может понадобиться? Например, вы пользуетесь каким-то узкоспециализированным сервисом, которого пока нет в списке 800+ интеграций Альбато. Если у этого сервиса есть открытое API, вы можете выполнить к нему запрос прямо из связки. Альбато уже позаботится об авторизации: достаточно подключить учетные данные (токен или логин/пароль) в разделе подключений. Далее в сценарии добавляете действие «HTTP-запрос» и настраиваете нужный вызов API. Все — при выполнении связки Альбато отправит ваш кастомный запрос так, будто это родная интеграция.

Проще говоря, даже если какого-то сервиса нет в Альбато, это не приговор. Либо используем исходящий вебхук (HTTP-запрос) для работы с его API, либо… добавляем его через конструктор интеграций Альбато (Builder), если хочется полноценно встроить новый сервис в платформу. Но это уже тема для отдельного гайда. В большинстве случаев достаточно настроить один-два HTTP-запроса, чтобы закрыть разрыв между сервисами.

Преимущества Альбато для работы с вебхуками и интеграциями

Почему мы делаем упор на Альбато? Вот несколько причин, которые особенно важны для digital-специалистов:

• 800+ готовых интеграций. Популярные CRM, рекламные кабинеты, почтовые сервисы, мессенджеры, Google Sheets, платежные системы — скорее всего, нужные вам приложения уже есть на платформе. Можно комбинировать их с вебхуками как угодно.

• Визуальный интерфейс — никакого кода. Создавать интеграции можно самому через веб-интерфейс: выбрали сервисы, настроили логику — готово. Начать может даже новичок, все построено на понятной визуальной логике (триггеры, действия, связки).

• 30+ инструментов обработки данных. Альбато дает возможности трансформации данных прямо внутри связки: фильтры, форматирование текста и дат, калькулятор, объединение или разделение строк, условные маршруты (router), выполнение JavaScript-кода и многое другое. Даже сложные кейсы можно реализовать без внешних средств.

• Готовые шаблоны. Для типовых задач есть шаблоны интеграций: выберите из каталога подходящий сценарий, и он сразу развернется у вас в аккаунте — только подключите свои аккаунты сервисов. Это экономит время и служит хорошим примером, как все настроить.

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

Что в итоге: попробуйте вебхуки в деле

Вебхуки — мощный инструмент автоматизации, который, к счастью, стал доступен каждому благодаря no-code платформам. Теперь, когда мы простыми словами разобрали, что это такое и как работает, осталось самое важное — действовать. Попробуйте настроить свой первый вебхук-сценарий на Альбато: например, начните с простого — перешлите лид с сайта в таблицу или CRM. В блоге Альбато вы найдете множество инструкций и видео, а в библиотеке шаблонов — готовые кейсы интеграций на все случаи жизни.

Автоматизируйте рутину, придумывайте свои связки и делитесь кейсами с коллегами. Пусть вебхуки станут вашим незаметным, но надежным помощником в ежедневной работе digital-специалиста. И кто знает — возможно, избавившись от лишней рутины, вы вскоре будете смотреть на слово «Webhook» уже без страха, а с улыбкой, вспоминая этот гайд. Удачной интеграции и до встречи на новых автоматизационных вершинах!