BANNGRU Bot API

const { Client, GatewayIntentBits } = require('discord.js');

const BANNGRU_API = 'https://web.banngru.ru/api/v10';
const BANNGRU_GATEWAY = 'wss://web.banngru.ru/bot-gw';

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
  rest: {
    api: BANNGRU_API,
    version: '', // Отключаем версионирование
  },
});

client.on('ready', () => {
  console.log(`Бот ${client.user.tag} подключён к BANNGRU!`);
});

client.on('messageCreate', async (message) => {
  if (message.author.bot) return;
  if (message.content === '!ping') {
    await message.reply('Понг! 🏓');
  }
});

client.login('ВАШ_BANNGRU_BOT_ТОКЕН');

Authorization: Bot YOUR_BOT_TOKEN

curl -X POST https://web.banngru.ru/api/bots \
  -H "Authorization: Bearer <твой_jwt_токен>" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "mybot",
    "display_name": "Мой Бот",
    "description": "Тестовый бот",
    "is_public": true
  }'

{
  "success": true,
  "bot": {
    "id": 10,
    "username": "mybot",
    "display_name": "Мой Бот",
    "token": "a1b2c3d4e5f6...64_символа_hex",
    "is_active": true
  }
}

curl -X POST https://web.banngru.ru/api/servers/<serverId>/bots/<botId>/install \
  -H "Authorization: Bearer <jwt_токен_владельца>"

{
  "op": 2,
  "d": {
    "token": "Bot ВАШ_ТОКЕН",
    "intents": 513,
    "properties": {
      "os": "linux",
      "browser": "discord.js",
      "device": "discord.js"
    }
  }
}

// Через discord.js
const channel = await client.channels.fetch('channel_id');
await channel.send('Привет! 👋');

// С embed
const embed = new EmbedBuilder()
  .setTitle('Заголовок')
  .setDescription('Описание')
  .setColor(0x5865F2);
await channel.send({ embeds: [embed] });

// С кнопками
const row = new ActionRowBuilder()
  .addComponents(
    new ButtonBuilder()
      .setCustomId('yes')
      .setLabel('✅ Да')
      .setStyle(ButtonStyle.Primary),
    new ButtonBuilder()
      .setCustomId('no')
      .setLabel('❌ Нет')
      .setStyle(ButtonStyle.Danger)
  );
await channel.send({ content: 'Выберите:', components: [row] });

const message = await channel.messages.fetch('message_id');
await message.edit('Обновлённый текст');

await message.delete();

const { REST, Routes, SlashCommandBuilder } = require('discord.js');

const rest = new REST({ version: '' })
  .setToken('ВАШ_BANNGRU_BOT_ТОКЕН');

rest.options.api = 'https://web.banngru.ru/api/v10';

const commands = [
  new SlashCommandBuilder()
    .setName('ping')
    .setDescription('Проверка связи'),
  new SlashCommandBuilder()
    .setName('say')
    .setDescription('Бот скажет что-то')
    .addStringOption(opt =>
      opt.setName('text').setDescription('Текст').setRequired(true)
    ),
];

const BOT_ID = 'ваш_bot_id';
const GUILD_ID = 'id_сервера';

(async () => {
  await rest.put(
    Routes.applicationGuildCommands(BOT_ID, GUILD_ID),
    { body: commands.map(c => c.toJSON()) }
  );
  console.log('Команды зарегистрированы!');
})();

client.on('interactionCreate', async (interaction) => {
  if (!interaction.isChatInputCommand()) return;

  if (interaction.commandName === 'ping') {
    await interaction.reply('Понг! 🏓');
  }

  if (interaction.commandName === 'say') {
    const text = interaction.options.getString('text');
    await interaction.reply(text);
  }
});

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,           // GUILD_CREATE и т.д.
    GatewayIntentBits.GuildMessages,     // MESSAGE_CREATE в каналах
    GatewayIntentBits.MessageContent,    // content, embeds, attachments
  ],
});

X-RateLimit-Limit: 3
X-RateLimit-Remaining: 0
X-RateLimit-Reset-After: 2.5
Retry-After: 3

curl -X POST https://web.banngru.ru/api/bots/:botId/webhook \
  -H "Authorization: Bearer <user_token>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook"}'

const crypto = require('crypto');

function verifySignature(body, signature, token) {
    const expected = crypto.createHmac('sha256', token)
        .update(JSON.stringify(body))
        .digest('hex');
    return signature === expected;
}

// Проверка в обработчике
app.post('/webhook', (req, res) => {
    const signature = req.headers['x-bot-signature'];
    if (!verifySignature(req.body, signature, BOT_TOKEN)) {
        return res.status(401).send('Invalid signature');
    }
    // Обработка события
    res.send('OK');
});

POST /api/v10/channels/:channelId/voice/connect
Authorization: Bot ВАШ_ТОКЕН

{
  "url": "wss://lk.banngru.ru",
  "token": "<JWT для LiveKit>",
  "identity": "-42",
  "room": "123",
  "expires_in": 86400
}

from livekit import rtc
import aiohttp

async def play(channel_id, bot_token):
    async with aiohttp.ClientSession() as s:
        async with s.post(
            f'https://web.banngru.ru/api/v10/channels/{channel_id}/voice/connect',
            headers={'Authorization': f'Bot {bot_token}'}
        ) as r:
            creds = await r.json()

    room = rtc.Room()
    # auto_subscribe=False — токен и так без canSubscribe, лишний трафик не нужен
    await room.connect(creds['url'], creds['token'], rtc.RoomOptions(auto_subscribe=False))

    source = rtc.AudioSource(48000, 2)
    track = rtc.LocalAudioTrack.create_audio_track('bot-audio', source)
    await room.local_participant.publish_track(
        track, rtc.TrackPublishOptions(source=rtc.TrackSource.SOURCE_MICROPHONE))

    # Кадры по 20 мс: 48000 Гц * 0.02 с = 960 сэмплов на канал, s16le stereo.
    # capture_frame сам задаёт темп воспроизведения — отдельный sleep не нужен.
    while chunk := read_pcm_20ms():  # ваш источник PCM
        await source.capture_frame(rtc.AudioFrame(
            data=chunk, sample_rate=48000, num_channels=2, samples_per_channel=960))

POST /api/v10/channels/:channelId/voice/disconnect
Authorization: Bot ВАШ_ТОКЕН

GET /api/v10/guilds/:guildId/voice-states
Authorization: Bot ВАШ_ТОКЕН

// Получить пользователя
const user = await client.users.fetch('user_id');

// Отправить DM
await user.send('Привет! Это личное сообщение от бота.');

// С embed
const embed = new EmbedBuilder()
  .setTitle('Уведомление')
  .setDescription('Важное сообщение для вас')
  .setColor(0x00ff88);
await user.send({ embeds: [embed] });

client.on('messageCreate', async (message) => {
  // Проверяем, что это DM (не в канале сервера)
  if (message.channel.type === ChannelType.DM) {
    console.log(`DM от ${message.author.tag}: ${message.content}`);
    await message.reply('Спасибо за сообщение!');
  }
});

const { Client, GatewayIntentBits, REST, Routes, SlashCommandBuilder, EmbedBuilder } = require('discord.js');

const BOT_TOKEN = process.env.BOT_TOKEN || 'ваш_токен';
const BOT_ID = process.env.BOT_ID || 'ваш_bot_id';
const API_BASE = 'https://web.banngru.ru/api/v10';

// Создаём клиент
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
  rest: {
    api: API_BASE,
    version: '',
  },
});

// Регистрация команд при старте
client.once('ready', async () => {
  console.log(`✅ ${client.user.username} подключён к BANNGRU!`);

  const rest = new REST({ version: '' }).setToken(BOT_TOKEN);
  rest.options.api = API_BASE;

  const commands = [
    new SlashCommandBuilder().setName('ping').setDescription('Понг!'),
    new SlashCommandBuilder().setName('server').setDescription('Инфо о сервере'),
    new SlashCommandBuilder()
      .setName('echo')
      .setDescription('Повторить текст')
      .addStringOption(o => o.setName('text').setDescription('Текст').setRequired(true)),
  ];

  // Регистрируем для каждого сервера
  for (const guild of client.guilds.cache.values()) {
    try {
      await rest.put(
        Routes.applicationGuildCommands(BOT_ID, guild.id),
        { body: commands.map(c => c.toJSON()) }
      );
      console.log(`  Команды зарегистрированы на ${guild.name}`);
    } catch (e) {
      console.error(`  Ошибка регистрации на ${guild.name}:`, e.message);
    }
  }
});

// Обработка сообщений
client.on('messageCreate', async (msg) => {
  if (msg.author.bot) return;

  if (msg.content === '!ping') {
    await msg.reply('🏓 Понг!');
  }
});

// Обработка slash-команд
client.on('interactionCreate', async (interaction) => {
  if (!interaction.isChatInputCommand()) return;

  switch (interaction.commandName) {
    case 'ping':
      await interaction.reply('🏓 Понг!');
      break;

    case 'server':
      const embed = new EmbedBuilder()
        .setTitle(interaction.guild.name)
        .setColor(0x5865F2)
        .addFields(
          { name: 'ID', value: interaction.guild.id, inline: true },
          { name: 'Участников', value: String(interaction.guild.memberCount), inline: true },
        );
      await interaction.reply({ embeds: [embed] });
      break;

    case 'echo':
      const text = interaction.options.getString('text');
      await interaction.reply(text);
      break;
  }
});

client.login(BOT_TOKEN);

BOT_TOKEN=ваш_токен BOT_ID=10 node bot.js

# Проверить Gateway URL
curl https://web.banngru.ru/api/v10/gateway

# Проверить авторизацию
curl https://web.banngru.ru/api/v10/users/@me \
  -H "Authorization: Bot ВАШ_ТОКЕН"

# Получить серверы бота
curl https://web.banngru.ru/api/v10/gateway/bot \
  -H "Authorization: Bot ВАШ_ТОКЕН"