Skip to Content
ИнтеграцииDiscord

Интеграция с Discord

Добавьте своего агента на серверы Discord с помощью slash-команд и личных сообщений.

Обзор

Интеграция с Discord предоставляет:

  • Поддержку slash-команд (/ask)
  • Диалоги в личных сообщениях
  • Доступность на всём сервере
  • Ответы в определённых каналах
  • Расширенное форматирование embed-сообщений
  • Опциональные текстовые DM (без префикса команды)

Предварительные требования

  • Аккаунт в Discord
  • Права Manage Server на целевом сервере
  • Доступ к Discord Developer Portal

Шаги настройки

1. Создайте приложение Discord

  1. Перейдите в Discord Developer Portal
  2. Нажмите New Application
  3. Введите имя (например, “My Support Bot”)
  4. Нажмите Create

2. Получите учётные данные

В Discord Developer Portal соберите следующие значения:

ПолеОписаниеГде найти
Application IDИдентификатор вашего Discord-приложенияСтраница General Information
Public Key64-символьная hex-строка для проверки подписиСтраница General Information
Bot TokenСекретный токен вашего ботаРаздел Bot → Reset Token
Guild ID (опционально)Идентификатор сервера для мгновенной регистрации командПравый клик по серверу → Copy Server ID

Храните Bot Token в безопасности — никогда не публикуйте его. Любой, у кого есть ваш токен, может управлять вашим ботом.

3. Подключение к Cuneiform Chat

  1. Перейдите в Integrations в боковой панели
  2. Откройте карточку Discord
  3. Введите Application ID, Public Key и Bot Token
  4. Опционально введите Guild ID для мгновенной регистрации slash-команд
  5. Нажмите Connect

4. Настройте Webhook URL (обязательно)

После подключения вы увидите диалоговое окно с вашим Webhook URL:

  1. Скопируйте Webhook URL из диалогового окна
  2. В Discord Developer Portal перейдите в General Information
  3. Найдите Interactions Endpoint URL
  4. Вставьте webhook URL и нажмите Save Changes

Этот шаг обязателен. Discord использует этот URL для отправки взаимодействий slash-команд вашему боту.

5. Добавьте бота на сервер

Используйте кнопку Add to Server на карточке интеграции или ссылку-приглашение, предоставленную после подключения. Бот будет добавлен с необходимыми правами.

Использование бота

Slash-команды

Пользователи взаимодействуют с ботом с помощью slash-команды /ask:

/ask What are your business hours?

Бот обрабатывает вопрос и отвечает в канале.

Личные сообщения

Напишите боту напрямую для приватного диалога:

  1. Найдите бота в списке участников сервера
  2. Нажмите правой кнопкой мыши и выберите Message
  3. Используйте команду /ask или включите Text DMs (см. ниже)

Переключатель Text DMs

Переключатель Text DMs на карточке интеграции управляет поведением личных сообщений:

  • Off (по умолчанию): пользователи должны использовать команду /ask в DM
  • On: пользователи могут отправлять обычные текстовые сообщения в DM (без префикса команды)

При включении Text DMs необходимо включить Message Content Intent в Discord Developer Portal → раздел Bot → Privileged Gateway Intents.

Формат ответов

Ответы отображаются в виде расширенных embed-сообщений с:

  • Текстом ответа
  • Ссылками на источники (опционально)
  • Брендингом вашего бота

Возможности

Доступ на всём сервере

После добавления бот доступен во всех текстовых каналах, где у него есть права.

Поддержка тредов

Бот может отвечать в тредах, сохраняя порядок в диалогах.

Мгновенные и глобальные команды

  • С Guild ID: slash-команды регистрируются мгновенно на этом сервере
  • Без Guild ID: глобальные команды распространяются до 1 часа

Укажите Guild ID при настройке для мгновенной доступности slash-команд. Позже можно добавить дополнительные серверы.

Управление ботом

Для каждого подключённого бота отображаются:

  • Имя пользователя бота и статус (Active/Error)
  • Application ID
  • Связанный агент
  • Время последней активности
  • Webhook URL (для справки)

Доступные действия

ДействиеОписание
Add to ServerОткрывает ссылку-приглашение для добавления бота на сервер
PortalОткрывает Discord Developer Portal для этого приложения
Copy URLКопирует webhook URL
Test ConnectionПроверяет подключение бота
DisconnectУдаляет эту интеграцию

Устранение неполадок

Бот не отвечает

  1. Убедитесь, что Interactions Endpoint URL настроен в Discord Developer Portal
  2. Проверьте, что у бота есть права в канале
  3. Проверьте правильность токена в Cuneiform Chat
  4. Убедитесь, что slash-команды зарегистрированы (/ показывает вашу команду)

Команды не отображаются

Регистрация глобальных slash-команд может занять до часа. Для немедленного тестирования:

  • Укажите Guild ID при настройке для мгновенной регистрации
  • Подождите глобального распространения, если Guild ID не был указан

Ошибки прав доступа

Убедитесь, что у бота есть следующие права:

  • Send Messages
  • Use Slash Commands
  • Embed Links
  • Read Message History (для поддержки тредов)

Text DMs не работают

  1. Убедитесь, что переключатель Text DMs включён на карточке интеграции
  2. Включите Message Content Intent в Discord Developer Portal → раздел Bot
  3. При необходимости перезапустите подключение бота

Безопасность

  • Bot Token зашифрованы и хранятся в защищённом виде
  • Команды используют встроенную проверку подписи Discord
  • Данные сервера не используются за пределами прямых взаимодействий

Отключение

Чтобы удалить интеграцию с Discord:

  1. Перейдите в Integrations в боковой панели
  2. Нажмите меню с тремя точками на вашем Discord-боте
  3. Выберите Disconnect

Чтобы полностью удалить бота из Discord:

  1. Перейдите в настройки вашего Discord-сервера
  2. Откройте Integrations → удалите бота
Last updated on
TelegramSlack