harnsy

Боты 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 <код> (или нажмите «Открыть в Telegram», затем «Start»: код уйдёт сам); в Discord /link <код> личным сообщением боту.
  3. Код человека отправляйте только в личный чат. Отправленный в группу, код сгорает, и нужен новый.
  4. На карточке нажмите «Сделать владельцем» и включите «Приём сообщений».

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

Дальше всё, что вы пишете в личном чате, уходит лиду проекта. Начните сообщение с номера задачи, #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. Логотипов нет.