Боты для Discord работают в Кличате
Подключите бота на discord.js или discord.py и запустите первую слэш-команду. Для существующего бота поменяйте адреса и токен, затем зарегистрируйте его команды в Кличате.
Адреса
| Что | Адрес |
|---|---|
| REST API | https://kli.chat/api/v10. Для rest.api в discord.js указывайте https://kli.chat/api, библиотека сама добавляет версию. |
| Шлюз WebSocket | wss://kli.chat/gateway. discord.js получает его через GET /gateway/bot, в примере discord.py адрес задан явно. |
| Заголовок | Authorization: Bot <токен> |
Как получить токен
- Включите двухфакторную защиту в разделе Настройки → Моя учётная запись: без неё приложение не создать.
- Откройте Настройки → Разработчикам → Боты, создайте приложение и скопируйте токен его бота. Сохраните его в переменной окружения
KLICHAT_BOT_TOKEN. - Отметьте нужные права и добавьте бота на свой сервер по ссылке из того же раздела. Сохраните ID тестового сервера в
KLICHAT_GUILD_ID.
Примеры ниже регистрируют /пинг на тестовом сервере. Запустите бота и вызовите команду в чате. Ответ «Понг!» увидите только вы.
Для /пинг привилегированные intents не нужны. Включайте их в настройках приложения, если боту нужны события участников, присутствие или содержимое обычных сообщений. Если бот запросит выключенный привилегированный intent, шлюз закроет соединение с кодом 4014.
discord.js
Установите npm install discord.js@14. Адрес шлюза библиотека возьмёт из ответа API.
const { Client, Events, GatewayIntentBits, MessageFlags } = require('discord.js')
const client = new Client({
intents: [GatewayIntentBits.Guilds],
rest: { api: 'https://kli.chat/api' },
})
client.once(Events.ClientReady, async (bot) => {
await bot.application.commands.create(
{ name: 'пинг', description: 'Проверить, что бот отвечает' },
process.env.KLICHAT_GUILD_ID,
)
})
client.on(Events.InteractionCreate, async (interaction) => {
if (interaction.isChatInputCommand() && interaction.commandName === 'пинг') {
await interaction.reply({ content: 'Понг!', flags: MessageFlags.Ephemeral })
}
})
if (!process.env.KLICHAT_GUILD_ID) throw new Error('Укажите KLICHAT_GUILD_ID')
client.login(process.env.KLICHAT_BOT_TOKEN)
discord.py
Установите python -m pip install discord.py==2.7.1. Перед запуском бота задайте адреса REST и шлюза Кличата.
import os
import discord
from discord import app_commands
from discord.gateway import DiscordWebSocket
from discord.http import Route
from yarl import URL
Route.BASE = 'https://kli.chat/api/v10'
DiscordWebSocket.DEFAULT_GATEWAY = URL('wss://kli.chat/gateway')
guild = discord.Object(id=int(os.environ['KLICHAT_GUILD_ID']))
class KlichatBot(discord.Client):
def __init__(self):
super().__init__(intents=discord.Intents(guilds=True))
self.tree = app_commands.CommandTree(self)
async def setup_hook(self):
await self.tree.sync(guild=guild)
client = KlichatBot()
@client.tree.command(name='пинг', description='Проверить, что бот отвечает', guild=guild)
async def ping(interaction: discord.Interaction):
await interaction.response.send_message('Понг!', ephemeral=True)
client.run(os.environ['KLICHAT_BOT_TOKEN'])
tree.sync(guild=guild) заменяет список команд этого приложения на выбранном сервере. Используйте отдельное тестовое приложение или включите в дерево все команды, которые хотите сохранить.
Что поддерживается
- Глобальные и серверные слэш-команды, аргументы, подкоманды и автодополнение.
- Кнопки, выпадающие списки и ответы, видимые только вызвавшему. Команды, нажатия и запросы подсказок приходят боту через
INTERACTION_CREATE. - Сообщения и вложения, реакции, ветки, роли, каналы, участники, присутствие и вебхуки.
- Шлюз с intents, шардированием,
zlib-streamи восстановлением сессии после короткого обрыва. - Вход через Кличат по OAuth2 для сайтов и сервисов.
Если что-то в библиотеке ведёт себя не так, как с Discord, напишите в канал #боты-и-api на официальном сервере Кличата или в поддержку.
Документация
- Слэш-команды и кнопки — регистрация, события и примеры ответов по REST.
- Шлюз WebSocket — подключение, восстановление сессии, опкоды, события и intents.
- Вход через Кличат (OAuth2).
- Коды ошибок.
- OpenAPI 3.1 — полное описание REST.
Частые вопросы
Нужно ли переписывать бота под Кличат?
Для поддерживаемых операций подойдут обычные обработчики discord.js и discord.py. Используйте адреса и токен Кличата, повторно зарегистрируйте команды и проверьте права бота.
Работают ли слэш-команды?
Да. Команды можно зарегистрировать на одном сервере или глобально. Для первого ответа у бота есть 3 секунды. Если обработка займёт дольше, подтвердите вызов через deferReply() или interaction.response.defer(), затем отправьте ответ.
Может ли бот зайти в голосовой канал?
Сторонние боты могут получать события голосовых состояний. Подключение к аудио через библиотеки Discord пока недоступно. Встроенный бот «Кличат Музыка» играет в голосовых каналах.
Ещё по теме
- Документация API
Документация API Кличата для разработчиков ботов и сервисов. REST, слэш-команды, интерактивные сообщения, шлюз WebSocket, intents, OAuth2 и OpenAPI.
- Слэш-команды и кнопки
Регистрация слэш-команд для ботов, события INTERACTION_CREATE, кнопки, списки, автодополнение и ответы только для вызвавшего.
- Шлюз WebSocket
Протокол шлюза Кличата для ботов: подключение, опкоды, коды закрытия, READY, события DISPATCH, intents. Совместим с библиотеками для Discord.
Попробуйте Кличат
Бесплатно. Регистрация занимает минуту: номер телефона, код и имя. Из-за рубежа — по почте.