Практика работы с Telegram
Telegram API, Bot API, Telethon и REST Telecobra
Как выбрать интерфейс для автоматизации и не перепутать API-ключ, токен бота и данные Telegram-приложения.
Четыре разных способа работы
| Инструмент | Задача | Доступ |
|---|---|---|
| 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 в одном кабинете. Сроки доступа, цены и условия — на странице подписки.
В этой инструкции описана только часть возможностей платформы. Полный список доступен в разделе функций.