Обзор
Что такое исходящий вебхук
Исходящий вебхук сообщает вашему серверу о событиях в пространстве в момент, когда они происходят: о новых сообщениях, реакциях, нажатиях кнопок, изменениях участников и других.
Каждое событие — это POST-запрос с JSON на адрес из настроек бота. В нём только основные поля, которых обычно хватает для автоматизации, а полные данные объекта можно получить через API.
Каждый запрос подписан. Как проверить подпись и другие способы убедиться, что запрос пришёл от Пачки, — в разделе Безопасность и обработчик.
Как это работает
Создайте бота
Откройте Интеграции > Боты и нажмите Создать бота. Подробнее — в разделе Создание бота.
Включите вебхук
В карточке бота на вкладке Исходящий вебхук нажмите Включить и укажите URL вашего сервера, на который Пачка будет отправлять события.
Выберите типы событий
Отметьте события, которые вас интересуют: новые сообщения, реакции, нажатия кнопок и другие. Подробнее — в разделе Настройка и типы событий.
Добавьте бота в чаты
Большинство событий приходит только из чатов, где состоит бот, и из их тредов. Какие события откуда приходят — в разделе Настройка и типы событий, а как добавить бота в чат — в разделе Доступы к чатам и сообщениям.
Поля API, чтобы настроить вебхук без интерфейса, перечислены в разделе Через API. Как на этих событиях построить бота, который отвечает сотрудникам в чатах и тредах, — в разделе Общение с ботом.