Что это
Автоматическое уведомление, которое один сервис сам присылает другому при событии — например, "оплата прошла" или "новый заказ", без опроса "а есть что-то новое?" каждую минуту.
Как применяем
Основа большинства автоматизаций на n8n — заказ на маркетплейсе сразу триггерит цепочку действий, а не ждёт, пока кто-то её запустит вручную.
Где вебхук нужен бизнесу
- Менеджер должен узнать о смене статуса сделки сразу, а не когда заглянет в CRM.
- Оплата прошла, и это должно отметиться в учёте без ручной сверки.
- Клиент написал боту, и заявка должна тут же пойти дальше: в CRM, в таблицу, ответственному.
- Посетитель ответил на открытку или заполнил форму, и владелец хочет получить это в своей системе.
Вебхук или опрос
Вебхук — это адрес, который чужая система вызывает сама, когда у неё что-то произошло. Опрос — обратный путь: ваша программа сама спрашивает API «есть что-то новое?» раз в N секунд.
- Вебхук выбираем, когда сервис умеет его отправлять и у вас есть публичный адрес с HTTPS: CRM, платёжные системы, Telegram в режиме webhook.
- Опрос выбираем, когда вебхуков нет или сервер нельзя открыть наружу. Так работает мониторинг слотов Wildberries: бот спрашивает API каждые 30 секунд.
- У Telegram-ботов есть оба режима. Long polling не требует ни открытого порта, ни публичного адреса, поэтому большинство наших ботов работает так.
Как мы это используем
- В автоматизации заявок бот, Bitrix24, платёжная система и Google Таблица не связаны напрямую: каждый говорит только с n8n. При смене статуса сделки Bitrix24 сам вызывает адрес n8n, сценарий находит ответственного и пишет ему в Telegram. События платёжной системы приходят в тот же узел.
- Бот продажи подписок по умолчанию опрашивает Telegram, а для сервера с публичным адресом есть режим webhook со встроенным веб-сервером на aiohttp. Режим переключается настройкой.
- В сервисе открыток UNLOCK выбор получателя приходит владельцу в Telegram, а заявки дополнительно отдаются вебхуком.
- Бот входа в сервис работает без вебхука: сервер сервиса в России, Telegram оттуда недоступен, поэтому бот живёт за границей, сам опрашивает Telegram и раз в 20 секунд забирает очередь событий сервиса.
Цепочки на вебхуках собираем в разделе Автоматизация.
Типичные проблемы
- Повторная доставка. Событие может прийти дважды, и обработка должна это пережить: платёж не засчитывается второй раз, заявка не создаётся дублем.
- Нужен публичный HTTPS-адрес. Сервер за NAT или без сертификата вебхук не примет. Тогда либо туннель, либо опрос.
- Не видно, дошло ли событие. В n8n каждый запуск лежит в журнале выполнений, поэтому проверить заявку можно без чтения кода. Без журнала поиск потерянного события превращается в гадание.
- Секреты в адресе. Адрес вебхука фактически пароль: кто его знает, тот может слать события. Ключи и токены храним в n8n, а не в файле сценария.
Когда это не нужно
Если событие редкое и реакция через пять минут никому не мешает, проще опрашивать API по расписанию. И если сервис вебхуков не умеет, городить их не нужно: опрос раз в 30 секунд, как в мониторинге слотов, решает задачу надёжно.