Telegram Bot¶
Bot은 Telegram 애플리케이션 내에서 실행되는 소형 애플리케이션입니다. 사용자는 유연한 인터페이스를 통해 Bot과 상호작용하며, 모든 유형의 작업이나 서비스를 지원할 수 있습니다. 이 문서에서는 Guance에서 Telegram Bot 알림 대상을 생성하여 알림 메시지를 Telegram 개인 채팅, 그룹 또는 채널로 직접 푸시하는 방법을 설명합니다.
Bot에 대한 자세한 정보를 확인하세요.
참고
이 알림 대상은 국제판 청구 센터 계정이 바인딩된 국제 사이트 워크스페이스에만 적용됩니다.
구성 전 준비¶
Guance에서 구성하기 전에 Telegram에서 다음 준비 작업을 완료해야 합니다.
1단계: Bot 생성 및 Token 획득¶
- Telegram에서 @BotFather를 검색하여 실행합니다.
/newbot명령어를 전송하여 새 Bot을 생성합니다.- 안내에 따라 Bot 이름과 사용자 이름을 설정합니다. (사용자 이름은
bot으로 끝나야 합니다.) - 생성이 완료되면 반환된 Bot Token을 안전하게 보관합니다. (형식 예:
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
참고
Bot Token은 Telegram API 호출을 위한 자격 증명이므로 안전하게 보관하고 유출되지 않도록 주의하세요.
2단계: Chat ID 획득¶
Bot을 대상 그룹에 추가하거나 개인 채팅을 생성한 후, 채팅에서 @userinfobot 메시지를 전송하고 링크를 클릭하여 Chat ID를 획득합니다.
Chat ID는 다음 형식을 지원합니다.
| 수신 시나리오 | Chat ID 형식 | 예시 |
|---|---|---|
| 개인 채팅 | 사용자 ID (숫자만) | 123456789 |
| 그룹 | 그룹 ID (음수) | -1001234567890 |
| 채널 | 채널 사용자 이름 | @my_channel |
3단계: Topic ID 획득 (선택 사항)¶
포럼 슈퍼그룹(Forum Supergroup)을 대상으로 하며, 특정 주제(Topic)로 전송해야 하는 경우에만 필요합니다.
- 대상 주제에서 메시지를 하나 전송합니다.
https://api.telegram.org/bot<YourBOTToken>/getUpdates에 접속합니다.- 반환된 데이터에서
message_thread_id필드 값을 찾습니다.
Telegram Bot 구성 페이지로 돌아가기¶
- 현재 알림 대상의 이름을 정의합니다. (알림 대상 목록에서 식별하기 위해 사용)
- @BotFather에서 획득한 Bot Token을 입력합니다.
- Chat ID를 입력합니다.
- 포럼 그룹으로 전송해야 하는 경우 Message Thread ID를 입력합니다.
- 필요에 따라 알림이 전송되었는지 테스트합니다. (❗️시스템이 테스트 메시지를 전송합니다. 해당 알림 대상 내에서 테스트 메시지가 성공적으로 전송되었는지 확인하세요.)
- 작업 권한을 구성합니다.
- 확인합니다.