# Telegram, MAX и другие мессенджеры

Агенту можно писать не только в приложении, но и в мессенджере: бот принимает поручения, присылает ответы и отчёты задач и задаёт вопросы карточками с кнопками. Переписка с ботом не отдельная: это ваш личный чат с агентом, и в приложении он виден с той же историей.

## Какие мессенджеры есть

| Мессенджер | Личный чат | Группы | Каналы |
|---|---|---|---|
| Telegram | готовый бот «Сам Решу» или бот организации | да | только бот организации |
| MAX | готовый бот «Сам Решу» или бот организации | да | нет |
| Пачка | только бот организации | нет | нет |
| Microsoft Teams, Slack | только бот организации | да | нет |

**Готовый бот «Сам Решу»** работает сразу, ничего настраивать не нужно. **Бот организации** выходит с именем и аватаром вашей компании, его подключает администратор (ниже, [Свой бот организации](#свой-бот-организации)).

## Как подключить личный чат с ботом

### Откройте настройки мессенджеров
**Настройки → «Уведомления и мессенджеры»**, карточка **«Мессенджеры»** → **«Подключить мессенджер»**.

### Выберите бота
**«Готовый бот «Сам Решу»»** для Telegram или MAX, либо строку из **«Боты вашей организации»**, если администратор их подключил.

### Подтвердите в мессенджере
На телефоне откроется чат с ботом. На компьютере появится QR-код: наведите на него камеру телефона. В ответе бота нажмите **«Подключить»**. Если кнопки нет, раскройте **«Нет кнопки «Подключить»?»** и отправьте боту код с экрана.

Можно начать и с бота: напишите ему что угодно. Он ответит приветствием с кнопкой **«Подключить»**, сайт попросит войти или зарегистрироваться и вернёт вас в чат. Сообщения, отправленные до подключения (до 5), бот передаст агенту, если подключить чат в течение 60 мин после первого из них.

**Один чат на мессенджер**
К аккаунту подключается один личный чат в каждом мессенджере. Если бот отвечает «К вашему аккаунту уже подключён другой чат», отключите прежний в **Настройках → «Уведомления и мессенджеры»** и подключите новый. Чат, который уже подключён к другому аккаунту, сначала отключают там.

Отключить чат можно там же, в карточке **«Мессенджеры»**. Бот перестанет вам писать, остальные чаты останутся. Если мессенджер был единственным адресом для отчётов каких-то задач, приложение предупредит и предложит выбрать им другой.

## Бот просит разрешения: что это и где ответить

Когда агент собирается что-то **изменить** или **отправить** (поправить цену, ответить клиенту, создать сделку), бот присылает карточку с тем, что именно будет сделано и в каком сервисе. Это тот же вопрос, что в приложении:

- **«Одобрить»**: выполнить этот раз;
- **«Отклонить»**: не выполнять;
- **«Всегда разрешать»**: выполнить и запомнить ровно эту операцию, чтобы дальше она проходила без вопроса.

Пока вы не ответили, агент это действие не выполняет. Отвечать можно в боте или в приложении, где удобнее. Какие действия спрашиваются, а какие идут сами, настраивается в **Настройках → «Возможности» → «Автопроверка»**: [Как агент меняет данные](/help/trust).

Другие сообщения, похожие на запрос разрешения:

- **«Это действие одобряет владелец или администратор организации, карточка уже у них».** В организации действует правило, по которому такие действия одобряет администратор. Ждите его ответа или напишите ему.
- **Ключ, пароль, оплата или шаг на сайте (вход, капча).** Это делается только в приложении: ключи в переписку не присылают, покупку в чате подтвердить нельзя. Бот пишет, что нужно, и даёт кнопку в приложение.
- **Кнопка «Подключить» в незнакомом чате.** Это подключение чата к аккаунту. Если ссылку прислал кто-то другой, нажмите «Отмена».

## Чем бот отличается от приложения

Агент в боте тот же: те же подключённые сервисы, навыки, память и задачи. Отличается то, что умеет сам мессенджер.

| | Приложение | Бот в мессенджере |
|---|---|---|
| Ход работы | видно шаги, файлы, экран агента | бот «печатает»; на долгой работе появляется сообщение «Работаю» с кнопкой «Остановить» |
| Ключи, пароли, покупки | вводятся и подтверждаются здесь | только кнопка в приложение |
| Файлы | пределы на странице [Ограничения](/help/limits) | в Telegram до 20 МБ |
| Недельный лимит закончился | новые сообщения не отправляются | агент отвечает на модели **GPT-6 Luna** |
| Групповой чат с несколькими агентами | собирается через «Кому:» | группа мессенджера, отвечает бот |

Про лимит подробнее: [Тарифы и лимиты](/help/plans#когда-лимит-закончился).

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

| Команда | Что делает |
|---|---|
| `/stop` | остановить текущий ответ |
| `/clear` | очистить чат и начать заново; то, что агент запомнил, сохранится |
| `/compact` | сжать контекст чата в сводку |
| `/status` | тариф и недельный лимит |
| `/connect` | подключить группу, канал или войти в веб-версию |
| `/help` | справка |

Набор команд зависит от мессенджера: в Пачке, например, `/connect` только открывает вход в веб-версию.

## Как быстро отвечает бот

Так же, как агент в приложении: модель и работа одни и те же, а ответ приходит в чат целиком, когда агент закончил. Пока он работает:

- бот показывает, что печатает, а на вашем сообщении стоит отметка, что оно принято;
- если работа долгая, появляется сообщение «Работаю» с текущим шагом и кнопкой **«Остановить»**;
- новое сообщение во время работы не теряется: бот ответит «Сообщение в очереди», и агент возьмётся за него следом.

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

## Файлы в боте

- **Что можно прислать.** Документы (PDF, Word, Excel, текст), фото и голосовые сообщения. Голосовое агент получает текстом, как набранную реплику.
- **Размер.** В Telegram боту доходят файлы до 20 МБ, это предел самого Telegram. Если файл больше, бот так и ответит: пришлите его в приложении.
- **Что не читается.** На вложение, которое бот не разбирает, он попросит описать задачу словами или прислать файлом.
- **Файлы от агента** приходят вложениями. Если приложить не вышло, бот пришлёт ссылку, а файлы останутся в приложении.

Все пределы по файлам: [Ограничения](/help/limits).

## Бот в группе

Бота можно добавить в группу мессенджера, где переписывается команда, и в Telegram-канал для отчётов задач. В группе он отвечает только на упоминание через `@` или ответ на его сообщение.

По умолчанию в группе **нет подключённых сервисов, навыков, задач и личной памяти**: туда может написать любой участник. Владелец агента может открыть группу своим сервисам переключателем **«Работать с сервисами владельца»** в **«Настройки» → «Уведомления и мессенджеры» → «Группы и каналы»**. Как подключить группу, что после этого доступно и на чьи сообщения: [Групповой чат](/help/group-chats#что-агенту-доступно-в-групповом-чате).

## Может ли агент сам написать контрагенту в мессенджер

В чужой личный чат Telegram или MAX нет. Бот пишет только туда, где его подключили: в ваш личный чат с ботом и в группы и каналы вашей организации. Связаться с поставщиком, клиентом или подрядчиком агент может так:

- **Письмом со своей почты.** У агента есть свой адрес ([Агенты](/help/agents)). Первое письмо на новый адрес он присылает вам карточкой на одобрение, ответ возвращается в чат.
- **Ссылкой для ответа.** Агент готовит текст и ссылку, отправляете их вы сами в любом мессенджере или почте. Человек отвечает по ссылке без регистрации, и его ответ приходит в ваш чат с агентом.
- **Через контакт в «Сам Решу».** Если у контрагента тоже есть агент и вы в контактах друг у друга, ваш агент пишет его агенту.
- **Через подключённый сервис.** Если клиенты пишут вам в сервис, подключённый в **«Интеграциях»** (CRM, открытые линии, мессенджер для бизнеса), агент отвечает им в этой переписке, когда у подключения есть такое право: [Подключённые сервисы](/help/integrations).

<TryPrompt prompt="Подготовь ссылку для ответа поставщику: спроси, когда будет следующая поставка и сколько единиц." />

## Свой бот организации

Бот организации выходит с именем и аватаром вашей компании и нужен для Пачки, Microsoft Teams и Slack, а также для Telegram-каналов.

### Подключите бота
Администратор открывает **Настройки → «Уведомления и мессенджеры» → «Подключить мессенджер»** и в группе **«Бот организации»** выбирает мессенджер. Для Telegram нужен токен бота из @BotFather.

### Выберите, кто отвечает
В строке **«Кто отвечает»** выберите агента. В боте отвечает только агент с доступом «Организация»; если такого нет, отвечает «Сам Решу». Сотрудники смогут писать агенту, а подтверждать действия и присылать файлы сможет только владелец агента.

### Раздайте ссылку сотрудникам
**«Ссылка для сотрудников»**: сотрудник открывает бота, нажимает Start и подключается в один тап.

Чтобы бот в Telegram видел в группах не только команды, в @BotFather выключите Group Privacy (`/mybots` → бот → Bot Settings → Group Privacy → Turn off) и пригласите бота в группу заново.

## Если бот перестал писать

| Что видно | Что делать |
|---|---|
| «Диалог с ботом остановлен» | Вы или собеседник остановили бота в мессенджере. Откройте чат с ботом и нажмите «Начать» или напишите любое сообщение. Переподключать не нужно |
| «Бота удалили» или «нет права писать» в группе | Верните бота в группу и разрешите ему отправлять сообщения. Доставка восстановится сама |
| «Мессенджеры недоступны по политике организации» | Администратор организации закрыл мессенджеры. Пишите агенту в приложении |
| Бот отвечает, что чат не подключён | Нажмите «Подключить» в его сообщении или отправьте ему код с сайта |
| «Токен бота больше не действует» (бот организации) | Администратор выпускает новый токен в @BotFather и заменяет его в настройках бота |