Боты Telegram и Discord
Бот переносит проект в чат, которым вы и так пользуетесь. Вы пишете лиду с телефона, отвечаете на его вопросы кнопкой и получаете туда результат расписания. Бот работает на вашем компьютере: harnsy сам читает его сообщения, без публичного адреса и открытого порта.
Что нужно. harnsy Max; аккаунт Telegram или Discord; включённый компьютер и запущенный harnsy. Пока harnsy не запущен, бот не отвечает, а сообщение, написанное в это время, потом не доставляется.
Один бот — один проект. Бот обслуживает один проект; у проекта может быть несколько ботов. Через бота проекта вы говорите с лидом этого проекта. Чтобы следить за несколькими проектами в одном месте, соберите их ботов в одну группу Telegram.
Добавить бота Telegram
- В Telegram откройте @BotFather и создайте бота (команда
/newbot). Скопируйте токен, который он даст. Обращайтесь с токеном как с паролем. - В дашборде на этой машине: Настройки › Боты › «Добавить бота» › Telegram. harnsy устроен так, что бота можно добавить только на этой машине, не с телефона, вошедшего снаружи.
- В «Бот для» выберите «Проекта» и сам проект. (Или «Ассистента»: тогда harnsy устроен так, что принимает сообщения только от вас, всё уходит Ассистенту, а групп и других людей он не обслуживает.)
- Вставьте токен в «Токен бота» и нажмите «Создать бота». harnsy проверит токен в Telegram, сохранит его запечатанным и больше не покажет. Токен по замыслу не передаётся вашим агентам.
- Затем harnsy предложит две настройки в @BotFather: запретить добавлять бота в другие группы, когда он уже в вашей (
/setjoingroups→ Disable), и оставить включённым режим приватности.
Добавить бота Discord
- В Discord Developer Portal: «New Application», затем «Bot» › «Reset Token», скопируйте токен. Discord покажет его один раз.
- На той же странице «Bot», в «Privileged Gateway Intents», включите «Message Content Intent». Без него Discord не пустит бота, и он покажет «настройка не закончена».
- По желанию: выключите «Public Bot», чтобы никто другой не добавил его на свой сервер (Discord попросит сначала поставить «Installation» › «Install Link» в «None»).
- В harnsy: Настройки › Боты › «Добавить бота» › Discord, вставьте токен в «Токен бота», выберите проект. «Как настроить бота Discord» на той же форме повторяет эти шаги.
- На карточке бота нажмите «Привязать канал»: там будет ссылка-приглашение. Откройте её, чтобы добавить бота на свой сервер с нужными ему правами.
В Discord команды бота пишутся обычным текстом: собственное меню / Discord их не показывает. Сообщение бота в Discord — не больше 2000 символов (в Telegram 4096); длинный текст придёт несколькими сообщениями.
Сделать личный чат своим
- На карточке бота нажмите «Привязать человека». harnsy покажет одноразовый код, он действует 10 минут.
- Отправьте его боту в личном чате: в Telegram
/start <код>(или нажмите «Открыть в Telegram», затем «Start»: код уйдёт сам); в Discord/link <код>личным сообщением боту. - Код человека отправляйте только в личный чат. Отправленный в группу, код сгорает, и нужен новый.
- На карточке нажмите «Сделать владельцем» и включите «Приём сообщений».
Карточка показывает шаги настройки («Бот работает», «Вы привязаны», «Вы владелец», «Приём сообщений») и отмечает каждый, когда он сделан. Пока вы не владелец и приём не включён, бот в личном чате ничего не отвечает.
Дальше всё, что вы пишете в личном чате, уходит лиду проекта. Начните сообщение с номера задачи, #123 …, и оно дойдёт до лида про эту задачу. Когда лид задаёт вам вопрос с вариантами, он может прийти в этот чат кнопками (см. Ответы и подтверждения).
Группы, темы форума и каналы Discord
- Привязать группу: добавьте бота в группу, нажмите «Привязать группу» на карточке и напишите в группе
/link <код>. В канале Discord: «Привязать канал», затем/link <код>там (или@бот link <код>, если команду перехватывает меню/Discord). Тема форума Telegram или ветка Discord привязывается отдельно, своим/linkвнутри неё. - Кого он слышит: в группе harnsy устроен так, чтобы передавать только упоминание имени бота или ответ на его сообщение, а остальное отбрасывать. Отвечает он только людям, которых вы привязали. Переданное уходит лиду проекта.
- Режим приватности Telegram: когда он включён, простое упоминание может не дойти до бота. Тогда ответьте на сообщение бота.
- Всё, что harnsy пишет в группу, читают все её участники. Привязывайте группу, только если всем в ней можно видеть работу проекта. То, что участники группы пишут боту, доходит до ваших агентов и до AI-сервиса, на котором они работают: скажите им об этом.
Что могут отправлять агенты
- harnsy даёт агентам писать только в чаты, которые вы разрешили их проекту: в строке чата, «Проекты, которые могут писать в …».
- В группе, теме или канале Discord их сообщения начинаются с 🤖, без имени агента и проекта. В вашем личном чате видно, кто написал и по какому проекту.
- Файлы от агентов, для каждого чата: «Любые файлы», «Только текст и картинки» или «Без файлов», и «Самый большой файл». Telegram принимает файлы до 50 МБ, Discord до 10 МБ.
- harnsy вырезает узнаваемые секреты из текста агента и текстовых файлов перед отправкой. Архивы, PDF и картинки уходят как есть; карточка показывает последние 20 в «Файлы, отправленные агентами». Это страховка, а не гарантия.
- Расписание может отправлять свой результат в чат: см. Расписания. В ваш личный чат — не чаще одного результата расписания за 30 минут.
Что отправляет человек
- Текст доходит до лида. От фото, видео, файла или стикера передаётся только подпись.
- Голосовое сообщение расшифровывает ваше подключение распознавания речи, если оно есть, и лид получает текст: по умолчанию до 5 минут и 10 МБ. Ваш звук уходит этому провайдеру.
- Человек может отправить до 20 сообщений в минуту.
Приватность
Сообщения идут через серверы Telegram или Discord. Чаты с ботами не защищены сквозным шифрованием, и к ним применяются условия самого сервиса. Не отправляйте туда пароли и ключи; если в работе есть данные клиентов, отправляйте их туда, только если вам это можно. Любой, кто может пользоваться вашим аккаунтом Telegram или Discord, может писать вашим агентам от вашего имени: защитите аккаунт.
harnsy не добавляет своей песочницы: агенты действуют с правами вашего пользователя на этом компьютере. Токен хранится запечатанным, но от программы, запущенной от вашего имени, это не стена.
Убрать или заменить
- Чат: «В архив» в его строке. harnsy перестанет туда писать; чтобы вернуть, привяжите его снова новым кодом.
- Человека: «Отвязать». Новая привязка — новым кодом.
- Бота: «Удалить бота». harnsy устроен так, что стирает свою копию токена; в резервной копии, сделанной раньше, токен остаётся. Если токен мог утечь, отзовите его:
/revokeв @BotFather, «Reset Token» в Developer Portal. Сам бот остаётся в Telegram (удалите его через/deletebot) или в Developer Portal. - Отозванный токен: «Заменить токен». Привязанные чаты и люди остаются.
Если что-то не так
| Что вы видите | Обычно |
|---|---|
| «нужен проект» | у бота нет проекта: сообщения не доставляются. Выберите его на карточке |
| «никто не привязан» | привяжите себя: «Привязать человека», затем /start <код> |
| «настройка не закончена» (Discord) | в Developer Portal выключен «Message Content Intent» |
| «не работает: токен не принят» | токен отозван или вставлен с ошибкой: «Заменить токен». Сообщения пока ждут в очереди |
| бот молчит в группе | упомяните его или ответьте на его сообщение; при режиме приватности Telegram простое упоминание может не дойти |
| «Этот код больше не работает» | он был отправлен в группу или прошло 10 минут: возьмите новый |
Telegram, BotFather и Discord — названия продуктов их владельцев; harnsy с ними не связан и ими не одобрен.
Есть вопросы? Спросите в группе →
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. Логотипов нет.