Создание бота
Шаг 1. Создайте приложение (перейдите по ссылке).
Шаг 2. Добавьте бота (нажмите на кнопку "Add Bot").
Шаг 2.1. В разделе Installation выберите Install Link → None.
Шаг 2.2. В разделе Bot отключите Public Bot, затем включите следующие Intents:
- Message Content Intent
- Server Members Intent
Вы также можете включить Presence Intent для использования в будущем.
Шаг 3. Получите токен (Reset Token).
Шаг 4. Добавьте бота на сервер:
- Перейдите в OAuth2 → URL Generator.
- В Scopes выберите bot.
- В Bot Permissions выберите Send Messages, Read Message History и любые другие необходимые разрешения.
Затем откройте сгенерированную ссылку, выберите сервер, на который хотите добавить бота, и подтвердите авторизацию.
Чтобы получить полный вебхук от Discord, просто присвойте любое значение переменной save_webhook.
Если переменная установлена, вебхук будет сохранён в discord_webhook.
Подключение Discord-бота в MaviBot
Теперь перейдите в раздел "Messengers" в вашем проекте в MaviBot:
Затем вставьте токен, скопированный из Discord.
Нажмите кнопку Done.
Функции калькулятора
Ответить на сообщение
discord_reply_to_message(message_id, text) - Эта функция используется для ответа на сообщение.
| Параметры | Описание |
|---|---|
| ! message_id | ID сообщения, на которое нужно ответить. |
| ! text | Текст ответного сообщения. |
Удалить сообщение
discord_delete_message(message_id) - Эта функция используется для удаления сообщения.
| Параметры | Описание |
|---|---|
| ! message_id | ID сообщения, которое нужно удалить. |
Редактировать сообщение
discord_edit_message(message_id, text) - Эта функция используется для редактирования сообщения.
| Параметры | Описание |
|---|---|
| ! message_id | ID сообщения, которое нужно отредактировать. |
| ! text | Новый текст сообщения. |
Закрепить сообщение
discord_pin_message(message_id) - Эта функция используется для закрепления сообщения.
| Параметры | Описание |
|---|---|
| ! message_id | ID сообщения, которое нужно закрепить. |
Открепить сообщение
discord_unpin_message(message_id) - Эта функция используется для открепления сообщения.
| Параметры | Описание |
|---|---|
| ! message_id | ID сообщения, которое нужно открепить. |
Отправить реакцию на сообщение
discord_send_reaction(message_id, reaction) - Эта функция используется для отправки реакции на сообщение.
| Параметры | Описание |
|---|---|
| ! message_id | ID сообщения, на которое нужно отправить реакцию. |
| ! reaction | Реакция для отправки. Вы можете указать один эмодзи (например, ❤️) или ID пользовательского эмодзи на сервере. Информация о том, как получить ID пользовательского эмодзи, приведена ниже. |
Удалить реакцию с сообщения в канале
discord_delete_reaction(message_id, reaction, user_id) - Эта функция используется для удаления реакции с сообщения в канале.
| Параметры | Описание |
|---|---|
| ! message_id | ID сообщения, с которого нужно удалить реакцию. |
| ! reaction | Реакция для удаления. Вы можете указать один эмодзи (например, ❤️) или ID пользовательского эмодзи на сервере. Информация о том, как получить ID пользовательского эмодзи, приведена ниже. |
| user_id | ID пользователя, чью реакцию вы хотите удалить. Этот параметр необязателен, если вы хотите удалить реакцию текущего бота. |
Callbacks
Когда пользователь отправляет реакцию, в чат приходит callback в следующем формате:
new_like ❤️ uid413984787162726410
Где uid413984787162726410 — это ID пользователя, отправившего реакцию.
Как получить ID пользовательского эмодзи
Если вы отправите пользовательскую реакцию на сообщение в канале Discord, будет получен callback в следующем формате:
new_like beer:1479419477396291696 uid413984787162726410
Где beer:1479419477396291696 — это ID реакции. Вы можете скопировать его для использования в функциях, связанных с реакциями.
Как получить ID сообщения
Вы можете получить ID сообщения клиента из вебхука, если включён save_webhook. Пример:
data = discord_webhook["data"]
msg_id = data["id"]
result = discord_reply_to_message(msg_id, "Это ответ на сообщение")