Подключение Telegram

После подключения агент слушает входящие сообщения вашего Telegram-бота. Каждый чат — отдельная беседа: агент помнит контекст разговора с каждым собеседником. Достаточно один раз настроить — бот работает непрерывно.

Откройте агента в разделе «Мои агенты», в блоке «Где работает» нажмите «Подключить» у строки Telegram. Там тот же порядок шагов, но с подсказками и кнопками: платформа сама отметит, когда бот ответит. Можно и попросить Дирижёра: напишите ему «подключи Telegram-бота», он откроет этот мастер и подождёт, пока вы вставите токен. Сам токен Дирижёр не видит: его вводите только вы.

1. Откройте @BotFather. Откройте @BotFather в Telegram и отправьте ему команду /newbot.
   Открыть @BotFather
2. Придумайте имя и адрес. Введите имя бота (любое) и адрес на латинице, который заканчивается на bot.
3. Вставьте ответ BotFather. Скопируйте ответ BotFather целиком, вставьте его в поле на странице агента и нажмите «Подключить».

   Схема

   Done! Congratulations on your new bot…

   Use this token to access the HTTP API:

   123456789:AAH… (токен)

   Keep your token secure…

   Ответ BotFather пришлёт сам. Слова в нём могут немного отличаться. Копируйте всё сообщение целиком или только строку, обведённую золотом.

4. Напишите боту /start. Откройте своего бота и отправьте ему /start. Платформа сама отметит, что бот ответил.

Токен — это секрет. Не передавайте его посторонним. Если токен скомпрометирован, сбросьте его у BotFather командой /revoke и подключите бота заново с новым токеном.

Если такой адрес уже занят, BotFather об этом скажет: добавьте в середину цифры или слово и введите снова. Если токен не подошёл, платформа напишет по-русски, что поправить.

• Включить / Выключить — временно остановить бота без потери настроек. При выключении бот перестаёт отвечать, при включении — продолжает с того же места.
• Отключить — полностью удалить бота из агента. Токен можно будет подключить снова или использовать в другом агенте.

• /start — первое приветствие. Создаёт новую беседу для пользователя.
• /new — сбросить историю и начать разговор заново. Удобно, когда тема изменилась и нужен свежий контекст.
• Остальные команды со слэшем по умолчанию получают короткую подсказку. В настройках входной ноды можно включить «Команды со слэшем: передавать агенту» — тогда «/план» или «/вес» обработает сам агент.

Эти настройки живут в редакторе агента: нажмите на ноду «Вход» — справа появятся параметры канала.

• Кто может писать боту — список Telegram ID по одному в строке. Пусто — отвечает всем. Чтобы бот был только вашим, укажите свой ID (его подскажет бот @userinfobot). Чужим бот вежливо откажет без обращения к модели.
• Кнопки внизу чата — постоянная панель под полем ввода: кнопки через запятую, каждая строка — отдельный ряд (до четырёх рядов по четыре кнопки). Нажатие отправляет текст кнопки агенту как обычное сообщение. Панель приходит сама: с ответом на /start, /new, «/owner КОД» и с любым ответом без кнопок под сообщением. Чтобы отправить её без сообщения боту, нажмите «Отправить панель в чат» во вкладке Telegram (она уйдёт в привязанный чат владельца и тем, кто вписан в «Кто может писать боту»). Кнопки под ответом, повторяющие панель, бот не дублирует.
• Дневники в мини-приложении — кнопка меню бота открывает приложение, где записи из раздела «Данные» показаны без обращения к модели: сводка дня против целей, дневник питания по приёмам, таблицы и графики, текст из памяти ноды. Собирается в блоке «Мини-приложение» вкладки Telegram: конструктором блоков, кнопкой «Собрать из данных» или схемой в JSON. Данные видят только те, кто вписан в «Кто может писать боту».
• Фото в чате мини-приложения — кнопка-скрепка слева от поля ввода: снимок с камеры или из галереи (JPEG, PNG, WEBP, HEIC) уходит агенту так же, как фото боту в Telegram, с подписью или без. Фото сжимается на телефоне до отправки, геометка и прочие данные снимка при этом не передаются. В истории чата вместо снимка остаётся пометка «Фото». Ориентир — около 30 фото в час на человека; агент на модели без зрения ответит, что смотреть фото не умеет, — без списания кредитов.
• Кнопки под ответом — их прикладывает сам агент. В промпте LLM-ноды попросите модель заканчивать ответ строкой [[BUTTONS:["Верно","Поправить"]]]: человек увидит кнопки, а нажатие придёт агенту текстом кнопки. Маркер из текста ответа вырезается. В виджете на сайте те же кнопки рисуются под ответом, во ВКонтакте, Avito и WhatsApp варианты приходят списком под текстом.
• Промолчать — если агент выводит [[SILENT]], сообщение не отправляется. Полезно в рутинах: «напоминать не о чем».
• Таймер — агент заводит его маркером [[TIMER:150|Отдых окончен]]: в чат приходит сообщение «Таймер: 2:30» с кнопками «+30 с» и «Стоп», а по истечении — подпись отдельным сообщением. Так у «Личного тренера» устроен отдых между подходами.
• Ответ на голосовые — голосом (как пришло) или текстом.
• Часовой пояс — агент знает текущие дату и время; в промптах доступны {{now}}, {{today}}, {{time}}, {{weekday}}.
• Оформление ответов — как бот показывает ответ. «Обычные сообщения» (по умолчанию) — жирный текст, курсив, списки, код и цитаты. «Все блоки Telegram» — к этому добавляются настоящие таблицы, чек-листы, заголовки, раскрывающиеся блоки, сноски и формулы. Короткий ответ без таких блоков и во втором режиме уходит обычным сообщением: его можно процитировать по кусочку и он одинаково выглядит в старых версиях Telegram. Если Telegram какой-то блок не примет, бот молча отправит то же самое обычным сообщением — ответ не теряется.
• Длинные ответы бот делит на несколько сообщений сам, а разметку из ответа модели показывает оформлением — сырые звёздочки и решётки человеку не видны.