Telegram Bot API

텔레그램 chat id 찾기

이 텔레그램 chat id 확인 도구는 봇이 최근 업데이트를 받은 모든 개인 채팅, 그룹, 슈퍼그룹, 채널, 포럼 토픽의 chat_id를 보여 줍니다. 봇 토큰을 붙여넣고, 봇에게 메시지를 보낸 뒤 버튼 하나만 누르면 됩니다.

토큰은 브라우저(localStorage)에만 저장되며 api.telegram.org로만 전송됩니다.

봇에게 아무 메시지나 보내거나(또는 봇을 그룹이나 채널에 추가하고 그곳에 글을 올린 뒤) 버튼을 누르십시오.

업데이트를 offset 없이 읽으므로 확인 처리되지 않고, 봇은 여전히 이 업데이트를 받습니다.

텔레그램 chat id 확인 방법

  1. 봇 토큰을 붙여넣으십시오(토큰 찾는 법: /ko/guides/telegram-bot-token.html). 봇이 테스트 환경에 있을 때만 테스트 서버에 체크하십시오.
  2. 개인 채팅에서 봇에게 아무 메시지나 보내십시오. 그룹이라면 봇을 추가하고 /start@your_bot을 보내십시오. 프라이버시 모드가 켜져 있으면 봇은 자신을 지목한 명령어만 봅니다. 채널이라면 봇을 관리자로 추가하고 게시물을 올리십시오.
  3. chat ID 찾기를 누르십시오. 표에 각 채팅의 이름, 유형, chat_id, 그리고 포럼 토픽이라면 message_thread_id가 표시됩니다. ID 옆의 복사를 쓰십시오.
  4. 공개 채널이나 슈퍼그룹이라면 업데이트 없이 조회 입력란에 @username을 입력해도 됩니다.

내부 동작 방식

도구는 먼저 getMe를 호출해 토큰을 확인하고 어떤 봇을 쓰고 있는지 보여 줍니다. 그다음 limit 100, timeout 0으로, 그리고 offset 없이 getUpdates를 호출합니다. offset이 없으면 텔레그램은 업데이트를 확인 처리하지 않으므로 봇(또는 다음 도구 실행)은 여전히 업데이트를 받습니다.

채팅은 메시지와 수정된 메시지, 채널 게시물, 비즈니스 메시지, 콜백 쿼리, my_chat_member와 chat_member 변경, 가입 요청, 반응, 부스트에서 수집됩니다. 그래서 봇을 그룹이나 채널에 추가하기만 해도 채팅이 나타나는 경우가 많습니다.

@username 조회는 getChat을 호출합니다. Bot API는 공개 슈퍼그룹과 채널에 대해서만 username을 받으며, 사용자는 username으로 조회할 수 없습니다.

채팅이 나타나지 않을 때

개인정보 보호

토큰은 브라우저의 localStorage에만 저장되며, 요청은 브라우저에서 api.telegram.org로 바로 전송됩니다. 저희 서버를 거치는 것은 없습니다. 같은 호출을 /ko/telegram-bot-api-tester.html#getUpdates에서 직접 반복해 볼 수 있습니다. 채팅 유형별 자세한 내용은 /ko/guides/telegram-chat-id.html를, 찾은 ID로 첫 메시지를 보내는 방법은 /ko/guides/telegram-bot-send-message.html를 참고하십시오.

자주 묻는 질문

내 텔레그램 chat id는 어떻게 찾나요?

봇에게 아무 메시지나 보내고, 위 도구에 봇 토큰을 붙여넣은 뒤 chat ID 찾기를 누르십시오. 표에 chat_id가 표시되며, 봇과의 개인 채팅이라면 그 값이 당신의 사용자 ID와 같습니다.

도구가 채팅을 하나도 찾지 못하는 이유는 무엇인가요?

확인되지 않은 업데이트가 없기 때문입니다. 지난 24시간 동안 아무도 봇에게 메시지를 보내지 않았거나, 실행 중인 봇이 이미 offset으로 확인 처리했습니다. 웹훅이 설정되어 있으면 getUpdates가 409 Conflict를 반환하며, 도구가 웹훅 삭제를 제안합니다.

이 도구가 봇의 업데이트를 가져가 버리지는 않나요?

아닙니다. getUpdates를 offset 없이 호출하므로 텔레그램은 업데이트를 확인 처리하지 않고, 봇은 여전히 업데이트를 받습니다.

그룹이나 채널 ID가 -100으로 시작하는 이유는 무엇인가요?

슈퍼그룹과 채널의 ID는 -1001234567890 형태이고, 일반 그룹은 음수, 사용자는 양수입니다. 마이너스 기호와 -100을 포함한 전체 숫자를 항상 그대로 전달하십시오.

여기에 봇 토큰을 붙여넣어도 안전한가요?

토큰은 브라우저의 localStorage에만 저장되며 api.telegram.org로만 전송되고 저희 서버로는 전송되지 않습니다. 토큰이 유출되었다면 @BotFather에서 /revoke로 폐기하십시오.

다른 유틸리티

MarkdownV2·HTML 이스케이프 도구Mini App initData 검증 도구웹훅 확인 도구Bot API Tester