Telegram Comments
Telegram Comments는 독자가 채널에 연결된 토론 그룹을 통해 게시물 아래 남기는 답글로, 각각 작성자 이름, 본문, 시각, 반응 수, 답하는 대상 댓글을 가집니다. 이 스레드를 읽으면 공지가 커뮤니티에서 어떻게 받아들여졌는지, 어떤 질문이 반복되는지, 어떤 답글이 가장 많은 반응을 얻었는지 알 수 있어 피드백 분석, 고객 지원 분류, 커뮤니티 조사에 도움이 됩니다.
Telegram Comments API 주요 기능
- 토론 그룹의 댓글게시물 링크 하나를 넘기면 그 채널에 연결된 그룹의 스레드를 작업당 최대 100개까지 가져옵니다.
- parent_id로 답글 스레드 재구성parent_id에는 답글이 향하는 댓글이 들어 있어 스레드를 다시 만들 수 있고, tginfo/4455 같은 post_id가 모든 행을 게시물에 연결합니다.
- 댓글별 반응 수metrics.likes_count는 댓글마다 반응 합계를 알려 주어 커뮤니티가 가장 공감한 답글을 찾을 수 있습니다.
- 댓글 바로가기 링크url은 t.me/channel/post?comment=id 형식으로 해당 댓글을 바로 열어 주므로 검토나 인용에 바로 쓸 수 있습니다.
Telegram Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 텔레그램 게시물 링크 하나입니다. 예: https://t.me/tginfo/4455. 댓글은 게시물이 속한 공개 채널에 연결된 토론 그룹에서 가져옵니다. |
results_limit | 선택 | 수집할 댓글 수입니다. 1~100 사이의 정수, 기본값은 100입니다. |
Telegram Comments API 사용 방법
게시물 링크 하나를 보내고 토론 스레드의 댓글을 읽습니다.
- {"url": "https://t.me/tginfo/4455", "results_limit": 100}을 /v1/telegram/post-comments로 POST합니다.
- 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 외에 Telegram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Telegram Channel Info API — 링크로 공개 텔레그램 채널을 최대 50개까지 조회해 제목, 설명, 프로필 이미지, 인증 배지, 정수로 변환된 구독자 수를 가져옵니다.
- Telegram Channel Scraper API — 공개 텔레그램 채널의 게시물을 최신순으로 최대 1000개 수집하며 본문, 게시 시각, 조회수, 반응 합계, 사진과 동영상을 포함합니다.
- Telegram Post Detail API — 링크로 특정 텔레그램 게시물을 최대 50개 가져오며, 여러 공개 채널을 섞을 수 있고 전체 본문, 게시 시각, 조회수, 반응, 미디어를 포함합니다.
- Telegram Similar Channels API — 공개 채널 옆에 텔레그램이 추천하는 채널을 보통 10개 안팎으로 찾아 제목, 인증 배지, 정확한 구독자 수를 가져옵니다.
- Telegram Channel Search API — 공개 텔레그램 채널의 전체 게시물 기록에서 단어나 문구를 검색해 일치하는 게시물을 최대 100개, 본문, 날짜, 조회수, 반응과 함께 가져옵니다.