Как написать через вебхук дискорд

Дата публикации: 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

1

# Webhooks

Webhooks can send messages to a text channel without having to log in as a bot. discord.js implements a variety of methods to fetch, create, edit, and use webhooks. In this section, you will learn how to create, fetch, edit, and use webhooks.

# What is a webhook

Webhooks are a utility used to send messages to text channels without needing a Discord application. Webhooks are useful for allowing something to send messages without requiring a Discord application. However, you should note that you cannot directly edit or delete messages you sent through the webhook. discord.js introduces two structures to make use of this functionality, Webhook and WebhookClient. WebhookClient is an extended version of a Webhook which allows you to send messages through it without needing a bot client.

# Detecting webhook messages

Bots receive webhook messages in a text channel as usual. You can detect if a webhook sent the message by checking if the Message.webhookID is not null. In this example, we return if a webhook sent the message.

If you would like to get the webhook object that sent the message, you can use Message#fetchWebhook (opens new window).

# Fetching webhooks

# Fetching all webhooks of a guild

If you would like to get all webhooks of a guild you can use Guild#fetchWebhooks() (opens new window). This will return a Promise which will resolve into a Collection of Webhooks.

# Fetching webhooks of a channel

Webhooks belonging to a channel can be fetched using TextChannel#fetchWebhooks() (opens new window). This will return a Promise which will resolve into a Collection of Webhooks. A collection will be returned even if the channel contains a single webhook. If you are certain the channel contains a single webhook, you can use Collection#first() (opens new window) on the Collection to get the webhook.

# Fetching a single webhook

# Using client

You can fetch a specific webhook using its id with Client#fetchWebhook() (opens new window). You can obtain the webhook id by looking at its link, the number after https://discord.com/api/webhooks/ is the id, and the part after that is the token.

# Using the WebhookClient constructor

If you are not using a bot client, you can get a webhook by creating a new instance of WebhookClient and passing the id and token into the constructor. These credentials do not require you to have a bot application, but it also offers limited information instead of fetching it using an authorized client.

# Creating webhooks

# Creating webhooks through server settings

You can create webhooks directly through the Discord client. Go to Server Settings, and you will see an Integrations tab.

If you already have created a webhook, the webhooks tab will look like this; you will need to click the View Webhooks button.

Once you are there, click on the Create Webhook / New Webhook button; this will create a webhook. From here, you can edit the channel, the name, and the avatar. Copy the link, the first part is the id, and the second is the token.

# Creating webhooks with discord.js

discord.js provides a method for creating webhooks called TextChannel#createWebhook() (opens new window).

# Editing webhooks

You can edit Webhooks and WebhookClients to change their name, avatar, and channel using Webhook#edit() (opens new window).

# Using webhooks

Webhooks, unlike bots, can send more than one embed per message, up to 10. They can also send attachments and normal content. The Webhook#send() (opens new window) method to send to a webhook is very similar to the method for sending to a text channel. Webhooks can also choose how the username and avatar will appear when they send the message.

Example using a WebhookClient:

Example using a Webhook:

# Resulting code

If you want to compare your code to the code we’ve constructed so far, you can review it over on the GitHub repository

here (opens new window).

platforms | Dec 14, 2021

https://discord.com/api/oauth2/authorize?client_id={{client_id}}&scope=bot&permissions={{permissions_integer}}

https://discordapp.com/api/channels/{{channel_id}}/webhooks

Authorization: Bot {{bot_token}}

{
	name : "my test webhook"
}

https://discord.com/api/webhooks/{{webhook_id}}/{{webhook_token}}

Related Guides

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

Что такое и зачем нужны Вебхуки в Дискорде

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

Под определением Discord Webhook php подразумевается дополнительная функция, активация которой позволяет в автоматическом режиме получать соответствующие уведомления относительно обновления по тематическому сообществу. Умение грамотно управлять специально разработанной опцией, можно в реальном времени организовать непрерывное получение информации с различных виртуальных платформ. Обратите внимание, во время создания конечного тематического сервера Вебхук в программном обеспечении Дискорд, осуществляется генерирование уникального адреса. Полученную скопированную URL-ссылку, можно делиться ее с участниками и площадками.

Подключение вебхуков и настройка

Использование специализированного программного обеспечения Дискорд Вебхук требует от пользователя качественного интернет-соединения с другой платформой. Однако необходимо обращать внимание на то, что далеко не все порталы способны обеспечить обмен информацией. Поэтому перед подключением функции, пользователям рекомендуется ознакомиться с сайтами, которые поддерживаются:

• CircleCI;
• GitHub;
• DataDog.

При этом следующие порталы не поддерживаются функцией Вебхука:

• Твич;
• Фейсбук;
• YouTube;
• Nelly The Hamster.

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

• Осуществляется запуск программного обеспечения Дискорд с последующей авторизацией в личном кабинете. При отсутствии учетной записи заполняется регистрационная анкета.
• В левой части панели управления пользователь выбирает из представленного списка определенный тематический сервер путем нажатия на правую кнопку мыши.
• На следующем этапе выполняется переход в раздел внесения настроек.
• Во вновь открывшейся форме требуется перейти в подкатегорию Вебхуки.
• Далее указывается уникальное имя серверу.
• После этого активируется клавиша создания вебхука.
• На следующем этапе осуществляется загрузка интересующего изображения.

Обратите внимание, рекомендуется пользоваться стандартным размером 256х256.

Нажимается клавиша сохранения полученных результатов.

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

Официальный пример: интеграция Webhook GitHub

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

• Изначально требуется выполнить переход по адресу discordapp.com.
• После авторизации в личном кабинете осуществляется переход в настройки с последующим выбором функции создания.
• Нажатие правой клавишей мыши на интересующий сервер для вызова функции настроек.
• Ввод персонального уникального имени тематическому каналу, загрузка привлекательного изображения – при условии, что ранее пользователь не выполнят рассматриваемых действий.
• На следующем этапе осуществляется копирование уникального URL-адреса.

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

Далее пользователь осуществляет нажатие на клавишу добавления рассматриваемой функции с обязательным вводом полученной ранее уникальной ссылки в специально отведенное поле.

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

Дополнительно рекомендуется в специально разработанной категории Content Type активировать параметр application/json. После этого пользователь осуществляет выбор ивент-тригеров, которые в последующем используются во время обмена информацией в сообщениях.

Последний этап дополнительных настроек предусматривает нажатие клавишей мыши на Add Webhook, которая расположена под формой уведомления. Сохранение результатов для обеспечения бесперебойной работы функции.

Обратите внимание, после соблюдения представленной последовательности действий, любой тип обновления в репозитари, включая корректировки данных в режиме «редми», автоматически отображаются в тематическом текстовом канале программного обеспечения. В конечном итоге будет автоматически сформирована соответствующая ссылка функции discordapp.com/api/webhooks/698070180693278780/XG1VRZQ8cGnCEG9wNjbvpSk605AugbK3HQ9Hxk8aJ9bm1MCfsL6gFSqV3U-SZkdxY0a8/github.

Как писать от имени вебхука в Дискорд

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