Discord
Сообщения, каналы, роли и вебхуки Discord в процессах Pailot
Discord — чаты сообществ и команд: каналы, роли, треды. Блок ходит в API (Application Programming Interface — программный интерфейс) по токену бота.
С Discord в Pailot вы можете:
- Писать, читать, править и удалять сообщения; ставить реакции; закреплять
- Создавать треды, каналы, роли и приглашения
- Исключать, блокировать и менять участников
- Создавать и вызывать вебхук (входящий HTTP-запрос) канала
Чтобы читать текст сообщений, в портале разработчика Discord у бота включите Message Content Intent. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Токен — в переменных окружения рабочего пространства. Не публикуйте URL вебхука.
Отправить сообщение в канал Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала Discord |
content | string | Нет | Текст сообщения |
serverId | string | Да | ID сервера Discord (guild ID) |
files | file[] | Нет | Вложения |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сообщения Discord |
↳ id | string | ID автора |
↳ content | string | Текст сообщения |
↳ channel_id | string | ID канала, куда отправили сообщение |
↳ author | object | Автор сообщения |
↳ id | string | ID автора |
↳ username | string | Имя автора |
↳ avatar | string | Хеш аватара автора |
↳ bot | boolean | Автор — бот |
↳ username | string | Имя автора |
↳ avatar | string | Хеш аватара автора |
↳ bot | boolean | Автор — бот |
↳ timestamp | string | Время сообщения |
↳ edited_timestamp | string | Когда сообщение правили |
↳ embeds | array | Встраивания сообщения |
↳ attachments | array | Вложения сообщения |
↳ mentions | array | Упоминания пользователей |
↳ mention_roles | array | Упоминания ролей |
↳ mention_everyone | boolean | Сообщение упоминает всех |
Прочитать сообщения канала Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала Discord |
limit | number | Нет | Максимум сообщений (по умолчанию 10, максимум 100) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Контейнер сообщений |
↳ messages | array | Массив сообщений Discord с метаданными |
↳ id | string | ID автора |
↳ content | string | Текст сообщения |
↳ channel_id | string | ID канала |
↳ author | object | Автор сообщения |
↳ id | string | ID автора |
↳ username | string | Имя автора |
↳ avatar | string | Хеш аватара автора |
↳ bot | boolean | Автор — бот |
↳ username | string | Имя автора |
↳ avatar | string | Хеш аватара автора |
↳ bot | boolean | Автор — бот |
↳ timestamp | string | Время сообщения |
↳ edited_timestamp | string | Когда сообщение правили |
↳ embeds | array | Встраивания сообщения |
↳ attachments | array | Вложения сообщения |
↳ mentions | array | Упоминания пользователей |
↳ mention_roles | array | Упоминания ролей |
↳ mention_everyone | boolean | Сообщение упоминает всех |
↳ id | string | ID автора |
↳ content | string | Текст сообщения |
↳ channel_id | string | ID канала |
↳ author | object | Автор сообщения |
↳ id | string | ID автора |
↳ username | string | Имя автора |
↳ avatar | string | Хеш аватара автора |
↳ bot | boolean | Автор — бот |
↳ username | string | Имя автора |
↳ avatar | string | Хеш аватара автора |
↳ bot | boolean | Автор — бот |
↳ timestamp | string | Время сообщения |
↳ edited_timestamp | string | Когда сообщение правили |
↳ embeds | array | Встраивания сообщения |
↳ attachments | array | Вложения сообщения |
↳ mentions | array | Упоминания пользователей |
↳ mention_roles | array | Упоминания ролей |
↳ mention_everyone | boolean | Сообщение упоминает всех |
Данные сервера Discord (guild)
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сервера Discord (guild) |
↳ id | string | ID сервера |
↳ name | string | Имя сервера |
↳ icon | string | Хеш иконки сервера |
↳ description | string | Описание сервера |
↳ owner_id | string | ID владельца сервера |
↳ roles | array | Роли сервера |
↳ channels | array | Каналы сервера |
↳ member_count | number | Число участников сервера |
Данные пользователя Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота Discord |
userId | string | Да | ID пользователя Discord |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные пользователя Discord |
↳ id | string | ID пользователя |
↳ username | string | Имя пользователя |
↳ discriminator | string | Дискриминатор пользователя (4 цифры) |
↳ avatar | string | Хеш аватара пользователя |
↳ bot | boolean | Пользователь — бот |
↳ system | boolean | Системный пользователь |
↳ email | string | Email пользователя (если есть) |
↳ verified | boolean | Email пользователя подтверждён |
Изменить сообщение в канале Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала с сообщением |
messageId | string | Да | ID сообщения |
content | string | Нет | Новый текст сообщения |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Обновлённое сообщение Discord |
↳ id | string | ID сообщения |
↳ content | string | Обновлённый текст сообщения |
↳ channel_id | string | ID канала |
↳ edited_timestamp | string | Когда сообщение правили |
Удалить сообщение из канала Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала с сообщением |
messageId | string | Да | ID сообщения |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Поставить реакцию на сообщение Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала с сообщением |
messageId | string | Да | ID сообщения |
emoji | string | Да | Эмодзи (юникод или своё в формате name:id) |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Снять реакцию с сообщения Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала с сообщением |
messageId | string | Да | ID сообщения с реакцией |
emoji | string | Да | Эмодзи для снятия (юникод или своё в формате name:id) |
userId | string | Нет | ID пользователя, чью реакцию снять (пусто — реакцию бота) |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Закрепить сообщение в канале
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала с сообщением |
messageId | string | Да | ID сообщения |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Открепить сообщение в канале
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала с сообщением |
messageId | string | Да | ID сообщения |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Создать тред в канале Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала для треда |
name | string | Да | Имя треда (1–100 символов) |
messageId | string | Нет | ID сообщения, из которого создать тред |
autoArchiveDuration | number | Нет | Минуты до автоархива треда (60, 1440, 4320, 10080) |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные созданного треда |
↳ id | string | ID треда |
↳ name | string | Имя треда |
↳ type | number | Тип канала треда |
↳ guild_id | string | ID сервера |
↳ parent_id | string | ID родительского канала |
Войти в тред Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
threadId | string | Да | ID треда |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Выйти из треда Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
threadId | string | Да | ID треда |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Архивировать или разархивировать тред
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
threadId | string | Да | ID треда |
archived | boolean | Да | Архивировать (true) или разархивировать (false) |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Обновлённые данные треда |
↳ id | string | ID треда |
↳ archived | boolean | Тред в архиве |
Создать канал на сервере Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
name | string | Да | Имя канала (1–100 символов) |
type | number | Нет | Тип канала (0=текст, 2=голос, 4=категория, 5=анонсы, 13=сцена) |
topic | string | Нет | Тема канала (0–1024 символа) |
parentId | string | Нет | ID родительской категории |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные созданного канала |
↳ id | string | ID канала |
↳ name | string | Имя канала |
↳ type | number | Тип канала |
↳ guild_id | string | ID сервера |
Обновить канал Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала Discord |
name | string | Нет | Новое имя канала |
topic | string | Нет | Новая тема канала |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Обновлённые данные канала |
↳ id | string | ID канала |
↳ name | string | Имя канала |
↳ type | number | Тип канала |
↳ topic | string | Тема канала |
Удалить канал Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала Discord |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Данные канала Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала Discord |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные канала |
↳ id | string | ID канала |
↳ name | string | Имя канала |
↳ type | number | Тип канала |
↳ topic | string | Тема канала |
↳ guild_id | string | ID сервера |
Создать роль на сервере Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
name | string | Да | Имя роли |
color | number | Нет | Цвет RGB целым числом (например, 0xFF0000 — красный) |
hoist | boolean | Нет | Показывать участников роли отдельно |
mentionable | boolean | Нет | Роль можно упоминать |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные созданной роли |
↳ id | string | ID роли |
↳ name | string | Имя роли |
↳ color | number | Цвет роли |
↳ hoist | boolean | Роль отделена в списке |
↳ mentionable | boolean | Роль можно упоминать |
Обновить роль на сервере Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
roleId | string | Да | ID роли |
name | string | Нет | Новое имя роли |
color | number | Нет | Цвет RGB целым числом |
hoist | boolean | Нет | Показывать участников роли отдельно |
mentionable | boolean | Нет | Роль можно упоминать |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Обновлённые данные роли |
↳ id | string | ID роли |
↳ name | string | Имя роли |
↳ color | number | Цвет роли |
Удалить роль с сервера Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
roleId | string | Да | ID роли |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Назначить роль участнику
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
userId | string | Да | ID пользователя |
roleId | string | Да | ID роли |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Снять роль с участника
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
userId | string | Да | ID пользователя |
roleId | string | Да | ID роли |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Исключить участника с сервера
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
userId | string | Да | ID пользователя |
reason | string | Нет | Причина исключения |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Заблокировать участника на сервере
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
userId | string | Да | ID пользователя |
reason | string | Нет | Причина блокировки |
deleteMessageDays | number | Нет | За сколько дней удалить сообщения (0–7) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Разблокировать участника
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
userId | string | Да | ID пользователя |
reason | string | Нет | Причина снятия блокировки |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Данные участника сервера
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
userId | string | Да | ID пользователя |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные участника |
↳ user | object | Данные пользователя |
↳ id | string | ID пользователя |
↳ username | string | Имя пользователя |
↳ avatar | string | Хеш аватара |
↳ id | string | ID пользователя |
↳ username | string | Имя пользователя |
↳ avatar | string | Хеш аватара |
↳ nick | string | Ник на сервере |
↳ roles | array | Массив ID ролей |
↳ joined_at | string | Когда участник присоединился |
Обновить участника (например, ник)
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
serverId | string | Да | ID сервера Discord (guild ID) |
userId | string | Да | ID пользователя |
nick | string | Нет | Новый ник (null — снять) |
mute | boolean | Нет | Заглушить в голосовых каналах |
deaf | boolean | Нет | Отключить звук в голосовых каналах |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Обновлённые данные участника |
↳ nick | string | Ник на сервере |
↳ mute | boolean | Заглушен в голосовом канале |
↳ deaf | boolean | Отключён звук в голосовом канале |
Создать приглашение в канал
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала для приглашения |
maxAge | number | Нет | Срок приглашения в секундах (0 — без срока, по умолчанию 86400) |
maxUses | number | Нет | Максимум использований (0 — без лимита) |
temporary | boolean | Нет | Временное членство |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные созданного приглашения |
↳ code | string | Код приглашения |
↳ url | string | Полный URL приглашения |
↳ max_age | number | Максимальный возраст в секундах |
↳ max_uses | number | Максимум использований |
↳ temporary | boolean | Временное |
Данные приглашения Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
inviteCode | string | Да | Код приглашения |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные приглашения |
↳ code | string | Код приглашения |
↳ guild | object | Сведения о сервере |
↳ channel | object | Сведения о канале |
↳ approximate_member_count | number | Приблизительное число участников |
↳ approximate_presence_count | number | Приблизительное число онлайн |
Удалить приглашение Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
inviteCode | string | Да | Код приглашения |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
Создать вебхук в канале
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
channelId | string | Да | ID канала для вебхука |
name | string | Да | Имя вебхука (1–80 символов) |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные созданного вебхука |
↳ id | string | ID вебхука |
↳ name | string | Имя вебхука |
↳ token | string | Токен вебхука |
↳ url | string | URL вебхука |
↳ channel_id | string | ID канала |
Вызвать вебхук Discord — отправить сообщение
| Параметр | Тип | Обязательный | Описание |
|---|
webhookId | string | Да | ID вебхука |
webhookToken | string | Да | Токен вебхука |
content | string | Да | Текст сообщения |
username | string | Нет | Подменить имя вебхука |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Сообщение, отправленное вебхуком |
↳ id | string | ID сообщения |
↳ content | string | Текст сообщения |
↳ channel_id | string | ID канала |
↳ timestamp | string | Время сообщения |
Данные вебхука Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
webhookId | string | Да | ID вебхука |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные вебхука |
↳ id | string | ID вебхука |
↳ name | string | Имя вебхука |
↳ channel_id | string | ID канала |
↳ guild_id | string | ID сервера |
↳ token | string | Токен вебхука |
Удалить вебхук Discord
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен бота |
webhookId | string | Да | ID вебхука |
serverId | string | Да | ID сервера Discord (guild ID) |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
