TGStat

Приложение TGStat подключает API каталога и аналитики публичных Telegram-каналов. Агент может искать каналы и публикации, анализировать подписчиков, просмотры, вовлечённость, упоминания, пересылки и истории.

Подключение

1. Войдите в TGStat API.
2. Скопируйте токен доступа.
3. В Promto откройте приложение TGStat и нажмите Подключить.
4. Вставьте токен и дождитесь проверки квоты.

Токен не требует регулярного обновления сам по себе, но может быть отозван в кабинете. Подключать и отключать интеграцию может только владелец рабочего пространства. Токен хранится на сервере и не передаётся агенту.

Интерфейс приложения

На главном экране доступны сценарии:

Сценарий	Что делает
Профиль канала	Карточка и основные показатели канала
Упоминания бренда	Поиск публикаций и разбивка упоминаний
Поиск каналов	Подбор публичных каналов по запросу и категории
Подключение	Ввод API-токена

В Настройках показываются маска токена, тариф, счётчики квоты, возможный срок тарифа, состояние подключения и действие отключения.

Работа с агентом

Основной агент использует инструмент promto_tgstat. Это встроенный инструмент чата, а не команда терминала.

Область	Действия инструмента
Канал	get_channel, get_channel_stat
Контент канала	list_channel_posts, list_channel_mentions, list_channel_forwards, list_stories
Динамика	get_channel_subscribers, get_channel_views, get_channel_er
Поиск	search_channels, get_post, get_post_stat, search_posts
Аналитика упоминаний	mentions_by_period, mentions_by_channels
Квота и справочники	get_usage, list_categories
Добавление в индекс	add_channel
Дополнительный метод API	request

get_usage не расходует квоту, поэтому агент должен начинать с него перед широким исследованием.

Практические сценарии

Профиль публичного канала

Передайте @username или ссылку. Агент получит карточку, статистику, динамику подписчиков, просмотров и ER за одинаковый период.

Найти упоминания бренда

Укажите точную поисковую формулировку, исключения и период. Агент найдёт посты и покажет разбивку по времени и каналам, сохранив ссылки на исходные публикации.

Подобрать каналы

Агент ищет по названию, описанию или категории. search_channels возвращает только первые 100 результатов и не поддерживает пагинацию: уточняйте запрос, язык или категорию вместо обещания полной выгрузки.

Добавить канал в индекс

Если публичного канала нет в базе, add_channel отправляет заявку на добавление. Это единственное изменяющее действие и требует вашего подтверждения. Появление данных может занять время.

Ограничения и безопасность

• Закрытые и личные чаты недоступны. Новый публичный канал может появиться в индексе с задержкой.
• Пустой результат означает отсутствие данных в индексе TGStat, а не доказанное отсутствие публикаций в Telegram.
• На бесплатном тарифе доступны только подтверждённые владельцем каналы; для чужого канала возможна ошибка quota_foreign_channel.
• search_channels ограничен первыми 100 результатами без следующей страницы. Остальные списки используют limit и offset.
• Инструмент не публикует посты и не отправляет сообщения.
• add_channel требует params.confirm=true после явного согласия.
• Не передавайте токен в чат, файлы или параметры request.

Если не работает

Симптом	Что проверить
quota_foreign_channel	Тариф API и подтверждение владения каналом в TGStat
Канал не найден	Публичность, точный @username и наличие в индексе; при необходимости согласовать add_channel
Ровно 100 результатов поиска	Уточнить запрос или категорию; пагинации у search_channels нет
Квота закончилась	Вызвать get_usage, сократить период и число каналов
Нет постов закрытого канала	Закрытые каналы индексом не читаются
Данные отличаются от Telegram	Указать время обновления и задержку индекса TGStat

Связанные материалы

• Telegram
• Настройки рабочего пространства
• Как получать лучший результат

Готовый промпт

Через promto_tgstat сначала вызови get_usage. Затем найди публичные упоминания <БРЕНД> за <ПЕРИОД>, покажи динамику, основные каналы и ссылки на исходные посты. Не добавляй каналы в индекс без моего подтверждения. Пустой ответ называй отсутствием данных в индексе, а не отсутствием упоминаний в Telegram.