Telegram Account Automation API
Автоматизация Телеграм аккаунтов: модуль управления Telegram-группами для CRM/BPM систем
Через предоставляемое нами API с любого аккаунта, подключенного к Hotline.tg, можно программно управлять группами в Telegram или выполнять другие операции, доступные только пользовательским аккаунтам Telegram.
Данная возможность может расширить набор возможностей по связке с Telegram вашей CRM системы не доступными через Telegram Bot API или Premium/Business подписку методами.
Поддерживаемые методы
На данный момент в API доступны следующие методы:
- Создание Telegram групп, получение chat_id
- Переименование Telegram групп по chat_id
- Добавление участников Telegram групп по user_id
- Удаление участников Telegram групп по user_id
- Получение join-link (invite link) для Telegram группы по chat_id
- Удаление Telegram групп по chat_id
- Удаление join-link
- Определение общих групп с пользователем по user_id
Взаимодействие с API ведется в формате JSON через webhook, то есть легко интегрируется с большинством систем.
Документацию по формату взаимодействия запрашивайте в службе поддержки @hotlinetg_support.
Подключение аккаунта
- Управление группами происходит с подключенного к системе Hotline аккаунта Telegram (или вызов других функций аккаунта), он в данном контексте называется Управляющим Аккаунтом.
- Управляющий Аккаунт должен быть обычным пользовательским аккаунтом (зарегистрированный на мобильный номер телефона)
- Подключения подписки Telegram-Premium и/или Telegram-Business к Управляющему Аккаунту не требуется
- Подключение Управляющего Аккаунта к системе Hotline происходит через установочного бота @hotlinetg_bot
- Работать с @hotlinetg_bot можно как с личного, так и с подключаемого Управляющего Аккаунта. Дальнейшее администрирование подключения происходит также через бота @hotlinetg_bot.
- В процессе подключения бот присылает QR-код, который необходимо отсканировать через мобильное приложение Telegram, в котором должен быть активен подключаемый Управляющий Аккаунт. На мобильном устройстве с приложением Telegram должна быть камера.
- Сканирование кода делается из раздела: Меню / Настройки / Устройства / Подключение нового Desktop-устройства
- После сканирования кода необходимо будет также выбрать топик-группу (существующую или создать новую) для работы через Hotline (ведения диалогов от имени подключенного аккаунта, мониторинга групп и др).
- После успешного подключения Управляющего Аккаунта, в @hotlinetg_bot необходимо перейти к свойствам нового подключения. Там узнается номер инстанса (подключения) и ключ для API (подтверждающий передачу прав на автоматическое управление данным Telegram аккаунтом).
- Если другие функции системы Hotline, кроме API, не нужны, инстанс можно остановить, нажав на кнопку Stop Instance в свойствах подключения (тогда указанная ранее топик-группа будет использоваться только для отправки технических уведомлений при необходимости).
Вся процедура подключения аккаунта к системе Hotline.tg показана в видео с нашего YouTube канала:
Применения связки с API Hotline.tg
- Управления Telegram группами и их участниками для CRM и/или BPM систем
- Создание групп с представителями клиента, добавление в них аккаунта, подключенного к Hotline (например, для трансляции сообщений из групп команде технической поддержки на стороне топик-группы)
- Автоматическое добавление в созданные группы нужного списка участников/пользователей Telegram, в том числе ботов (например, ai-консультантов или интеграций с внешними системами)
- Получение join-link для вступления в группу (например, из личного кабинета пользователя)
Получение доступа к API
Для получения доступа к API, документации по предоставляемым методам, расчета стоимости интеграции и поддержки, необходимо написать в службу поддержки @hotlinetg_support и рассказать о своей задаче.