Что такое вебхуки и как их создать
Вебхук — это персональная ссылка на конкретный канал. Любой сервис, который умеет отправлять HTTP-запросы, может слать в этот канал сообщения по такой ссылке, и для этого не нужен отдельный бот. Удобно для уведомлений: новая запись на сайте, сборка в разработке, оповещение из сторонней программы.
Как создать вебхук
- Откройте настройки сервера и раздел Интеграции.
- Выберите Вебхуки и нажмите «Создать вебхук».
- Задайте имя и аватар — под ними будут приходить сообщения — и выберите канал.
- Нажмите Копировать URL. Это и есть адрес, по которому шлются сообщения.
Ссылка вебхука — это ключ к каналу. Любой, у кого она есть, может писать в канал от имени вебхука. Не публикуйте её и не храните в открытом доступе. Если ссылка утекла — удалите вебхук и создайте новый.
Как отправить сообщение
Отправьте на скопированный адрес POST-запрос с телом в формате JSON. Минимально достаточно поля с текстом:
{
"content": "Привет из вебхука!",
"username": "Моё имя",
"avatar_url": "https://пример/аватар.png"
}Поля username и avatar_url необязательные — они переопределяют имя и аватар для конкретного сообщения. Так можно из одного вебхука присылать сообщения под разными именами.
Изменить или удалить
Всё там же — настройки сервера, Интеграции, Вебхуки. Можно поменять имя, аватар и канал, сгенерировать новую ссылку или удалить вебхук совсем. После смены ссылки старая перестаёт работать.
Была ли статья полезной?