Как найти свой вебхук

Дата публикации: 02.09.2022
Время чтения: 6 мин.

Вы можете общаться с пользователями параллельно в нескольких каналах – в соцсетях, мессенджерах и т.д. Чтобы оповестить подписчиков о чем-нибудь, необязательно вручную делать публикации во всех каналах одновременно – достаточно отправить уведомления. Рассмотрим, как это сделать с помощью вебхуков на примере Discord.

Что такое вебхук в Дискорд

Вебхук (от англ. Webhook) – это метод расширения или изменения поведения сайтов или приложений с помощью обратных вызовов. 

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

Репозиторий – это место, в котором хранятся и поддерживаются данные.

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

1. Происходит событие;
2. Исходный сайт отравляет НТТР-запрос на URL-сайта, который указан для вебхука;
3. Пользователь получает уведомление о событии.

Подробно о настройке вебхук смотрите в этом видео:

Discord – это кроссплатформенный мессенджер, с помощью которого можно организовывать голосовые и видеоконференции, обмениваться текстовыми сообщениями в приватных и публичных чатах и многое другое.

Он имеет веб-клиент, а также десктопные (Windows, MacOS, Linux) и мобильные (Android, iOS) приложения. 

Мессенджер пользуется огромной популярностью у геймеров и учащихся. Количество зарегистрированных пользователей превышает 250 миллионов.

Для чего он нужен

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

Если вы хотите оповестить участников сервера о каком-то событии, вам не придется делать это вручную. 

С помощью вебхуков можно настроить обмен информацией с другими ресурсами и автоматическое оповещение пользователей. Например, вы можете опубликовать видео на своем канале – и пользователи Discord увидят информацию об этом.

Таким образом, вебхук в Discord – это простой способ публикации сообщений с других сайтов или приложений в свой Discord-сервер.

Как настроить webhook discord

В первую очередь, нужно создать Discord-сервер. Для этого открываем приложение Discord и нажимаем на значок «+» в левом верхнем углу.

Процесс настройки вебхука будем рассматривать на примере десктопного приложения Discord для Windows. Интерфейс в других приложениях может отличаться.

Вы можете использовать готовый шаблон (например, для игры, школьного клуба, учебной группы и т.д.) или создать сервер с нуля. При этом вас попросят персонализировать его – выбрать название и значок. По умолчанию название сервера генерируется по формуле «Сервер + имя пользователя», а в качестве значка используется название сервера.

Теперь вам нужно перейти в настройки сервера. Для этого нажмите на его название в правом верхнем углу и в выпадающем меню выберите «Настройки сервера».

На открывшейся странице в левой части экрана выберите раздел «Интеграции» (находится во вкладке «Мой сервер»). Здесь вы сможете персонализировать свой сервер с помощью интеграций – например, управлять вебхуками, отслеживаемыми каналами и ботами, управлять настройками и т.д.

Ранее раздел «Вебхуки» был вынесен в основное меню настроек сервера.

Для создания вебхуков необходимо в поле «Вебхуки» нажать кнопку «Создать вебхук».

В открывшемся окне можно настроить вебхук:

• Изменить имя
• Выбрать канал, на который будут поступать уведомления (по умолчанию используется #основной)
• Загрузить иконку (размер от 128х128, оптимальный – 256х256)

Если вы измените настройки вебхука, не забудьте нажать кнопку «Сохранить изменения». В противном случае будут выставлены настройки по умолчанию.

Теперь нужно скопировать адрес вебхука – для этого нажмите кнопку «Копировать URL вебхука».

Как пользоваться вебхуком

Вебхук, который мы создали выше, сам по себе не работает. Ему необходимо взаимодействие с другим сайтом или приложением. Рассмотрим на примере Discohook. С его помощью вы сможете отправлять оповещения пользователям на свой сервер. Приложение выглядит вот так:

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

При первом запуске Dischook в левой и правой части экрана вы можете увидеть информацию о работе сервиса. Чтобы очистить все поля, нажмите кнопку «Clear All».

Рассмотрим доступные поля:

1) Webhook URL. В это поле необходимо вставить URL-адрес вебхука, который мы сгенерировали ранее. С его помощью будут отправляться сообщения на сервер.

Если вы хотите отправить оповещение на несколько серверов одновременно, используйте соответствующие вебхуки для каждого из них. Чтобы добавить поля для URL-адресов дополнительных вебхуков, нажмите «Add Webhook».

2) Content. В этом поле нужно опубликовать текст сообщения, которое вы планируете отправить на Discord-сервер. Обратите внимание на ограничение – максимальный размер сообщения 2 000 символов.

3) Profile. Здесь вы можете изменить настройки своего вебхука (если вы не сделали этого при его создании). Например, вы можете изменить его имя, а также добавить аватар.

4) Add Embed. С помощью этой кнопки вы можете вставить дополнительный текст, ссылки, изображения и т.д. Благодаря чему в вашем сообщении появится полноценное вложение.
После заполнения всех полей в правой части экрана вы увидите, как будет выглядеть ваше сообщение в Discord. В нашем случае оно выглядит следующим образом:

Для отправки оповещения на сервер нажмите кнопку «Send» в левой части экрана (рядом с полем, в которое вы вставляли URL-адрес вебхука). После этого в Discord появится ваше сообщение, а все пользователи получат уведомление.

Как его использовать с другим сервисом

С помощью вебхуков можно настроить автоматический обмен информацией между различными сайтами и Discord. В число поддерживаемых ресурсов входят:

• CircleCl
• GitHub
• DataLog

Если же вы хотите настроить отправку уведомлений с Twitch, YouTube и других площадок, вам понадобится специальный сервис – например, IFTTT.

Для работы в IFTTT нужно там зарегистрироваться. Вы можете это сделать традиционным (по email) или быстрым способом (через аккаунт Apple, Google и др.). После регистрации получите бесплатный аккаунт, с помощью которого можно настроить 5 апплетов. Чтобы увеличить их количество, вам понадобится платный аккаунт Pro (20 апплетов) или Pro+ (неограниченное количество апплетов).

Апплеты – это несамостоятельные компоненты каких-либо программ, которые работают в рамках других программ. В нашем случае речь идет о количестве синхронизаций, которые вы можете настроить между двумя разными сервисами.

Чтобы начать работу с сервисом, нажмите «Create». На открывшейся странице вы увидите кнопки для настройки триггера («If this») и соответствующего действия («Then That»).

Для добавления триггера нажмите кнопку «Add». На открывшейся странице необходимо выбрать сервис, действия внутри которого вы планируете отслеживать – например, YouTube, Twitter и т.д. В качестве примера возьмем Reddit.

После выбора сервиса вы увидите список триггеров, срабатывание которых приведет к целевому действию. Например, для Reddit триггером может служить:

• Любая новая публикация
• Новая горячая публикация
• Новая лучшая публикация
• Новая публикация из поиска
• Ваша новая публикация
• Ваш новый комментарий и т.д.

Для примера в качестве триггера выберем «Новая публикация, сохраненная вами».

После этого попросят подключить ваш аккаунт на Reddit к сервису IFTTT. Когда вы это сделаете, нажмите кнопку «Create Trigger».

Теперь вы можете приступить к настройке целевого действия. Так же нажмите кнопку «Add» и выберите сервис. В этом случае вам понадобится выбрать Webhooks, где нужно нажать на «Make a web request».

На открывшейся странице заполните следующие поля:

• URL – здесь укажите URL-адрес сгенерированного вебхука;
• Method – в этом поле нужно выбрать метод запроса (например, GET, POST, DELETE и др.). В нашем случае необходимо выбрать POST;
• Content Type – в этом поле выбираем тип содержимого (например, application/json, text/plain и пр.). В нашем случае – application/json.

Также вы можете добавить заголовок и основной текст. После того, как вы все настроите, нажмите «Create Action».

При желании вы можете добавить в цепочку дополнительные действия (это доступно только на платных тарифах). В противном случае создание апплета закончено. Останется лишь нажать кнопку «Finish» и следить за тем, как он будет работать.

При использовании IFTTT вы можете не создавать вебхуки – в качестве целевого действия достаточно выбрать Discord и публикацию сообщения на сервер. В этом случае оповещения будут приходить от бота IFTTT, а не от бота, созданного через вебхук, как мы это сделали выше.

Заключение

Таким образом, вебхук представляет собой полезный инструмент, с помощью которого можно оповещать пользователей своего Discord-сервера. При этом вы можете отправлять уведомления вручную с помощью бота, а можете пользоваться специальными сервисами для автоматической рассылки оповещений из разных платформ – YouTube, Reddit, Twitter и т.д. 

Вам понравилась статья?

4

2

На сервере может происходить много разного: регистрации пользователей, новые комментарии, кто-то начал видеотрансляцию, поступили сигналы от датчиков, случились системные события и так далее. О некоторых таких событиях было бы здорово узнавать сразу, как они произошли. Если это наш собственный сервер, то всё просто: добавляем службу мониторинга и ждём, пока наступит нужное событие.

Но на внешних публичных серверах такое сделать не получится — доступ к скриптам нам никто не даст. Вместо этого владельцы серверов часто используют вебхуки.

Что такое вебхук

Вебхук — это технология оповещения о новых событиях на сервере. С английского webhook дословно переводится как «веб-крюк» — мы как бы цепляем крюк на сервер к какому-то событию, а когда оно наступает, то мы сразу узнаём об этом.

Новым событием может быть что угодно:

Кроме самого события, сервер может передавать дополнительные данные: время события, логин пользователя, количество регистраций и другие параметры. Что именно передаёт сервер и в каком порядке — зависит от настроек сервера.

Чтобы сервер знал, куда отправлять данные, на странице делают специальное поле ввода адреса — туда мы вставляем адрес нашего сервера, который эти данные получит. Например, у конструктора страниц Тильда это сделано так: после выбора события, на которое нужно среагировать, мы попадаем на страницу, куда вводим адрес своего сервера, и выбираем, что ещё передавать:

Куда отправляются данные

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

Получается, что в вебхуках участвуют два сервера: один отправляет данные, а второй принимает. Отправляет, соответственно, чужой; принимает — наш. Допустим, мы хотим сделать так, чтобы все данные, которые пришли в вебхуке, отправлялись нам на почту. Для этого создаём на сервере php-скрипт mail.php и кладём его, например, в папку myserver.ru/test. В скрипте пишем такое:

<?php
header('Access-Control-Allow-Origin: *');
$headers = "From: webhookl@mihailmaximov.ru";​ ​
$message = print_r($_POST,true);
@mail('mail@mihailmaximov.ru', 'Новый вебхук!', $message, $headers);
echo"ok";
?>

Теперь мы можем указать адрес myserver.ru/test как адрес для отправки вебхуков. Вот что произойдёт, когда на внешнем сервере сработает нужное событие:

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

Как на сервере появляются вебхуки

Чтобы сервер мог работать с вебхуками, их нужно создать заранее:

Это значит, что не у каждого сервиса в интернете есть вебхуки — только у тех, которые сделали их специально.

Чем вебхук отличается от API

Ключевая разница между ними в том, кто первый начинает что-то делать.

Если мы работаем с сервером по API, то мы должны сначала сделать запрос, узнать, есть ли новые события, и если есть — сделать новый запрос, чтобы их получить:

С вебхуками всё проще: сервер сам следит за событиями и первый отправляет нам новые данные:

Как это применяется в жизни

Представим, что мы сделали на «Тильде» страницу с формой регистрации на мероприятие. Когда регистрируется новый участник, данные о нём попадают во внутреннюю систему «Тильды» и, например, записываются в новую гуглотаблицу — на этом действия после регистрации заканчиваются.

Но мы хотим, чтобы каждый участник после регистрации получил приветственное письмо. Для этого мы создаём новый вебхук в «Тильде» и указываем адрес нашего сервера. По этому адресу мы размещаем скрипт, который возьмёт данные из поступившего вебхука, добавит их в шаблон письма и отошлёт новому участнику. Получается, что с помощью вебхуков можно автоматизировать разные события и создавать цепочки действий, привязанных к этому событию.

Работа с объёмными данными

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

При таком подходе мы решаем сразу две проблемы: сразу узнаём, что на сервере что-то произошло, и получаем стабильный канал передачи данных. 

Вебхуки — не самый надёжный способ оповещений

Вебхук — это просто разовый POST-запрос на наш сервер. Это значит, что если по каким-то причинам мы не успели обработать этот запрос, то данные будут потеряны. У вебхуков нет гарантированной доставки, поэтому привязывать к ним критичные события не стоит — лучше поискать другой механизм мониторинга.

Ещё бывает так, что проблемы могут быть на самом сервере. Например, если зависнет сервис, который рассылает вебхуки, то мы об этом не узнаем и не получим новых данных. 

Что дальше

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

В настоящее время многие приложения поддерживают вебхуки. Вебхук это URL-адрес, который используется для перемещения данных из одной системы в другую.

Если вы используете, например, стороннее приложение для своих веб-форм, вы можете настроить вебхук событие в Автоматизации, чтобы автоматизировать такие действия как создание CRM записи после заполнения этой формы. Чтобы получить URL-адрес вебхука, выполните следующие простые шаги.

1. Перейдите в NetHunt, создайте новый процесс автоматизации и выберите «Произошло вебхук событие» в качестве триггера:

2. Затем система сгенерирует URL-адрес вебхука, который вам нужно скопировать:

3. Большинство приложений позволяют отправлять тестовый вебхук. После отправки тестового запроса нажмите «Обновить поля». Это позволит вам увидеть информацию, поступающую из события вебхука.

4. На этом этапе вы можете решить, что делать с информацией. Например, вы можете создать новую запись в указанной папке и заполнить поля папки информацией, поступающей из формы.

Что такое «Webhook URL» в Discord и для чего он нужен

Webhook URL это адресная ссылка, указывающая на определенный канал на сервере в Discord.

Она выглядит следующим образом:

https://discord.com/api/webhooks/880147380966321/HycCH_DMzkD5zXASVVvj3QRXHUnxs0pxuRzSbBs_UH7p71PS_AXD002Mq

На этот URL можно отправлять запросы POST для автоматического создания постов на канале Discord.

Это мощный инструмент, который может использоваться, например, для информационных рассылок на канале или кросс-постинга записей из соцсетей.

Как получить Webhook URL

1. Откройте Discord в приложении или браузере.

2. Переключитесь на нужный сервер.

3. Нажмите кнопку «Edit Channel» справа от названия нужного канала.

4. Переключитесь на вкладку «Integration».

5. Нажмите кнопку «Create Webhook».

6. Нажмите кнопку «Copy Webhook URL». Webhook URL будет скопирован в буфер обмена.

7. Теперь можно вставить (ctrl + v) его в стороннее приложение для кросс-постинга.

8. Аватарку и имя бота в Discord можно по желанию отредактировать.

Я год назад поставила webhook на какой-то свой адрес, но не помню какой. Как можно получить адрес моего webhook? у меня есть только доступ к боту через телегу

• 
  Вопрос задан

  более двух лет назад
  

• 313 просмотров