Войти

Боты для Discord работают в Кличате

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

Создать аккаунтОткрыть в браузере

Адреса

ЧтоАдрес
REST APIhttps://kli.chat/api/v10. Для rest.api в discord.js указывайте https://kli.chat/api, библиотека сама добавляет версию.
Шлюз WebSocketwss://kli.chat/gateway. discord.js получает его через GET /gateway/bot, в примере discord.py адрес задан явно.
ЗаголовокAuthorization: Bot <токен>

Как получить токен

  1. Включите двухфакторную защиту в разделе Настройки → Моя учётная запись: без неё приложение не создать.
  2. Откройте Настройки → Разработчикам → Боты, создайте приложение и скопируйте токен его бота. Сохраните его в переменной окружения KLICHAT_BOT_TOKEN.
  3. Отметьте нужные права и добавьте бота на свой сервер по ссылке из того же раздела. Сохраните 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) заменяет список команд этого приложения на выбранном сервере. Используйте отдельное тестовое приложение или включите в дерево все команды, которые хотите сохранить.

Что поддерживается

Если что-то в библиотеке ведёт себя не так, как с Discord, напишите в канал #боты-и-api на официальном сервере Кличата или в поддержку.

Документация

Частые вопросы

Нужно ли переписывать бота под Кличат?

Для поддерживаемых операций подойдут обычные обработчики discord.js и discord.py. Используйте адреса и токен Кличата, повторно зарегистрируйте команды и проверьте права бота.

Работают ли слэш-команды?

Да. Команды можно зарегистрировать на одном сервере или глобально. Для первого ответа у бота есть 3 секунды. Если обработка займёт дольше, подтвердите вызов через deferReply() или interaction.response.defer(), затем отправьте ответ.

Может ли бот зайти в голосовой канал?

Сторонние боты могут получать события голосовых состояний. Подключение к аудио через библиотеки Discord пока недоступно. Встроенный бот «Кличат Музыка» играет в голосовых каналах.

Ещё по теме

Попробуйте Кличат

Бесплатно. Регистрация занимает минуту: номер телефона, код и имя. Из-за рубежа — по почте.