텔레그램 채널·슈퍼그룹·기본 그룹 — API 에서 다른 점

앱에선 '그룹' 하나, API 에선 넷

앱 화면에서는 그룹과 채널 두 가지로 보이지만, API 안쪽에서는 모양이 다른 네 종류로 나뉩니다. 무엇을 다루는지에 따라 부를 메서드와 처리 방법이 달라집니다.

종류	API 에서의 모양	특징
기본 그룹	chat	작은 그룹(최대 200명). 기능이 적고, 메시지 번호와 업데이트 순번을 내 개인 대화들과 같이 쓴다
슈퍼그룹	channel(megagroup 표시)	최대 200,000명. 그룹의 거의 모든 기능 — 주제(포럼)·관리 기록·느린 모드 등
방송 채널	channel(broadcast 표시)	구독자 제한 없음. 게시물마다 조회수, 관리자만 글쓰기
기가그룹	슈퍼그룹을 바꾼 것	인원 제한 없음. 관리자만 쓸 수 있는 채널에 가까운 그룹 — 되돌릴 수 없다

슈퍼그룹과 채널이 둘 다 'channel' 모양인 것이 헷갈리는 지점입니다. 표시(flag)로 구분하고, 둘 다 채널용 메서드(channels.*)와 채널마다 따로인 업데이트 순번을 씁니다(업데이트 처리).

기본 그룹이 슈퍼그룹으로 바뀔 때

• 기본 그룹은 messages.migrateChat 으로 슈퍼그룹이 됩니다(앱에서 관리 기능을 켜거나 인원이 늘 때도 일어난다).
• 바뀌면 새 채널 ID를 받습니다. 옛 그룹 정보에는 옮겨 간 곳(migrated_to)이, 새 슈퍼그룹에는 옮겨 온 곳(migrated_from)이 표시됩니다.
• 내 저장소의 옛 그룹 ID 를 새 ID 로 이어 주고, 옛 메시지 기록은 옛 그룹에서 받습니다. 봇 API 에서 -100 ID 로 바뀌는 것과 같은 일입니다(대화 ID 읽기).

가리키는 법과 권한

할 일	기본 그룹	슈퍼그룹 · 채널
가리키기	ID 만	ID + access_hash(피어와 access_hash)
메시지 기록·참가자	messages.* 메서드	channels.* 메서드
권한	단순한 관리자/일반	관리자 권한 세부 항목 · 사용자별 제한(금지) · 기본 권한

봇이 그룹에서 받는 메시지 범위는 종류와 상관없이 개인정보 모드와 관리자 여부가 정합니다 — 그룹 개인정보 모드.