Integrate Telegram Notifications

개요

파일 전송 작업의 상태 변화를 실시간으로 전달받으려면 Telegram 알림을 연동할 수 있습니다.

연동을 완료하면 전송이 시작(Started), 완료(Completed), 실패(Failed) 되는 등 지정한 이벤트가 발생할 때마다 지정한 Telegram 채널 또는 그룹으로 알림 메시지가 자동으로 전송됩니다.

전체 과정은 ① Bot Token 발급 → ② 대상 Chat ID 확인 → ③ 제품에서 알림 설정 순으로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

Telegram Bot Token 발급

Telegram으로 알림을 받으려면 BotFather를 사용하여 봇을 생성하고 Bot Token을 발급받습니다.

Step 1. BotFather 열기

Telegram에서 @BotFather(공식 인증 계정)를 검색하거나 아래 주소로 접속한 후 Start를 클릭합니다.

Step 2. 봇 생성

/newbot 명령을 입력한 후 봇의 표시 이름(Display Name)과 사용자 이름(Username)을 순서대로 입력합니다.

사용자 이름은 반드시 bot으로 끝나야 합니다.

예:

Step 3. Bot Token 복사

BotFather가 발급한 Bot Token을 복사합니다.

예:

Bot Token은 비밀번호와 같은 정보입니다.

값을 알고 있는 사람은 누구나 해당 봇을 제어할 수 있으므로 공개 저장소, 채팅 또는 스크린샷 등에 노출되지 않도록 주의합니다.

Bot Token이 유출된 경우에는 BotFather에서 새 토큰을 발급(Revoke)합니다.

확인 사항

• ✔ BotFather에서 봇을 생성했습니다.
• ✔ Bot Token을 안전하게 복사하여 보관했습니다.

대상 Chat ID 확인

알림을 받을 대상의 Chat ID를 확인합니다.

봇은 대상 채널 또는 그룹에 추가되어 있어야 메시지를 전송할 수 있습니다.

Step 1. 봇 추가

• 채널(Channel) : 생성한 봇을 관리자(Administrator) 로 추가합니다.
• 그룹(Group) : 생성한 봇을 그룹 멤버로 추가합니다.

Step 2. Chat ID 확인

대상 채널 또는 그룹에 메시지를 하나 보낸 후 아래 주소를 브라우저에서 엽니다.

응답의 chat.id 값이 Chat ID입니다.

채널 및 슈퍼그룹의 Chat ID는 -100으로 시작합니다.

예:

또는 @getidsbot과 같은 Telegram Bot을 사용하여 Chat ID를 확인할 수도 있습니다.

확인 사항

• ✔ 봇이 대상 채널 또는 그룹에 추가되었습니다.
• ✔ Chat ID를 확인했습니다.

Telegram 알림 설정

발급받은 Bot Token과 Chat ID를 제품의 알림 설정에 입력합니다.

Notifications 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Telegram Bot Token 입력

Telegram Bot Token 항목에 복사한 Bot Token을 입력합니다.

Step 2. Chat ID / Channel ID 입력

Chat ID / Channel ID 항목에 확인한 Chat ID를 입력합니다.

Step 3. 알림 이벤트 선택

Events 항목에서 알림을 받을 이벤트를 선택합니다.

여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 메시지가 전송됩니다.

Step 4. 설정 저장

입력을 완료한 후 Add를 클릭하여 연동을 저장합니다.

확인 사항

• ✔ Telegram Bot Token이 입력되었습니다.
• ✔ Chat ID / Channel ID가 입력되었습니다.
• ✔ 알림받을 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트 중 하나를 발생시킵니다.

Step 2. Telegram 채널 또는 그룹 확인

지정한 Telegram 채널 또는 그룹에 알림 메시지가 도착했는지 확인합니다.

확인 사항

• ✔ Telegram 채널 또는 그룹에 알림이 도착했습니다.
• ✔ 발생한 이벤트가 정확하게 전달되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 지정한 Telegram 채널 또는 그룹으로 알림 메시지가 자동으로 전송됩니다.

문제 해결 (Troubleshooting)

메시지가 도착하지 않는 경우 아래 항목을 확인하세요.