Telegram — личный аккаунт
Навык «Telegram — личный аккаунт» в категории «Интеграции» работает с вашим аккаунтом Telegram. После подключения Искре доступны те облачные чаты, которые доступны самому аккаунту: личные диалоги, Избранное, группы, каналы и архив. Отдельно выбирать разрешённые чаты не требуется. Служебный чат «Telegram» с кодами входа Искра не читает (см. «Чего навык не делает»).
Подключение
Подключение даёт Искре сессию вашего Telegram-аккаунта. Она сохраняется на сервере Искры и даёт доступ ко всем облачным чатам аккаунта, включая личную переписку, Избранное и архив. Секретные чаты недоступны. Подключая аккаунт Telegram, вы разрешаете Искре доступ к нему и принимаете связанные с этим риски. Действия от вашего имени зависят от настройки «Разрешить действия в Telegram».
На странице входа это предупреждение постоянно видно и для телефона, и для QR. Закрытие страницы не отзывает доступ. Чтобы отозвать сессию, откройте Telegram → Настройки → Устройства и завершите сеанс этого подключения.
Установите навык в личный профиль и попросите: «Подключи мой Telegram». Искра даст ссылку на защищённую страницу входа. Можно ввести номер телефона и код Telegram или выбрать «Войти по QR». Для QR откройте в приложении Telegram Настройки → Устройства → Подключить устройство, сканируйте код с экрана и подтвердите вход на телефоне. Форма завершит подключение автоматически. Если включена двухэтапная аутентификация, введите её пароль в этой форме. Номер, код и пароль не нужны в переписке с Искрой. После успешного входа нажмите «Вернуться в чат»: откроется тот диалог, из которого вы начали подключение. Попросите Искру проверить подключение или продолжите свою задачу.
Если ожидание QR закончилось или страницу пришлось обновить, нажмите «Продолжить вход по QR». После сетевой ошибки сначала обновите состояние формы. Если подтвердили вход на телефоне, но попытка подключения истекла, проверьте Telegram → Настройки → Устройства и удалите незавершённый сеанс.
К одному профилю Искры подключается один аккаунт Telegram. Если администратор выключил навык, его нет в каталоге. Если навык есть, но администратор ещё не задал ключи приложения Telegram, Искра и страница входа отвечают, что подключение пока не настроено. Истёкшую попытку входа можно заменить новой ссылкой через команду подключения.
Код входа можно запросить не больше 5 раз в час на профиль Искры и 3 раз в час на один номер; попытка, при которой связь с Telegram не установилась, не считается. Дальше страница входа покажет «Слишком много попыток входа» и время ожидания.
Если администратор сменил приложение Telegram, новое подключение сначала завершает прежний сеанс Искры в Telegram. Если это не удалось, Искра скажет об этом: завершите прежний сеанс в Telegram → Настройки → Устройства.
Если номер ещё не зарегистрирован, создайте аккаунт в официальном приложении Telegram и начните подключение заново. Если Telegram предложит неподдерживаемый способ доставки кода, Искра объяснит причину и остановит ввод. Это не сетевой сбой: повторять тот же код или пароль не требуется.
Что можно поручить
- Найти нужный чат, прочитать историю за период или получить конкретные сообщения.
- Искать сообщения средствами Telegram в одном чате или по доступным перепискам.
- Читать существующие темы форума и обсуждения, отвечать в них.
- Отправлять текст, отвечать, редактировать сообщения и подписи, удалять конкретные сообщения и пересылать их в другой чат.
- Сохранить отдельное вложение в рабочую папку разговора Искры или отправить файл из неё как документ либо фотографию.
Например: «Найди в архиве переписку с подрядчиком и собери договорённости за прошлую неделю» или «Сохрани PDF из этого сообщения в рабочую папку». Когда сообщений много, Искра читает их страницами и продолжает по запросу.
Чтобы указать публичный чат, передайте его username или ссылку
t.me/<username>. Приватный чат попросите найти в списке диалогов вашего
аккаунта. Для чтения конкретного сообщения передайте его ссылку, в том числе t.me/c/.... Приглашения открывайте в Telegram.
Доступ и сохранение в Избранное
В Навыки → Telegram — личный аккаунт → Настройки есть переключатель «Разрешить действия в Telegram». По умолчанию он выключен: Искра может читать, искать и скачивать доступные сообщения и файлы. Отправка, правка, удаление и пересылка становятся доступны после включения переключателя. Подключение и отключение текущего аккаунта доступны в обоих режимах.
Для сохранения подготовленного текста попросите: «Отправь этот текст в Избранное». Это обычная отправка от вашего аккаунта, поэтому переключатель должен быть включён. Отдельного хранилища черновиков у навыка нет.
Разрешение действий и подтверждение — две отдельные настройки. В режиме подтверждения Искра показывает форму с адресатом и содержимым. Адресат назван видом и признаком, который не задаёт владелец чата: «Избранное (ваш аккаунт)», «Пользователь @username «Имя»» или «Пользователь ID … «Имя»», «Группа …», «Канал …». Название чата задаёт его владелец, поэтому оно идёт последним: сверяйте вид и @username или ID в начале строки. При пересылке форма показывает, откуда и какие сообщения уйдут, при удалении — какие сообщения удаляются (первые десять и число остальных); если они изменились до подтверждения, действие не выполняется.
В автоматическом режиме Искра выполняет подготовленное действие без формы. Этот режим включаете вы в настройках навыка. Учтите, что переписка, письма и страницы, которые читает Искра, могут содержать подложенные указания: с автоматическим режимом действие по ним выполнится без вашей проверки. Администратор Искры может выключить автоматический режим для навыка. Выключение переключателя блокирует ещё не начатые действия, включая ранее подготовленные. Уже выполняющийся запрос может завершиться. При переустановке навыка доступ снова ограничен чтением; обычное обновление сохраняет выбранный режим.
В общем чате подтвердить действие может только тот, чей Telegram-аккаунт используется. Ответ другого участника не выполняет действие от вашего имени. Другой участник, попросив Искру о Telegram, работает со своим подключением, а не с вашим. Но всё, что Искра прочитала из вашего Telegram в общем чате, и формы подтверждения видны его участникам: с личной перепиской работайте в своём чате.
Этот переключатель управляет личным подключением tg-user. Режим секретаря
Telegram Business в навыке бота настраивается отдельно.
Ссылки, реакции и опросы
Пришлите Искре ссылку на сообщение https://t.me/имя/номер или
https://t.me/c/номер_чата/номер_сообщения и попросите прочитать его с контекстом.
Поддерживаются ссылки на темы и комментарии, а также публичные ссылки /s/.
Можно задать от 0 до 20 соседних сообщений с каждой стороны; по умолчанию — по 5.
Искра сначала показывает выбранное сообщение. Если поиск приватного чата достиг
предела, попросите найти чат в списке диалогов и повторить чтение по ссылке.
При переходе в другой разговор с Искрой попросите её заново найти чат.
Можно прочитать реакции, закрепы и обычные опросы, найти закреплённые сообщения или опросы в выбранном чате. Поиск возвращает страницы; для всего чата нужно продолжить чтение. Если Telegram вернул неполные итоги, Искра сообщает об этом. После включения действий можно поставить или снять свои реакции, закрепить или открепить конкретное сообщение, создать обычный опрос, проголосовать или закрыть свой обычный опрос. Создание и закрытие викторин пока недоступно; в существующей викторине можно прочитать варианты и проголосовать.
Отложенная отправка
Попросите отправить сообщение в выбранный день и время и укажите часовой пояс. Можно запланировать текст, пересылку или отдельный файл. Время должно быть хотя бы через минуту. В режиме подтверждения форма показывает адресата, содержимое и точную дату. Если время истекло до подтверждения, выберите новое.
Искра может прочитать очередь выбранного чата, перенести конкретную отправку или отменить её. Отправляет сам Telegram, даже если Искра отключена. Выключение «Разрешить действия» сохраняет ранее запланированные сообщения. Просмотр очереди остаётся доступен; для переноса или отмены включите действия либо откройте очередь в приложении Telegram. Запись очереди и отправленное сообщение имеют разные идентификаторы; после отправки проверяйте историю чата.
Прокси
По умолчанию Telegram подключается через прокси Искры — вариант iskra
во вкладке «Прокси Telegram». Маршрут для него задаёт администратор
Искры, настраивать ничего не нужно. Если раньше в настройке был сохранён
прямой выход (direct), теперь он тоже означает прокси Искры.
Чтобы подключаться через свой сервер, выберите socks5 или mtproxy и
укажите публичный адрес сервера и порт. Для SOCKS5 с авторизацией заполните
имя пользователя и пароль, для MTProxy — секрет сервера.
После смены типа, адреса, порта или имени пользователя введите пароль или
секрет заново. Повторное сохранение прежнего маршрута сохраняет его секрет.
Для SOCKS5 без авторизации оставьте имя пользователя пустым: сохранённый
пароль при таком подключении не применяется.
Маршрут, пароль и секрет задаются вами в форме настроек навыка; инструменты
Искры из чата не меняют эту настройку.
Свой прокси полностью заменяет прокси Искры: подключение аккаунта, чтение,
отправка и передача файлов идут только через него. Если выбранный прокси
недоступен, Искра сообщает «Не удалось связаться с Telegram» и не
переключается на другой маршрут сама: исправьте настройку или вернитесь к
варианту iskra. Прокси меняет сетевой маршрут, а обработка сообщений Искрой
по-прежнему выполняется на сервере платформы.
Что означают сообщения о связи:
- «Не удалось связаться с Telegram» — сбой связи на выбранном маршруте. Повторите позже; если выбран свой прокси, проверьте его.
- «Telegram просит подождать» — ограничение со стороны Telegram; Искра покажет время ожидания.
- «Telegram отклонил запрос» с типом ответа — Telegram отказал в этом действии; смена прокси не поможет.
- «Временная ошибка Telegram» — повторите позже.
- «Приложение Telegram настроено неверно» — сообщите администратору.
- «Администратор сменил приложение Telegram» — подключите аккаунт заново.
- «Telegram сейчас занят» — повторите через минуту.
- «Подключение Telegram ещё не настроено» — администратор ещё не задал ключи приложения.
- «Свой прокси в настройках навыка заполнен неверно» — исправьте вкладку «Прокси Telegram» или выберите прокси Искры.
Чего навык не делает
- Не читает служебный чат «Telegram», куда приходят коды входа и уведомления о новых входах: его нет в списке чатов и поиске, а запрос к нему Искра отклоняет. Пересылать и отправлять в него, ставить в нём реакции и закреплять сообщения тоже нельзя.
- Не меняет номер телефона и пароль двухэтапной аутентификации, не завершает другие сеансы, не удаляет аккаунт и не подтверждает вход на других устройствах: таких действий в навыке нет.
- Не читает секретные чаты.
Границы возможностей
Поддерживаются отдельные файлы до 20 MiB. Аудио и видео скачиваются и отправляются исходными файлами. Альбомы, специальные голосовые сообщения, стикеры и управление группами в навык не входят. Новые сообщения сами по себе не запускают Искру: навык работает по обращению. Секретные чаты и удалённые сообщения недоступны. Действуют ограничения Telegram на редактирование, пересылку защищённых сообщений и доступ к содержимому.
Если Telegram ограничил частоту запросов, Искра покажет время ожидания. При потере ответа на отправку возможен неопределённый исход: сообщение могло уйти. Сначала попросите проверить исход операции и историю чата; повторную отправку следует делать только после проверки.
Как отключить Telegram
Попросите: «Отключи мой Telegram». Искра удалит сессию у себя и завершит её в Telegram, в том числе после смены приложения администратором. Если выход подтвердить не удалось, Искра скажет об этом: завершите сеанс Искры в Telegram → Настройки → Устройства. Переписка в Telegram сохраняется.
При удалении навыка Искра сначала завершает сеанс в Telegram. Если это не удалось, навык не удаляется, и Искра объясняет причину: отключите Telegram в чате с Искрой или завершите сеанс в «Устройствах», затем удалите навык снова.