Для разработчиков

Обзор

Что такое исходящий вебхук

Исходящие вебхуки позволяют вам получать информацию о событиях в вашем пространстве в реальном времени. Это могут быть новые сообщения, реакции, чаты, участники и тд.

Вебхук представляет собой JSON объект, отправляемый в момент наступления события на указанный в настройках бота URL, содержащий небольшое количество информации, которой достаточно для написания автоматизаций. Если требуется получить больше информации об объектах, указанных в JSON — вы можете воспользоваться API и получить полную информацию.

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

Как это работает

Создайте бота

Перейдите в Автоматизации > Интеграции > Чат-боты и Вебхуки и создайте бота. Подробнее — в разделе Боты.

Укажите Webhook URL

В настройках бота перейдите на вкладку Исходящий Webhook и укажите URL вашего сервера, на который Пачка будет отправлять события.

Выберите типы событий

Отметьте события, которые вас интересуют: новые сообщения, реакции, нажатия кнопок и другие. Подробнее — в разделе Типы событий.

Добавьте бота в чаты

Большинство событий приходят только из чатов, в которых состоит бот. Глобальные события (например, изменение состава участников пространства) не требуют добавления в чат.

Разделы