t.me на чат) и остальные поля. Для темы форума добавьте к peer /topicId или передайте ссылку t.me/…/сообщение; один id темы в peer не передавайте. Id темы берётся из topicId= у входящего сообщения или в строке истории либо из Показать темы форума. После / подходит и id любого сообщения внутри темы. /1 или сообщение из General отправляет в General. Если запуск начал Telegram account, в этом ходе уже есть id этого чата и topicId, если сообщение пришло из темы: передайте их как peer, например -1001234567890/18. Разрешена ли отправка, зависит от Ответы на Триггерах. Когда включено Слушать чат, в который написал агент, успешная отправка начинает слушать этот чат.
На канвасе узел выполняет одно действие. Действие и его поля задаются на узле.
| Действие | Что делает |
|---|---|
| Отправить текст | Отправляет текст. Следует Ответы на Триггерах. Когда включено Слушать чат, в который написал агент, успешная отправка начинает слушать этот чат. |
| Отправить фото, файл или голосовое | Отправляет фото, файл, голосовое, видео или альбом из файла, который уже лежит на этом Instance. Альбом — от 2 до 10 фото или видео. Следует Ответы на Триггерах. Когда включено Слушать чат, в который написал агент, успешная отправка начинает слушать этот чат. |
| Показать стикеры набора | Показывает стикеры публичного набора. Набор стикеров — короткое имя или ссылка t.me/addstickers/. В каждой строке есть sticker=. Набор своих эмодзи помечен, и отправить его как стикер нельзя. |
| Отправить стикер | Отправляет один стикер из этого набора в чат. Стикер — id из строки списка. Файл на этом Instance не сохраняется. Следует Ответы на Триггерах. Когда включено Слушать чат, в который написал агент, успешная отправка начинает слушать этот чат. |
| Установить набор стикеров | Добавляет набор на этот аккаунт. Повторная установка допустима. Если Telegram архивирует старые наборы, в результате будет их число. |
| Переслать сообщения в другой чат | Пересылает сообщения из одного чата в другой. Следует Ответы на Триггерах. Когда включено Слушать чат, в который написал агент, успешная отправка начинает слушать этот чат. |
| Изменить своё сообщение | Заменяет текст своего сообщения или подпись к своему фото или файлу. |
| Поставить или снять реакцию | Ставит один эмодзи на сообщение или снимает свою реакцию. |
| Нажать кнопку под сообщением | Нажимает inline-кнопку. button — число в buttons= в строке истории или поиска. Кнопки-ссылки не нажимаются. |
| Закрепить или открепить сообщение | Закрепляет одно сообщение или открепляет его. Чат не уведомляется. |
| Открыть профиль | Показывает карточку человека или чата: имя, имя пользователя, описание и число участников, если Telegram их вернул. Телефон есть только у этого человека и только если Telegram его вернул. У группы или канала с закреплённым сообщением оно идёт второй строкой, pinned messageId=…: текст. Правила группы часто лежат там. |
| Показать истории | Показывает активные истории человека или чата, либо этого аккаунта, если peer пустой. limit задаёт, сколько вернуть. Архив — отдельная страница того же размера. Если она заканчивается на cursor, вызовите инструмент снова с этим cursor. Просмотр здесь не отмечает историю просмотренной. Выключено, пока его не включат. |
| Изменить имя, описание или фото | Меняет имя, фамилию, текст о себе или фото этого аккаунта. Пустое поле остаётся как есть. Убрать фамилию, текст о себе или текущее фото — отдельные переключатели. Выключено, пока его не включат. |
| Опубликовать историю | Публикует одно фото или видео, уже сохранённое на этом Instance. Её видят контакты, если не выбрать всех или близких друзей. Она живёт 24 часа и не является сообщением в чат. Выключено, пока его не включат. |
| Удалить историю | Удаляет истории этого аккаунта. Id берутся из строки историй. Выключено, пока его не включат. |
| Показать участников чата | Показывает одну страницу участников. Личный чат возвращает этого человека. Если результат заканчивается на cursor, вызовите инструмент снова с этим cursor. Скрытый список участников возвращает ошибку. |
| Показать темы форума | Показывает одну страницу тем форума. Если результат заканчивается на cursor, вызовите инструмент снова с этим cursor и теми же peer и запросом. Чат без тем возвращает ошибку. |
| Отметить чат прочитанным | Отмечает чат прочитанным до id сообщения или до последнего сообщения, если id пустой. Значки упоминаний снимаются. |
| Выключить звук или убрать в архив | Выключает или включает звук и кладёт чат в архив или возвращает его. Незаполненное поле не меняется. Это не останавливает запуск и не меняет, какие чаты запускают сценарий. Выключено, пока его не включат. |
| Создать или отозвать ссылку | Создаёт ссылку в группу или канал либо отзывает одну ссылку, если она указана. Остальные ссылки остаются. Уже вступившие остаются. Выключено, пока его не включат. |
| Получить варианты от бота | Спрашивает бота и ничего не отправляет. Id запроса и id результата берутся из ответа. |
| Отправить результат бота в чат | Отправляет один из этих результатов в чат. Следует Ответы на Триггерах. Когда включено Слушать чат, в который написал агент, успешная отправка начинает слушать этот чат. Если Telegram говорит, что результат устарел, спросите снова. |
| Отправить опрос | Отправляет анонимный опрос из 2–10 ответов. Укажите правильный ответ, чтобы отправить открытую викторину. У викторины не бывает нескольких ответов. Следует Ответы на Триггерах. Когда включено Слушать чат, в который написал агент, успешная отправка начинает слушать этот чат. |
| Проголосовать в опросе | Голосует в опросе. Номер берётся из options= в строке истории или поиска. Если можно выбрать несколько, все номера передаются сразу. |
| Создать группу или канал | Создаёт группу или канал. Новые сообщения в нём не запускают сценарий. Выключено, пока его не включат. |
| Удалить сообщения | Удаляет сообщения в одном чате. Удалить у всех убирает их и у других людей. В канале и супергруппе сообщения удаляются всегда у всех. Выключено, пока его не включат. |
| Заблокировать или разблокировать | Блокирует или разблокирует человека. Чат заблокировать нельзя. История остаётся. Запускает ли этот чат сценарий, не меняется. Выключено, пока его не включат. |
| Выйти из группы или канала | Выходит из группы или канала. Из личного чата выйти нельзя. Правило запуска для этого чата снимается. Выключено, пока его не включат. |
| Исключить человека из чата | Исключает человека из группы или канала. Он может войти снова. Выключено, пока его не включат. |
| Забанить или снять бан | Банит человека в супергруппе или канале либо снимает бан. В обычной группе бана нет. Выключено, пока его не включат. |
| Ограничить, что человек может отправлять | Запрещает человеку писать или отправлять медиа в супергруппе или канале либо снова разрешает. Забаненного сначала нужно разбанить. Выключено, пока его не включат. |
| Изменить права администратора | Даёт или снимает права админа. В обычной группе человек может быть только админом или участником. Владельца чата изменить нельзя. Выключено, пока его не включат. |
| Найти человека или публичный чат | Ищет публичных людей и чаты. |
| Вступить в чат или по ссылке | Вступает в публичный чат или по ссылке и возвращает id чата. Если аккаунт уже участник, результат говорит об этом и даёт тот же id. Чат с одобрением заявок возвращает ошибку о том, что заявка отправлена. Вступление не начинает запуск на новые посты. |
| Читать сообщения в чате | Читает до 50 сообщений. В каждой строке есть messageId. Сообщение в теме форума содержит topicId. Ответ содержит replyTo. Ответ в другом чате содержит replyPeer. Ответ на историю содержит replyStory. Опросы записаны как options=0:Yes. Inline-кнопки записаны как buttons=0:Yes. Если результат заканчивается на olderThan, вызовите инструмент снова с этим значением, чтобы прочитать более старые. Файлы отмечены, но не скачаны. |
| Показать свои чаты | Показывает одну страницу ваших чатов. Если результат заканчивается на cursor, вызовите инструмент снова с этим значением. Архив — отдельная страница. |
| Показать свои исходящие | Показывает, что этот аккаунт отправил, изменил, на что поставил реакцию и куда вступил, сначала новые. Это свои исходящие, а не поиск по чужим сообщениям. Если результат заканчивается на cursor, вызовите инструмент снова с этим cursor и теми же peer, action и since. |
| Искать текст в сообщениях | Ищет текст в одном чате или во всех чатах, если peer пустой. Ответ содержит replyTo, а сообщение в теме — topicId, как у чтения сообщений. Строка опроса содержит options=. Результат по всем чатам содержит peer. Если результат заканчивается на cursor, вызовите инструмент снова с этим cursor и тем же peer. |
| Скачать файл из сообщения | Сохраняет файл одного сообщения на этом Instance. messageId берётся из строки истории того же чата. |
| Запускать сценарий, когда этот чат пишет | Слушает каждое сообщение в этом чате. Агент может должно быть Добавлять свои чаты или Добавлять и убирать свои чаты. Добавлять свои чаты не меняет Запуск и Ответы у уже добавленной строки, а только отодвигает До. Добавлять и убирать свои чаты может менять и убирать свои строки. Один peer — весь чат, и он заменяет строки тем, которые поставил агент. Ваши строки остаются. peer/topicId в форуме — только эта тема. minutes — сколько минут, от 5 до значения в Агент добавляет чат максимум на (не больше 30 дней). Не указывайте его, чтобы оставить текущий срок или взять этот предел для новой строки. forever true ставит строку без срока, если включено Агент может добавить чат навсегда. remove true удаляет строку агента и требует Добавлять и убирать свои чаты. Строку, которую поставили вы, Избранное и ваш собственный чат агент не меняет. |
| Остановить запуск для этого чата | Останавливает запуски из этого чата. Ответы не меняются. Те же ограничения, что у Запускать сценарий, когда этот чат пишет, действуют для peer, minutes и ваших строк. |
| Показать, какие чаты запускают сценарий | Показывает правило для личных чатов, групп и каналов, Агент может и Слушать чат, в который написал агент. Дальше каждая строка — чат или id чата/id темы, кто её поставил и until, если она закончится. inherit следует чату, затем правилу по умолчанию. Строка темы важнее строки всего чата. Это не правила публикации в группе; их читайте в самом чате. |
Результат
На следующем узле Предыдущие узлы показывают имя инструмента и Result. Result — короткий статус, не текст сообщения. Result отправки текста, файла, стикера, пересылки, результата бота или опроса содержитmessageId нового сообщения и topicId, если оно ушло в тему форума, например Sent to -1001234567890 messageId=4521 topicId=18 (120 chars).