Вебхуки: что это и как отправлять события Telegram

Допустим, вы хотите, чтобы каждый новый чек, каждый дубликат заявки или каждое важное сообщение из Telegram сами попадали в рабочий чат Discord, в Slack, в MAX или в таблицу. Можно открывать Telegram и переносить вручную, а можно один раз настроить вебхук и забыть об этом.

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

Вебхук — адрес в интернете, на который сервис сам присылает сообщение, когда что-то произошло. Спрашивать «есть новости?» не нужно: новость приходит к вам в момент события.

Сравните два способа:

Опрос (polling). Ваша программа каждые несколько минут обращается к сервису и спрашивает, не появилось ли что-то новое. Большинство обращений впустую, а новость приходит с задержкой.
Вебхук. Сервис сам отправляет запрос (обычно POST с данными в формате JSON) на ваш адрес в ту секунду, когда событие случилось. Лишних запросов нет, задержки почти нет.

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

Как это устроено технически

Принимающая сторона (Discord, Slack, ваш сайт, сценарий в Make, Zapier или n8n) выдаёт адрес вебхука, длинную ссылку вида https://….
Вы вставляете этот адрес в сервис, который будет отправлять события.
Когда событие происходит, сервис делает запрос на этот адрес и передаёт данные: текст, сумму, автора, ссылку.
Принимающая сторона отвечает кодом 200 («принял»). Если ответа нет, хороший сервис повторяет отправку.

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

Куда можно отправлять события из Zion Tools

Discord: канал команды. Текст приходит с картинками, упоминания «всем» отключены.
Slack: канал, через Incoming Webhook.
MAX: через вашего бота. Токен выдаёт @MasterBot, бот должен быть в нужном чате или канале.
Свой адрес: сайт, CRM или сценарий Make, Zapier, n8n. Оттуда данные можно отправить в Google Таблицу, CRM или другое приложение.

Для своего адреса сервис отправляет JSON и подписывает его: в заголовке X-Zion-Signature лежит подпись HMAC-SHA256, посчитанная по секрету вебхука. Принимающая сторона может пересчитать подпись и убедиться, что сообщение пришло именно от Zion Tools и не было изменено. Адрес принимается только по https, на закрытые внутренние адреса сервис не отправляет.

Где в Zion Tools есть вебхуки

Вебхуки есть в каждом модуле, где что-то происходит само, и входят в модуль без доплаты. Сами модули работают по тарифу, который вы выбрали (тарифы).

Пересылка

В «Новом маршруте» в списке «Куда» переключите Чат Telegram на Вебхук и нажмите Добавить вебхук. Посты из чата-источника пойдут в Discord, Slack, MAX или на ваш адрес; замены и фильтры работают так же, как для чата. Подробнее — на странице пересылки Telegram и в статье о пересылке без пометки «Переслано».

Алерты

В «Дополнительно» правила в строке Ещё в вебхук добавьте вебхук и отметьте его: срабатывание придёт и в бот, и по адресу — с названием правила, суммой и ссылкой на сообщение. Модуль — алерты, инструкция — уведомления о поступлениях на карту.

Валидатор

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

Чек сканер и Бухгалтерия

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

Что делать, если вебхук не дошёл

Нажмите Проверить, и на адрес уйдёт тестовое сообщение.
Откройте Журнал доставок: там последние отправки, код ответа и причина ошибки.
Сервис сам повторяет отправку при обрыве связи, ошибке сервера и ограничении по частоте: до четырёх попыток с растущими паузами. При другой ошибке принимающей стороны (например, адрес удалён) доставка сразу получает пометку «Не доставлено».
Если вы подозреваете, что секрет попал не туда, выпустите новый секрет в окне «Вебхуки» и обновите его у принимающей стороны.

Частые вопросы

Чем вебхук отличается от API? API — это «спрашиваю сам», вебхук — «мне присылают». Для уведомлений и переноса данных вебхук проще и быстрее.

Нужен ли программист? Для Discord, Slack и MAX — нет: достаточно скопировать адрес или токен. Для своего адреса помогут Make, Zapier или n8n: сценарии там собираются мышкой.

Не придёт ли лишнее? Нет: отправляется только то, что вы включили в маршруте, правиле, шаблоне или модуле. Дважды одно сообщение не уйдёт.

Сколько вебхуков можно подключить? До десяти на кабинет; один вебхук можно использовать в нескольких модулях.

Начните с одного вебхука

Выберите самое частое событие, например новый чек или срабатывание алерта, и отправьте его в рабочий чат. Через пять минут вы увидите, как это экономит время. Зарегистрироваться