> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riggery.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Аккаунт Telegram

> Отправка, поиск и чтение с аккаунта Telegram, вошедшего на вкладке «Триггеры».

Этот инструмент использует аккаунт Telegram на [Триггерах](/ru/instance/triggers#telegram-account). Бота Instance он не использует.

На агенте это один инструмент. Действия включаются и выключаются. Модель заполняет **peer** (имя пользователя, числовой id или ссылка `t.me`) и остальные поля. Личная отправка начинает слушать ответ этого человека.

На канвасе узел выполняет одно действие. Действие и его поля задаются на узле.

| Действие | Что делает |
| - | - |
| **Отправить текст** | Отправляет текст. Личная отправка слушает ответ. |
| **Отправить фото, файл или голосовое** | Отправляет фото, файл, голосовое, видео или альбом из файла, который уже лежит на этом Instance. Альбом — от 2 до 10 фото или видео. Личная отправка слушает ответ. |
| **Переслать сообщения в другой чат** | Пересылает сообщения из одного чата в другой. Личная пересылка слушает ответ. |
| **Изменить своё сообщение** | Заменяет текст своего сообщения или подпись к своему фото или файлу. |
| **Поставить или снять реакцию** | Ставит один эмодзи на сообщение или снимает свою реакцию. |
| **Нажать кнопку под сообщением** | Нажимает inline-кнопку. **button** — число в `buttons=` в строке истории или поиска. Кнопки-ссылки не нажимаются. |
| **Закрепить или открепить сообщение** | Закрепляет одно сообщение или открепляет его. Чат не уведомляется. |
| **Открыть профиль** | Показывает карточку человека или чата: имя, имя пользователя, описание и число участников, если Telegram их вернул. Телефон есть только у этого человека и только если Telegram его вернул. |
| **Показать истории** | Показывает активные истории человека или чата, либо этого аккаунта, если peer пустой. limit задаёт, сколько вернуть. Архив — отдельная страница того же размера. Если она заканчивается на cursor, вызовите инструмент снова с этим cursor. Просмотр здесь не отмечает историю просмотренной. Выключено, пока его не включат. |
| **Изменить имя, описание или фото** | Меняет имя, фамилию, текст о себе или фото этого аккаунта. Пустое поле остаётся как есть. Убрать фамилию, текст о себе или текущее фото — отдельные переключатели. Выключено, пока его не включат. |
| **Опубликовать историю** | Публикует одно фото или видео, уже сохранённое на этом Instance. Её видят контакты, если не выбрать всех или близких друзей. Она живёт 24 часа и не является сообщением в чат. Выключено, пока его не включат. |
| **Удалить историю** | Удаляет истории этого аккаунта. Id берутся из строки историй. Выключено, пока его не включат. |
| **Показать участников чата** | Показывает одну страницу участников. Личный чат возвращает этого человека. Если результат заканчивается на cursor, вызовите инструмент снова с этим cursor. Скрытый список участников возвращает ошибку. |
| **Показать темы форума** | Показывает одну страницу тем форума. Если результат заканчивается на cursor, вызовите инструмент снова с этим cursor и теми же peer и запросом. Чат без тем возвращает ошибку. |
| **Отметить чат прочитанным** | Отмечает чат прочитанным до id сообщения или до последнего сообщения, если id пустой. Значки упоминаний снимаются. |
| **Выключить звук или убрать в архив** | Выключает или включает звук и кладёт чат в архив или возвращает его. Незаполненное поле не меняется. Это не останавливает запуск и не меняет, какие чаты запускают сценарий. Выключено, пока его не включат. |
| **Создать или отозвать ссылку** | Создаёт ссылку в группу или канал либо отзывает одну ссылку, если она указана. Остальные ссылки остаются. Уже вступившие остаются. Выключено, пока его не включат. |
| **Получить варианты от бота** | Спрашивает бота и ничего не отправляет. Id запроса и id результата берутся из ответа. |
| **Отправить результат бота в чат** | Отправляет один из этих результатов в чат. Личная отправка ждёт ответ. Если Telegram говорит, что результат устарел, спросите снова. |
| **Отправить опрос** | Отправляет анонимный опрос из 2–10 ответов. Укажите правильный ответ, чтобы отправить открытую викторину. У викторины не бывает нескольких ответов. Личный опрос ждёт ответ. |
| **Проголосовать в опросе** | Голосует в опросе. Номер берётся из `options=` в строке истории или поиска. Если можно выбрать несколько, все номера передаются сразу. |
| **Создать группу или канал** | Создаёт группу или канал. Новые сообщения в нём не запускают сценарий. Выключено, пока его не включат. |
| **Удалить сообщения** | Удаляет сообщения в одном чате. **Удалить у всех** убирает их и у других людей. В канале и супергруппе сообщения удаляются всегда у всех. Выключено, пока его не включат. |
| **Заблокировать или разблокировать** | Блокирует или разблокирует человека. Чат заблокировать нельзя. История остаётся. Запускает ли этот чат сценарий, не меняется. Выключено, пока его не включат. |
| **Выйти из группы или канала** | Выходит из группы или канала. Из личного чата выйти нельзя. Правило запуска для этого чата снимается. Выключено, пока его не включат. |
| **Исключить человека из чата** | Исключает человека из группы или канала. Он может войти снова. Выключено, пока его не включат. |
| **Забанить или снять бан** | Банит человека в супергруппе или канале либо снимает бан. В обычной группе бана нет. Выключено, пока его не включат. |
| **Ограничить, что человек может отправлять** | Запрещает человеку писать или отправлять медиа в супергруппе или канале либо снова разрешает. Забаненного сначала нужно разбанить. Выключено, пока его не включат. |
| **Изменить права администратора** | Даёт или снимает права админа. В обычной группе человек может быть только админом или участником. Владельца чата изменить нельзя. Выключено, пока его не включат. |
| **Найти человека или публичный чат** | Ищет публичных людей и чаты. |
| **Вступить в чат или по ссылке** | Вступает в публичный чат или по ссылке. Вступление не начинает запуск на новые посты. |
| **Читать сообщения в чате** | Читает до 50 сообщений. В каждой строке есть messageId. Опросы записаны как `options=0:Yes`. Inline-кнопки записаны как `buttons=0:Yes`. Если результат заканчивается на olderThan, вызовите инструмент снова с этим значением, чтобы прочитать более старые. Файлы отмечены, но не скачаны. |
| **Показать свои чаты** | Показывает одну страницу ваших чатов. Если результат заканчивается на cursor, вызовите инструмент снова с этим значением. Архив — отдельная страница. |
| **Искать текст в сообщениях** | Ищет текст в одном чате или во всех чатах, если peer пустой. Строка опроса содержит `options=`. Результат по всем чатам содержит peer. Если результат заканчивается на cursor, вызовите инструмент снова с этим cursor и тем же peer. |
| **Скачать файл из сообщения** | Сохраняет файл одного сообщения на этом Instance. messageId берётся из строки истории того же чата. |
| **Запускать сценарий, когда этот чат пишет** | Начинает запуск на будущие сообщения этого человека или чата. |
| **Остановить запуск для этого чата** | Перестаёт начинать запуск для этого человека или чата. Владельца игнорировать нельзя. |
| **Показать, какие чаты запускают сценарий** | Показывает правила по умолчанию и исключения по людям. |

<h2 id="output">
  Результат
</h2>

На следующем узле **Предыдущие узлы** показывают имя инструмента и **Result**. Result — короткий статус, не текст сообщения.