Telegram

С Eggent можно работать из Telegram так же, как из браузера: писать задачи текстом и голосом, присылать файлы, получать ответы и результаты расписаний. Чаты из Telegram видны и в веб-версии.

#Два способа подключения

#Общий бот облака

Если ты зарегистрировался через @eggentai_bot, он уже связан с твоим пространством. Просто пиши ему. /login там отвечает кнопкой, которая открывает пространство в браузере уже с выполненным входом.

Если ты регистрировался на сайте, попроси агента подключить Telegram (карточка «Утренняя сводка в Telegram» делает это первым шагом). Он даст ссылку на бота: открой её в Telegram и нажми Start — чат привяжется к твоему пространству. Ссылка работает один раз и 30 минут. Если этот Telegram уже привязан к другому пространству, бот попросит открыть ссылку ещё раз, чтобы перенести его. Пока агент работает, в чате виден черновик: сначала — чем агент занят («Думаю…», «Ищу в интернете», «Читаю файл»), потом — текст ответа по мере написания. Готовый ответ приходит обычным сообщением.

#Свой бот

Самый простой путь — карточка «Свой Telegram-бот» на экране нового чата: агент проведёт по шагам. Вручную:

1. В Telegram открой @BotFather, отправь /newbot, придумай имя и адрес бота и скопируй токен.
2. В Eggent открой Настройки → Мессенджеры.
3. В блоке 1. Токен бота вставь токен и нажми Активировать бота.
4. Режим подключения Eggent выберет сам. В облаке всё работает сразу; на своём сервере без публичного HTTPS-адреса используется Long Polling.
5. Открой своего бота в Telegram и нажми Start.

#Кто может писать своему боту

Бот отвечает только людям из списка разрешённых. Чтобы пустить человека (в том числе себя в первый раз):

1. В Настройки → Мессенджеры → Контроль доступа нажми Сгенерировать код доступа. Или попроси агента: «дай код доступа для коллеги».
2. Человек открывает бота и отправляет /code <код>.
3. Код одноразовый. После него человек попадает в список разрешённых.

Список user_id можно поправить руками в том же блоке.

#Что можно отправлять

• Текст — как в веб-чате.
• Голосовые — расшифровываются внутри воркспейса и уходят агенту текстом. См. «Голос».
• Файлы и фото — сохраняются во вложения чата, агент их видит. Подпись к файлу уходит как сообщение.
• Файлы — ответ, сделавший файлы, говорит об этом в конце. Отправь /files, чтобы получить их в этот чат: до трёх приходят по одному, больше — одним архивом.
• @проект задача — сообщение, которое начинается с @ и названия проекта, поручает задачу этому проекту; ответ вернётся сюда, а ты останешься в том же чате. См. Проекты.
• «Стоп», «хватит», «отмена» — отдельным сообщением останавливают текущую работу. Любое другое сообщение во время работы агент учтёт в текущей задаче. Они доходят до работы сразу, даже если она идёт давно: ждать её конца не нужно.

Команды бота:

Бот работает только в личных сообщениях. В группах он не отвечает.

#В какой чат уходит сообщение

Telegram — одна переписка, а чатов в воркспейсе много. Куда попадает твоё сообщение:

• Ответ (Reply на сообщение бота) продолжает чат, из которого пришло это сообщение: утренний отчёт или ответ недельной давности. Telegram показывает цитату, агент её тоже получает.
• Любое другое сообщение продолжает чат, который написал тебе последним. Пришёл отчёт по расписанию — следующее сообщение уйдёт в чат отчёта.
• Когда разговор переезжает, сообщение говорит куда: последняя строка — 💬 и название чата.
• /chats показывает последние чаты. Нажми на команду /c_… под нужным, чтобы продолжить его. /new начинает новый чат. Работа, которую проект сделал для другого чата, помечена ↪️.
• Или попроси агента: «вернись в чат про прайс», «что было во вчерашнем отчёте?». Он умеет искать, читать чаты и переключаться между ними.

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

#Агент пишет сам

Попроси — и агент отправит в Telegram сообщение или файл: результат долгой задачи, напоминание, отчёт по расписанию. Картинки уходят как фото с подписью, остальное — документами.

Отчёт по расписанию приходит из собственного чата задачи и говорит об этом последней строкой — ответ на него продолжит отчёт. См. «Расписания».

#Публикация в канал

Свой бот может публиковать посты в канал:

1. Добавь бота в канал администратором с правом публиковать сообщения.
2. Попроси агента: «опубликуй этот пост с картинкой в @mychannel».

Это же работает в расписании: «каждый день в 10:00 публикуй в @mychannel пост по контент-плану». Для регулярных постов удобна карточка «Контент-завод».

#Ответ, который завис

Пока агент работает, черновик показывает, что он делает. Если полторы минуты ничего не происходит, черновик говорит, что работа идёт, и как её остановить: отправь /reset. Это останавливает работу, снимает вопрос, на который она ждала ответа, и сохраняет разговор и всё, что уже сделано; напиши снова, чтобы продолжить.

Замечать самому не обязательно: Eggent сам останавливает ход, который совсем замолчал, — примерно через 3 минуты, пока он готовится, 6 минут ожидания модели или 20 минут внутри одной команды, которая ничего не печатает. Он скажет, что случилось, а твои сообщения сохранятся. Команда, которая ждёт ответа там, где отвечать некому — например, в Telegram, — получает пустой ответ и не ждёт вечно.

#Если бот молчит

• Проверь Настройки → Мессенджеры: бот активен, статус «Running» или webhook настроен.
• Убедись, что пишешь в личные сообщения и твой user_id в списке разрешённых (или отправь /code).
• Если токен менялся в @BotFather, вставь новый и снова нажми Активировать бота.
• Долгие задачи бот не бросает: черновик показывает, что агент ещё работает.