Telegram Comments
Telegram Comments — это ответы, которые читатели оставляют под публикацией канала через привязанную группу обсуждения, и у каждого есть имя автора, текст, время, число реакций и комментарий, на который он отвечает. Такая ветка показывает, как сообщество восприняло анонс, какие вопросы повторяются и какие ответы собрали больше всего реакций, что помогает анализировать отзывы, распределять обращения в поддержку и изучать сообщества.
Возможности Telegram Comments API
- Комментарии из группы обсужденияПередайте ссылку на публикацию и получите ветку из группы, привязанной к каналу, до 100 комментариев за задачу.
- Ветки ответов через parent_idparent_id содержит комментарий, на который отвечает реплика, поэтому ветки можно восстановить, а post_id вроде tginfo/4455 связывает каждую строку с ее публикацией.
- Реакции на каждый комментарийmetrics.likes_count дает сумму реакций на каждый комментарий и показывает ответы, с которыми сообщество согласно больше всего.
- Прямые ссылки на комментарииurl открывает сам комментарий в виде t.me/channel/post?comment=id, что удобно для модерации и цитирования.
Параметры Telegram Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Одна ссылка на публикацию Telegram, например https://t.me/tginfo/4455. Комментарии берутся из группы обсуждения, привязанной к открытому каналу публикации. |
results_limit | Необязательный | Сколько комментариев собрать. Целое число от 1 до 100, по умолчанию 100. |
Как использовать Telegram Comments API
Отправьте ссылку на публикацию и прочитайте комментарии из ее ветки обсуждения.
- Отправьте {"url": "https://t.me/tginfo/4455", "results_limit": 100} методом POST на /v1/telegram/post-comments.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте комментарии из results.items, а пока has_more равно true, передавайте results.next_cursor, чтобы загрузить следующую страницу.
curl -X POST "https://api.socq.ai/v1/telegram/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/tginfo/4455","results_limit":100}'Сценарии использования Telegram Comments API
- Реакция на анонс: Соберите комментарии под публикацией о запуске или смене правил и сгруппируйте их по темам, чтобы увидеть, как отреагировали читатели.
- Поиск повторяющихся вопросов: Просмотрите текст комментариев к нескольким публикациям, найдите вопросы, которые пользователи задают снова и снова, и ответьте на них в документации или справочном центре.
- Распределение обращений в поддержку: Передавайте в очередь поддержки комментарии под публикациями брендового канала, где упоминаются ошибки, платежи или проблемы с аккаунтом.
- Исследование сообществ: Сравнивайте число комментариев и реакций по публикациям, чтобы понять, какие темы запускают обсуждение в нише.
Практические советы по Telegram Comments API
- Выбирайте каналы с включенными комментариями: комментарии читаются из привязанной к каналу группы обсуждения, а оплата идет только за возвращенные комментарии.
- Привязывайте ответы к родительским комментариям через parent_id, чтобы восстановить ветки, а затем сортируйте по metrics.likes_count, чтобы наверху оказались ответы с наибольшей поддержкой.
Связанные API
Помимо Telegram Comments API, используйте эти API, когда нужен другой тип публичных данных Telegram.
- Telegram Channel Info API — Получайте по ссылкам данные до 50 публичных Telegram-каналов: название, описание, аватар, значок верификации и число подписчиков целым числом.
- Telegram Channel Scraper API — Собирайте до 1 000 публикаций открытого Telegram-канала от новых к старым с текстом, временем, просмотрами, суммой реакций, фото и видео.
- Telegram Post Detail API — Получайте по ссылкам до 50 конкретных публикаций Telegram из любых открытых каналов с полным текстом, временем, просмотрами, реакциями и медиа.
- Telegram Similar Channels API — Находите каналы, которые Telegram рекомендует рядом с открытым каналом, обычно около десяти, с названием, значком верификации и точным числом подписчиков.
- Telegram Channel Search API — Ищите слово или фразу во всей истории открытого Telegram-канала и получайте до 100 совпавших публикаций с текстом, датой, просмотрами и реакциями.