# Telegram

> Как работать с Eggent из Telegram — через общий бот облака или своего бота, как пустить коллег, что можно отправлять, как агент пишет в чат и публикует в каналы.

Source: https://eggent.ai/r/docs/telegram/

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

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

| | Общий бот облака | Свой бот |
| --- | --- | --- |
| Что это | [@eggentai_bot](https://t.me/eggentai_bot) | Бот, которого ты создал в @BotFather |
| Где есть | Только Eggent Cloud | Облако и свой сервер |
| Настройка | Регистрация через бота или ссылка, которую даст агент | Токен в **Настройки → Мессенджеры** |
| Кто может писать | Ты | Ты и те, кого ты впустил |
| Публикация в каналы | Нет | Да, если бот — администратор канала |

## Общий бот облака {#shared-bot}

Если ты зарегистрировался через [@eggentai_bot](https://t.me/eggentai_bot), он уже связан с твоим пространством. Просто пиши ему. **`/login`** там отвечает кнопкой, которая открывает пространство в браузере уже с выполненным входом.

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

## Свой бот {#own-bot}

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

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

> [!WARNING]
> Вставляй токен в настройках, а не в чат с агентом. Токен даёт полный доступ к боту, а сообщение остаётся в истории.

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

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

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

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

> [!WARNING]
> Каждый, кого ты впустил, работает с **тем же воркспейсом**: видит его файлы и может давать агенту любые задачи. Пускай только тех, кому доверяешь. Бот не предназначен для общения с клиентами.

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

- **Текст** — как в веб-чате.
- **Голосовые** — расшифровываются внутри воркспейса и уходят агенту текстом. См. [«Голос»](https://eggent.ai/r/docs/voice.md).
- **Файлы и фото** — сохраняются во вложения чата, агент их видит. Подпись к файлу уходит как сообщение.
- **Файлы** — ответ, сделавший файлы, говорит об этом в конце. Отправь `/files`, чтобы получить их в этот чат: до трёх приходят по одному, больше — одним архивом.
- **`@проект задача`** — сообщение, которое начинается с `@` и названия проекта, поручает задачу этому проекту; ответ вернётся сюда, а ты останешься в том же чате. См. [Проекты](https://eggent.ai/r/docs/projects.md#ask).
- **«Стоп»**, «хватит», «отмена» — отдельным сообщением останавливают текущую работу. Любое другое сообщение во время работы агент учтёт в текущей задаче. Они доходят до работы сразу, даже если она идёт давно: ждать её конца не нужно.

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

| Команда | Что делает |
| --- | --- |
| `/start`, `/help` | Справка и статус подключения |
| `/code <код>` | Получить доступ по коду |
| `/new` | Начать новый разговор с чистого листа |
| `/chats` | Последние чаты, у каждого — команда, которая его продолжит |
| `/reset` | Останавливает ответ, который, кажется, завис. Разговор сохраняется: напиши снова, чтобы продолжить |
| `/files` | Присылает файлы, которые сделал последний ответ |

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

## В какой чат уходит сообщение {#which-chat}

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

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

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

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

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

Отчёт по расписанию приходит из собственного чата задачи и говорит об этом последней строкой — ответ на него продолжит отчёт. См. [«Расписания»](https://eggent.ai/r/docs/schedules.md#results).

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

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

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

Это же работает в расписании: «каждый день в 10:00 публикуй в @mychannel пост по контент-плану». Для регулярных постов удобна карточка [«Контент-завод»](https://eggent.ai/r/docs/skill-catalog.md#social-daily).

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

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

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

## Если бот молчит {#troubleshooting}

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