telegram cli что это
Клиент Telegram CLI
Telegram CLI для Linux – проявление того самого духа «сделай сам», старой школы IT превосходства клавиатуры над мышами и сенсорными дисплеями. Помимо всего прочего, это ещё и удачно сделанный клиент, для некоторых целей незаменимый.
Если вы – приверженец консолей, но по какой-то причине не знали о TCLI, то наверняка захотите узнать об этому чудо-клиенте больше.
Послать телеграмму из командной строки
Любой линуксоид сможет легко найти с десяток причин, почему командная строка лучше графического интерфейса. Требует меньше вычислительного ресурса, обращается напрямую к нужной команде, позволяет экономить энергию… А самое главное – даёт чувство причастности к клубу избранных, знающих, что с этим мигающим экраном делать. Пользователь выглядит точь-в-точь как хакер в голливудском фильме – с той разницей, что всё работает.
Разумеется, все программы, которые имеют графический интерфейс, можно свести к голому ядру и управлять им из той же командной строки. Сервис Telegram – не исключение. Неудивительно, что именно в Linux появился минималистичный клиент Telegram CLI, где последнее слово расшифровывается как Command Line Interface.
Преимущества CLI
У командной строки есть целый ряд преимуществ, которые оценят те, кому дороги секунды и неудобны лишние движения:
Существуют и другие степени свободы, которые, впрочем, зависят от специфики системы. Например, если одновременно использовать наш клиент и программу для работы с дампом, это облегчает создание бэкапа со всеми вложениями, независимого от доступности сервера.
Инсталляция Telegram CLI
Понятно, что клиент ещё не стал частью официальных дистрибутивов Linux: для гиковских Fedora и Slackware он необязателен, для массовой Ubuntu – слишком гиковский. Поэтому устанавливать его придётся самостоятельно. По мере распространения программа появляется в некоторых популярных репозиториях, но не во всех.
Рассмотрим инсталляцию Telegram CLI для некоторых версий.
Ubuntu/Debian
Для «народного» дистрибутива Linux процесс установки через стандартный менеджер пакетов невозможен. Однако можно воспользоваться пакетами Snap. Тогда установка выглядит так:
Стоит отметить, что, если вы используете Snap впервые, то первоначально вам понадобится установить специфическое ядро. Оно занимает относительно немного места – порядка 80 МБ. Зато потом вы сможете работать со Snap-пакетами совершенно свободно. Можете даже отпраздновать это, спев «I’ve got the power!»
Fedora
Для данного Linux-проекта Telegram CLI получить проще, так как программа доступна через репозитории., Поэтому:
Это штатный способ установки, и он оптимален, если вы просто хотите воспользоваться клиентом.
Для других дистрибутивов стоит воспользоваться тематическими ресурсами, где обсуждается Telegram CLI. В задачи данной статьи не входит объять необъятное.
Команды клиента CLI
Рассмотрим доступный список команд (по состоянию на июль 2018 года) с комментариями. Список предоставляется непосредственно создателями программы.
Если вы недостаточно знакомы с идеологией консольных команд, то поясним, что в нашем случае:
Внимательно следите за всем, что набираете. Иначе ваши руки вас подведут. Таким образом, консольный клиент – это выбор людей, уверенных в своих извилинах и пальцах.
В качестве примера для рассмотрения приведём набор команд для работы с абонентами.
Общение
Text – отправка сообщения абоненту, где msg – команда отправки, peer – имя пользователя, Text – текст сообщения
fwd — переадресация сообщения. Чтобы сообщения отображались под номерами, при запуске клиента нужно указать в терминале параметр «–N».
— запускает приватную беседу с указанным абонентом. Для вызода из беседы наберите /exit или /quit.
— добавляет в контакт-лист контакт с указанным телефонным номером под заданными именем и фамилией (конечно, если таковой существует)
rename_contact — пытается переименовать контакт. Возможны конфликты, если вы используете аккаунт Telegram и на других устройствах.
— отметить все сообщения от абонента как прочитанные (действует так же, как аналогичная команда в других клиентах)
delete_msg — удаление сообщения. Разумеется, у собеседника оно останется.
restore_msg — восстановление удалённых сообщений. Работает в течение некоторого времени (приблизительно часа) после удаления. Для тайных чатов не работает вообще.
Аналогичным образом работают команды по добавлению контакта в список, по отправке или сохранению файлов, по работе с визитными карточками или групповыми чатами.
Полный обновляемый список команд можно прочесть на странице разработчика. Он доступен лишь на английском, но, учитывая специфику клиента, это совсем не страшно.
Написать Telegram клиент — легко
Чем отличается Telegram от других популярных мессенджеров? Он — открытый!
Другие мессенджеры тоже имеют API, но почему-то именно телеграм известен как наиболее открытый из самых популярных?
Начнем с того, что у Telegram действительно полностью открытый клиентский
код. К сожалению, мы не видим комиты каждый день прямо на GitHub, но у нас есть код под открытой лицензией. Архитектура Telegram подразумевает, что и Bot и API имеет практически такие же методы — https://core.telegram.org/methods.
На самом деле, Telegram представляет не просто чат-мессенджер, а социальную платформу, доступ к которой открыт для разного рода приложений. Они могут предоставлять дополнительные фишки пользователям, взамен используя готовую сеть пользователей и сервера для доставки сообщений. Звучит настолько привлекательно, что нам захотелось попробовать написать своего «клиента» для Телеграм.
Суть приложения
В основном мы занимаемся картами и навигацией, поэтому мы сразу смотрели что-нибудь связанные с геолокацией. Мне очень понравилось, что в Telegram, раньше всех остальных приложений, появился удобный способ делится местоположением в реальном времени (https://telegram.org/blog/live-locations) и я достаточно часто этим пользуюсь: помочь сориентироваться другу, показать дорогу и самое главное ответить на главный вопрос «Когда ты будешь?». В принципе, этого хватает большинству людей, но как всегда есть сценарии, когда простых возможностей не хватает. Например, это может быть группа более 10 человек, с разными устройствами (некоторые устройства возможно не являются телефонами) и разными людьми. Этим людям было бы удобно обмениваться сообщениями в группе, а также видеть перемещения друг друга на карте.
Во главу угла мы поставили задачу создать дополнительную ценность для Telegram, а не пытаться использовать его не по назначению. Мы не хотели, чтобы люди у которых нет специального клиента Телеграм, видели в чате месиво сообщений или что-то невразумительное. У людей с «улучшенным» клиентом, появляются же дополнительные возможности, например:
Как мы это делали
К счастью, весь код, который мы пишем — Open-Source, поэтому я сразу могу дать ссылку на его реализацию — Реализация Bot и Реализация Telegram Client на Kotlin.
Bot — основы
По реализации Bot существует достаточно много документации и примеров, но все же хочется пройтись и рассказать про некоторые подводные камни. Для начала, мы писали серверную часть
на Java и выбрали библиотеку org.telegram:telegrambots. Так как наш сервер — это обычный SpringBoot, то инициализация крайне простая:
Основная особенность передачи location, что его надо часто обновлять, и боту необходимо редактировать уже отправленные сообщения. Если бы не было такой возможности, то Bot бы просто заспамил чат и это, конечно, был бы Epic Fail. Слава богу, Telegram предоставляет права боту редактировать сообщения на протяжении 24 часов (минимум, возможно и дольше).
Передать сообщение можно многими способами. Есть тип Plain Text, Venue, Location, Game, Contact, Invoice и т.д. Казалось, что для нашей задачи отлично подходит Location, но вскрылась неприятная особенность. Location можно передать только с одного устройства для одного аккаунта или бота одновременно! Представьте у вас 2 телефона и с двух телефонов вы отправили свой Location в один чат. Так вот, на сервере случится ошибка и первый Location Sharing просто остановится. Казалось бы, это явно неральный случай, но представьте, у вас много китайских маячков, которые умеют отправлять Location по заданному URL, но они не умеют отправлять прямо в Telegram. Вы пишите Bot, который забирает с сервера и пушит в телеграм. Вот тут и вылазит, то что Bot не сможет отправить больше одного сообщения маячка с типом Location. Получается, это отлично подходит для единоразовой отправки, но не подходит для Live Location.
Решение простое — отправлять текстовые сообщения, а клиент будет парсить текст и показывать локации на карте. К сожалению в стандартном клиенте Telegram будут видны только текстовые сообщения, но там можно вставить ссылку, чтобы открыть карту.
Bot — Подводные камни
К сожалению, Bot пришлось переписывать аж 2.5 раза. Основная проблема — неправильный дизайн коммуникации.
Telegram Client
Найти примеры готовых telegram client, кроме основного, нам не удалось, но достаточно простая структура tdlib помогла нам создать базовый клиент буквально за пару дней.
Практически все внутренности Телеграмма написаны на С++ и с точки зрения Android виден только класс API на 1.5 Мб прокси методов TdApi.java. Путем сопоставления документации ботов и названия методов, можно достаточно просто сориентироваться куда двигаться.
Telegram Client — подводные камни
Что получилось
Наверное, зная все подводные камни можно было бы все сделать в разы быстрее, но получилось где-то 1-2 месяца на трех человек. Финальное приложение можно найти в Google Play.
Главный вопрос в этой истории, насколько правильно это взаимодействие с точки зрения Телеграма и понравятся ли пользователям такого рода интеграции. В любом случае, сама идея нишевая и отдельных клиентов она уже нашла.
Telegram cli что это
Telegram messenger CLI 
Command-line interface for Telegram. Uses readline interface.
API, Protocol documentation
Documentation for Telegram API is available here: http://core.telegram.org/api
Documentation for MTproto protocol is available here: http://core.telegram.org/mtproto
After Travis-CI is done testing it uploads it’s build artifacts to https://tg-koter84.rhcloud.com
Clone GitHub Repository
or download and extract zip
Then, on all Linux and BSDs
The client depends on readline library and libconfig, which are not included in OS X by default. Lua is optional. You have to install these libraries manually.
Using Homebrew. Thanks to @jfontan for this solution.
Using MacPorts Thanks to @p3k for this solution. extra-link
If you manage to launch it on other UNIX, please let me know.
By default public key is stored in the same folder named tg-server.pub or in /etc/telegram/server.pub, if it’s not, specify where to find it:
Client support TAB completion and command history.
Peer refers to the name of the contact or dialog and can be accessed by TAB completion. For user contacts peer name is Name Lastname with all spaces changed to underscores. For chats it is it’s title with all spaces changed to underscores For encrypted chats it is Name Lastname with all spaces changed to underscores.
If two or more peers have same name, number is appended to the name. (for example A_B, A_B#1, A_B#2 and so on)
— mark read all received messages with peer
Group chat options
Stats and various info
Declaration of VAR
and some other stuff
Отправка состояния сервера через Telegram
Я давно собирался написать статью про Telegram, чтобы помочь его продвижению в массы. Не то, чтобы он в нём нуждался, но хотелось просто описать свой опыт использования и поделиться восхищением.
Но такого добра, думаю, уже навалом написали, потому это будет полезная статья о том, как использовать Telegram для получения информации с Linux-сервера, а именно:
Для этого будет использоваться консольный клиент telegram-cli.
Опишу своё рабочее окружение. Есть удалённый Linux-сервер с Ubuntu 14.04.1 LTS, размещённый у хостера. Я подключаюсь к нему по SSH под учётной записью root (то есть, домашняя папка: /root ).
Подразумевается, что вы знакомы с Linux, потому я не буду писать о том, как скопировать файл, как разрешить скрипт на выполнение и прочем подобном.
Установка telegram-cli
Сначала надо запилить библиотеки:
Дальше нужно создать каталог с данными и файл конфига:
Итак, первый запуск:
Он запустится, выведет что-то типа:
Тут надо подождать, пока не появится запрос номера телефона, ввести его, получить SMS и ввести код из него:
Теперь можно посмотреть список контактов на аккаунте:
Написать одному из контактов сообщение можно так:
Выход из приложения:
Понятно, что для автоматической отправки сообщений такое не подходит, а нам нужна именно она. Создаём скрипт /root/tg_msg_send.sh :
Теперь можно отправлять сообщения так:
Скрипт сбора информации
Запрос статуса nginx добавился позднее, так как через какое-то время я установил и его. Потому если у вас nginx отсутствует, то удалите его переменную из этого скрипта.
Создание задачи в планировщике
Сначала пишем ещё скрипт /root/tg_status_send.sh :
И теперь можно создавать задание в crontab :
Подробно о редактировании таблицы заданий можно прочитать в хорошей статье Schedule Tasks on Linux Using Crontab.
Моя строка задания такая:
Это значит, что скрипт (отправка сообщения с информацией по серверу) будет запускаться каждые полчаса, исключая ночное время.
После сохранения файла с таблицей не помешает перезагрузить службу:
Для контроля выполнения заданий можно просматривать журнал:
Всё, настройка завершена.
Теперь, если MySQL упадёт, в течение 15 минут я получу такие сообщения:
Позже, возможно, напишу, как общаться с сервером онлайн, а не только получать сообщения по расписанию.
А нет, не напишу, как общаться, потому что они запилили поддержку ботов, так что это уже не очень нужно. Вот зато может быть напишу про своего бота, если сделаю уже написал.
Telegram CLI
Установка
Но мы пойдём другим путём и установим его из сорцов, тем более что это делается очень просто.
Сборка из исходников
Мы уже находимся в каталоге /opt/tg поэтому начнем сборку.
Получилось? Тогда учимся пользоваться.
Запуск
Сначала telegram-cli спросит номер телефона. Вводим. Ждём сообщения с кодом. Вводим код. Получаем доступ к командной строке.
| Вид из командной строки | Пришедший код |
|---|---|
 |  |
Использование
Что первым делом нужно вводить в любую консоль?
Посмотрим, что у нас есть
Доступные команды
Для начала сделаю лирическое отступление и расскажу, что такое peer и как его употреблять.
Из официальной документации Peer это имя контакта или диалога; можно дополнять по TAB’у. Все пробелы заменяются на нижние подчеркивания.
Если у двух пользователей одинаковые имена, то к ним добавляется номер телефона. (например, Имя_Фамилия будет Имя_Фамилия#1, Имя_Фамилия#2 и так далее)
peer я оставлю без перевода и буду писать пир
Общение
Мультимедия
— установить фотографию профиля. Обрезается до квадрата
Групповые чаты
— поставить фото на чат. Обрезается до квадрата
Поиск
Секретный чат
Статистика и информация
Карточки
Остальное
Практика
Напишем сообщение Даниле и посмотрим, что он ответит. Отправить сообщение можно не сразу, сначала нужно дождаться, пока прогрузяться все контакты.
Готово! Вы восхетительны.
В следующей статье мы рассмотрим, как сделать из этого добра systemd демона, чтобы не ждать каждый раз прогрузки контактов.