Практика работы с Telegram

Telegram API, Bot API, Telethon и REST Telecobra

Материал Telecobra · Редакционная проверка текста: 8 октября 2026 · Как проверяем материалы

Как выбрать интерфейс для автоматизации и не перепутать API-ключ, токен бота и данные Telegram-приложения.

Первоначальная инструкция: сентябрь 2026. Даты снимков и отдельных проверок указаны в материале.

Четыре разных способа работы#

Инструмент	Задача	Доступ
Bot API	Команды и сообщения своего бота	Токен бота и доступные ему события
Telegram API / MTProto	Собственный клиент пользовательского аккаунта	API ID, API Hash и авторизация
TDLib	Разработка клиента с библиотекой Telegram	Интеграция библиотеки и её модель данных
REST API Telecobra	Управление ресурсами своего кабинета	Ключ Telecobra в X-API-Key или Bearer

Выбирайте по ожидаемому действию. Если задача уже реализована в Telecobra, REST-интеграция позволяет работать с её ID и статусом. Если вы пишете отдельный Telegram-клиент, нужен другой уровень доступа.

Telethon и Pyrogram#

Telethon — Python-библиотека для Telegram API. Она управляет соединением, авторизацией и вызовами клиента. Пример работы с сообщениями приведён в практической инструкции. Pyrogram также относится к библиотекам Python, но его документация предупреждает, что проект больше не поддерживается. Проверяйте состояние проекта и совместимость до выбора для нового решения.

Форматы сессий разных библиотек не становятся совместимыми из-за одинакового расширения файла. Для интеграции храните название библиотеки и версию рядом с резервной копией. Не передавайте сторонним разработчикам действующую сессию для обычного обсуждения архитектуры.

Где получить правильные ключи#

Для своего Telegram-приложения API ID и API Hash получают через API development tools на my.telegram.org. Это не «ключ Android» или «ключ Telegram X», который нужно копировать у другого клиента. Для бота используется отдельный токен. Ключ маркетплейса относится только к этому маркетплейсу и не авторизует запросы Telecobra.

У Telecobra собственный REST-ключ. Передайте его заголовком, а не параметром URL. Начните с чтения списка своих ресурсов, затем проверьте права и только после этого подключайте команды изменения.

Управление аккаунтами через REST#

GET /api/accounts?folder_id=FOLDER_ID
GET /api/accounts/ACCOUNT_ID
GET /api/accounts/ACCOUNT_ID/subscriptions
GET /api/accounts/ACCOUNT_ID/export?format=json

Это шаблоны адресов: значения FOLDER_ID и ACCOUNT_ID нужно заменить внутренними идентификаторами Telecobra. В текущем списке аккаунтов ответ ограничен 200 записями. Для большой базы не считайте один ответ полной инвентаризацией: организуйте папки и сверяйте ожидаемое число записей.

Импорт, изменение профиля и удаление — отдельные операции. Автоматизация должна хранить соответствие внутреннего ID, проекта и назначения аккаунта. Поиск по одному номеру без проверки владельца и состояния задачи недостаточен.

CRM, webhooks и ИИ-агент#

Создайте в своей интеграции связь ID задачи Telecobra с записью CRM.
Периодически читайте статус и сохраняйте последний подтверждённый результат.
Добавляйте событие в CRM один раз по устойчивому идентификатору; повторное чтение того же статуса не должно создавать вторую заявку.
Команды запуска отделите от чтения отчёта и согласуйте их разрешённый объём.
Секреты храните в настройках интеграции, а ИИ передавайте только необходимые поля результата.

Webhook — доставка события на ваш адрес, опрос — регулярное чтение статуса. Наличие webhook у Telegram-бота не означает такой же webhook для любой задачи Telecobra. Практическая схема HTTP-интеграции описана в руководстве n8n и Make.

Источники и документация#

Одна платформа · разные задачи

Подписка Telecobra

Соберите инструменты для работы с Telegram в одном кабинете. Сроки доступа, цены и условия — на странице подписки.

В этой инструкции описана только часть возможностей платформы. Полный список доступен в разделе функций.

Подписка и цены →Все функции