Source: https://harnsy.dev/ru/docs/bots

> Говорите с ИИ-лидом из Telegram или Discord: отвечайте на его вопросы кнопкой, получайте результат расписания в чат. Настройка за несколько минут в harnsy Max.

# Боты Telegram и Discord

Бот переносит проект в чат, которым вы и так пользуетесь. Вы пишете лиду с телефона, отвечаете на его вопросы кнопкой и получаете туда результат расписания. Бот работает на вашем компьютере: harnsy сам читает его сообщения, без публичного адреса и открытого порта.

**Что нужно.** harnsy Max; аккаунт Telegram или Discord; включённый компьютер и запущенный harnsy. Пока harnsy не запущен, бот не отвечает, а сообщение, написанное в это время, потом не доставляется.

**Один бот — один проект.** Бот обслуживает один проект; у проекта может быть несколько ботов. Через бота проекта вы говорите с лидом этого проекта. Чтобы следить за несколькими проектами в одном месте, соберите их ботов в одну группу Telegram.

## Добавить бота Telegram

1. В Telegram откройте @BotFather и создайте бота (команда `/newbot`). Скопируйте токен, который он даст. Обращайтесь с токеном как с паролем.
2. В дашборде на этой машине: Настройки › Боты › «Добавить бота» › Telegram. harnsy устроен так, что бота можно добавить только на этой машине, не с телефона, вошедшего снаружи.
3. В «Бот для» выберите «Проекта» и сам проект. (Или «Ассистента»: тогда harnsy устроен так, что принимает сообщения только от вас, всё уходит Ассистенту, а групп и других людей он не обслуживает.)
4. Вставьте токен в «Токен бота» и нажмите «Создать бота». harnsy проверит токен в Telegram, сохранит его запечатанным и больше не покажет. Токен по замыслу не передаётся вашим агентам.
5. Затем harnsy предложит две настройки в @BotFather: запретить добавлять бота в другие группы, когда он уже в вашей (`/setjoingroups` → Disable), и оставить включённым режим приватности.

## Добавить бота Discord

1. В Discord Developer Portal: «New Application», затем «Bot» › «Reset Token», скопируйте токен. Discord покажет его один раз.
2. На той же странице «Bot», в «Privileged Gateway Intents», включите «Message Content Intent». Без него Discord не пустит бота, и он покажет «настройка не закончена».
3. По желанию: выключите «Public Bot», чтобы никто другой не добавил его на свой сервер (Discord попросит сначала поставить «Installation» › «Install Link» в «None»).
4. В harnsy: Настройки › Боты › «Добавить бота» › Discord, вставьте токен в «Токен бота», выберите проект. «Как настроить бота Discord» на той же форме повторяет эти шаги.
5. На карточке бота нажмите «Привязать канал»: там будет ссылка-приглашение. Откройте её, чтобы добавить бота на свой сервер с нужными ему правами.

В Discord команды бота пишутся обычным текстом: собственное меню `/` Discord их не показывает. Сообщение бота в Discord — не больше 2000 символов (в Telegram 4096); длинный текст придёт несколькими сообщениями.

## Сделать личный чат своим

1. На карточке бота нажмите «Привязать человека». harnsy покажет одноразовый код, он действует 10 минут.
2. Отправьте его боту в личном чате: в Telegram `/start &lt;код&gt;` (или нажмите «Открыть в Telegram», затем «Start»: код уйдёт сам); в Discord `/link &lt;код&gt;` личным сообщением боту.
3. Код человека отправляйте только в личный чат. Отправленный в группу, код сгорает, и нужен новый.
4. На карточке нажмите «Сделать владельцем» и включите «Приём сообщений».

Карточка показывает шаги настройки («Бот работает», «Вы привязаны», «Вы владелец», «Приём сообщений») и отмечает каждый, когда он сделан. Пока вы не владелец и приём не включён, бот в личном чате ничего не отвечает.

Дальше всё, что вы пишете в личном чате, уходит лиду проекта. Начните сообщение с номера задачи, `#123 …`, и оно дойдёт до лида про эту задачу. Когда лид задаёт вам вопрос с вариантами, он может прийти в этот чат кнопками (см. [Ответы и подтверждения](https://harnsy.dev/docs/answers-and-approvals)).

## Группы, темы форума и каналы Discord

- **Привязать группу:** добавьте бота в группу, нажмите «Привязать группу» на карточке и напишите в группе `/link &lt;код&gt;`. В канале Discord: «Привязать канал», затем `/link &lt;код&gt;` там (или `@бот link &lt;код&gt;`, если команду перехватывает меню `/` Discord). Тема форума Telegram или ветка Discord привязывается отдельно, своим `/link` внутри неё.
- **Кого он слышит:** в группе harnsy устроен так, чтобы передавать только упоминание имени бота или ответ на его сообщение, а остальное отбрасывать. Отвечает он только людям, которых вы привязали. Переданное уходит лиду проекта.
- **Режим приватности Telegram:** когда он включён, простое упоминание может не дойти до бота. Тогда ответьте на сообщение бота.
- **Всё, что harnsy пишет в группу, читают все её участники.** Привязывайте группу, только если всем в ней можно видеть работу проекта. То, что участники группы пишут боту, доходит до ваших агентов и до AI-сервиса, на котором они работают: скажите им об этом.

## Что могут отправлять агенты

- harnsy даёт агентам писать только в чаты, которые вы разрешили их проекту: в строке чата, «Проекты, которые могут писать в …».
- В группе, теме или канале Discord их сообщения начинаются с 🤖, без имени агента и проекта. В вашем личном чате видно, кто написал и по какому проекту.
- **Файлы от агентов**, для каждого чата: «Любые файлы», «Только текст и картинки» или «Без файлов», и «Самый большой файл». Telegram принимает файлы до 50 МБ, Discord до 10 МБ.
- harnsy вырезает узнаваемые секреты из текста агента и текстовых файлов перед отправкой. Архивы, PDF и картинки уходят как есть; карточка показывает последние 20 в «Файлы, отправленные агентами». Это страховка, а не гарантия.
- Расписание может отправлять свой результат в чат: см. [Расписания](https://harnsy.dev/docs/schedules). В ваш личный чат — не чаще одного результата расписания за 30 минут.

## Что отправляет человек

- Текст доходит до лида. От фото, видео, файла или стикера передаётся только подпись.
- Голосовое сообщение расшифровывает ваше подключение распознавания речи, если оно есть, и лид получает текст: по умолчанию до 5 минут и 10 МБ. Ваш звук уходит этому провайдеру.
- Человек может отправить до 20 сообщений в минуту.

## Приватность

Сообщения идут через серверы Telegram или Discord. Чаты с ботами не защищены сквозным шифрованием, и к ним применяются условия самого сервиса. Не отправляйте туда пароли и ключи; если в работе есть данные клиентов, отправляйте их туда, только если вам это можно. Любой, кто может пользоваться вашим аккаунтом Telegram или Discord, может писать вашим агентам от вашего имени: защитите аккаунт.

harnsy не добавляет своей песочницы: агенты действуют с правами вашего пользователя на этом компьютере. Токен хранится запечатанным, но от программы, запущенной от вашего имени, это не стена.

## Убрать или заменить

- Чат: «В архив» в его строке. harnsy перестанет туда писать; чтобы вернуть, привяжите его снова новым кодом.
- Человека: «Отвязать». Новая привязка — новым кодом.
- Бота: «Удалить бота». harnsy устроен так, что стирает свою копию токена; в резервной копии, сделанной раньше, токен остаётся. Если токен мог утечь, отзовите его: `/revoke` в @BotFather, «Reset Token» в Developer Portal. Сам бот остаётся в Telegram (удалите его через `/deletebot`) или в Developer Portal.
- Отозванный токен: «Заменить токен». Привязанные чаты и люди остаются.

## Если что-то не так

| Что вы видите | Обычно |
| --- | --- |
| «нужен проект» | у бота нет проекта: сообщения не доставляются. Выберите его на карточке |
| «никто не привязан» | привяжите себя: «Привязать человека», затем `/start &lt;код&gt;` |
| «настройка не закончена» (Discord) | в Developer Portal выключен «Message Content Intent» |
| «не работает: токен не принят» | токен отозван или вставлен с ошибкой: «Заменить токен». Сообщения пока ждут в очереди |
| бот молчит в группе | упомяните его или ответьте на его сообщение; при режиме приватности Telegram простое упоминание может не дойти |
| «Этот код больше не работает» | он был отправлен в группу или прошло 10 минут: возьмите новый |

*Telegram, BotFather и Discord — названия продуктов их владельцев; harnsy с ними не связан и ими не одобрен.*

[Что это умеет →](https://harnsy.dev/ru/features/messengers)

[Есть вопросы? Спросите в группе →](https://t.me/+Cs5Mimdes5UwOGVi)

Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, pi, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender и QR Code — названия продуктов их владельцев. harnsy не связан с ними и не одобрен ими. iOS — товарный знак Cisco, используемый Apple по лицензии; QR Code — зарегистрированный товарный знак DENSO WAVE INCORPORATED. Логотипов нет.
