Telegram 알림 연동

개요#

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

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

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

준비 사항#

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

Telegram Bot Token 발급#

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

Step 1. BotFather 열기#

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

https://t.me/BotFather

Step 2. 봇 생성#

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

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

예:

INNORIX_bot

Step 3. Bot Token 복사#

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

예:

1234567890:ABCDEF...

ℹ️ Bot Token은 비밀번호와 같은 정보입니다. 값을 알고 있는 사람은 누구나 해당 봇을 제어할 수 있으므로 공개 저장소, 채팅 또는 스크린샷 등에 노출되지 않도록 주의합니다. Bot Token이 유출된 경우에는 BotFather에서 새 토큰을 발급(Revoke)합니다.

확인 사항#

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

대상 Chat ID 확인#

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

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

Step 1. 봇 추가#

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

Step 2. Chat ID 확인#

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

https://api.telegram.org/bot<Bot Token>/getUpdates

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

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

예:

-1001234567890

또는 @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)#

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