텔레그램 봇 알림 vs 개발자 알림용 푸시 알림 API

스크립트에서 알림을 받는 방법을 개발자들에게 물어보면 절반은 "텔레그램 봇이요"라고 답할 겁니다. 무료이고, 텔레그램은 이미 휴대폰에 깔려 있고, 첫 메시지까지 10분이면 연결할 수 있으니까요.
하지만 이건 채팅 앱이 호출기 역할을 하는 셈입니다. 중요한 알림이 단체 채팅과 같은 흐름에 섞여 들어오거나, 밑줄이 들어간 파일 이름 때문에 메시지가 깨지기 전까지는 잘 돌아갑니다. 이 글에서는 텔레그램 설정을 있는 그대로 살펴보고, 어디까지 잘 되고 어디서 안 되는지, 같은 알림을 푸시 알림 API로 보내면 어떻게 달라지는지 정리합니다.
텔레그램 설정, 처음부터 끝까지
- 봇 만들기.
@BotFather에게 메시지를 보내고/newbot을 입력한 뒤, 이름과bot으로 끝나는 사용자 이름을 정합니다.110201543:AAH...같은 토큰을 받게 됩니다. - 먼저 인사하기. 봇은 먼저 대화를 시작할 수 없으니, 봇을 열고 아무 메시지나 보내세요. 그룹에서 쓰려면 봇을 그룹에 추가하면 됩니다.
- 채팅 ID 찾기.
getUpdates를 호출하고 결과에서message.chat.id값을 읽습니다:
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'
업데이트는 24시간 동안만 보관되고, 봇에 웹훅을 설정하면 getUpdates는 동작하지 않습니다. 그룹 ID는 음수이고, 슈퍼그룹 ID는 -100으로 시작합니다.
- 알림 보내기:
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
-d chat_id="$TG_CHAT_ID" \
-d text="Backup failed on db-01"
연동은 여기까지입니다. 환경 변수 파일에 비밀 값 두 개를 넣고, HTTP 호출 한 번이면 됩니다.
텔레그램이 잘 맞는 경우
- 비용이 들지 않습니다. 텔레그램 공식 FAQ에 따르면 봇은 사용자에게 비용 없이 메시지를 보낼 수 있습니다.
- 어디서든 볼 수 있습니다. 휴대폰, 데스크톱, 웹 클라이언트가 모두 동기화됩니다.
- 그룹도 무료입니다. 팀 채팅방에 봇을 추가하면 모두가 알림을 보고 같은 스레드에서 바로 이야기할 수 있습니다.
- 이미 열려 있는 앱입니다. 새 앱이나 새 계정이 필요 없습니다.
"야간 리포트가 준비됐습니다"처럼 중요도가 낮은 알림이라면 이보다 좋은 방법을 찾기 어렵습니다.
불편한 부분
모든 알림이 똑같이 울립니다
Bot API에는 전달 제어 수단이 딱 하나, disable_notification뿐입니다. 이 옵션은 소리 없이 메시지를 보내는 기능입니다. 우선순위도, 시간 민감 수준도 없고, 방해 금지 모드를 뚫고 들어오는 것도 없습니다. 새벽 3시에 실패한 백업 알림은 그룹 채팅의 스티커와 똑같이 도착합니다. 소음을 피하려고 채팅방을 음소거하면, 알림도 함께 음소거됩니다.
서식 때문에 자주 문제가 생깁니다
parse_mode=MarkdownV2를 쓰면 _ * [ ] ( ) ~ > # + - = | { } . ! 문자와 백틱은 서식 밖에서 모두 백슬래시로 이스케이프해야 합니다. 그런데 알림에는 바로 이런 문자가 가득합니다. 파일 이름, 버전 번호, URL, 스택 트레이스가 그렇죠. db-01.internal의 점 하나를 이스케이프하지 않으면 텔레그램은 400 오류로 메시지를 거부하고, 실패를 알리는 메시지마저 실패합니다. HTML 모드가 더 안전하지만, 보내는 모든 내용에서 <, >, &는 여전히 이스케이프해야 합니다.
토큰이 곧 봇입니다
토큰은 모든 요청의 URL 경로에 들어가고, 텔레그램 문서에도 분명히 적혀 있듯이 이 토큰을 가진 누구든 봇을 조작할 수 있습니다. 실제로는 이 URL이 셸 히스토리, CI 로그, 요청 URL이 기록되는 여러 곳에 남습니다. 토큰이 유출되면 BotFather에서 /token으로 새 토큰을 발급받아야 하고, 그러면 모든 스크립트를 업데이트해야 합니다.
버튼에는 실행 중인 봇이 필요합니다
인라인 버튼으로 URL을 여는 것은 괜찮습니다. 하지만 "서비스 재시작" 같은 동작을 하는 버튼은 callback_data를 사용하고, 봇이 응답할 때까지 누른 쪽에는 로딩 표시가 돕니다. 즉, 업데이트를 24시간 내내 기다리는 프로세스가 필요하다는 뜻인데, 크론 작업이 떠안기엔 부담이 큽니다.
알림이 몰리면 호출 제한에 걸립니다
텔레그램은 봇이 채팅방당 초당 한 개, 그룹에서는 분당 20개 이하의 메시지만 보내도록 권장합니다. 메시지가 많은 웹훅을 그룹에 연결하면, 문제가 생겨 알림이 가장 빠르게 쏟아지는 순간에 429 Too Many Requests와 retry_after 값이 돌아옵니다.
서비스가 직접 보낼 수 없습니다
GitHub, Stripe, Grafana, Sentry는 각자의 JSON 형식으로 웹훅을 보냅니다. 반면 Bot API는 chat_id와 text를 원합니다. 그 사이에서 변환해 줄 중간 계층이 필요합니다. 작은 서버, 서버리스 함수, 또는 n8n이나 Zapier 흐름이 그 역할을 해야 하고, 이 중계 장치도 계속 운영해야 할 대상이 하나 더 늘어나는 셈입니다.
알림이 메신저 안에 쌓입니다
봇 메시지는 일반 텔레그램 채팅 메시지로 저장되며, 개인 채팅과 뒤섞입니다. 지난달 장애를 찾아보려면 채팅을 스크롤해야 하고, 출처별로 기록을 걸러 볼 수는 없습니다.
같은 알림을 푸시 알림 API로 보내면
백업 실패 알림을 우선순위와 작업 로그를 여는 버튼과 함께 Pocket Alert로 보내는 예시입니다:
curl -X POST https://api.pocketalert.app/v1/messages \
-H "Token: $PA_KEY" \
-H 'Content-Type: application/json' \
-d '{
"title": "Backup failed",
"message": "db-01.internal: pg_dump exited with code 1",
"level": "high",
"actions": [{ "type": "view", "label": "Open log", "value": "https://ci.example.com/jobs/4821" }]
}'
달라지는 점은 다음과 같습니다:
- 비밀 값 하나, 헤더에 담기. URL에 토큰을 넣고 채팅 ID를 따로 관리하는 대신,
Token헤더에 API 키를 넣습니다. - 입력도 출력도 일반 텍스트. 이스케이프 규칙이 없습니다. 점, 밑줄, 괄호는 그대로 전달됩니다.
- 메시지마다 우선순위 지정.
silent,low,default,high,critical중에서 고를 수 있습니다. iPhone에서는 high와 critical이 집중 모드를 통과하는 시간 민감 알림으로 도착하고, 안드로이드에서는 critical 알림이 방해 금지 모드를 무시합니다. 자세한 내용은 중요 알림을 참고하세요. - 봇 없이 버튼 사용. 액션 버튼을 최대 세 개까지 넣을 수 있습니다. URL 열기, HTTP 엔드포인트 호출, 값 복사 중에서 고르면 됩니다. 버튼 입력을 기다리는 프로세스가 필요 없습니다.
- 서비스가 직접 전송. 각 웹훅마다 고유 URL이 있습니다. GitHub나 Grafana가 보내는 JSON을 그대로 받고,
%alerts.0.labels.alertname%같은 플레이스홀더로 필드를 알림에 넣을 수 있습니다. 모든 호출은 웹훅 기록에 남습니다. - 별도의 기록 보관. 알림은 채팅과 분리된 앱과 대시보드에 보관되고, 애플리케이션 단위로 묶여 보입니다.
그래도 텔레그램이 더 나은 경우
공정하게 말하면 이렇습니다:
- 예산이 빠듯한 대량 알림. 텔레그램은 호출 제한 외에 일일 한도 없이 무료입니다. Pocket Alert의 무료 플랜은 하루 50건이고, 그 이상은 월 6달러부터 시작하는 유료 플랜이 필요합니다.
- 대화를 시작시키는 알림. 팀이 알림이 도착한 자리에서 바로 이야기를 나누는 것이 목적이라면 그룹 채팅이 적합하고, 푸시 알림은 그 역할을 하지 못합니다.
- 데스크톱과 웹 중심 작업. 노트북에서 주로 일한다면, 텔레그램 데스크톱 클라이언트가 이미 보고 있는 곳에 알림을 띄워 줍니다. Pocket Alert 앱은 iPhone과 안드로이드용이고, 기록은 웹 대시보드에서 봅니다.
많은 팀이 잘 쓰는 조합은 이렇습니다. 잡담과 일일 요약은 텔레그램 그룹에 두고, 누군가를 깨워야 하는 알림은 레벨을 지정한 푸시 알림으로 보내는 방식입니다.
FAQ
텔레그램 봇 메시지가 방해 금지 모드를 우회할 수 있나요?
봇 쪽에서는 불가능합니다. Bot API에는 우선순위 설정이 없고, 메시지를 무음으로 만드는 disable_notification만 있습니다. iPhone의 집중 모드를 통과하는 유일한 방법은 수신자가 텔레그램을 앱 예외로 허용하는 것인데, 이 경우 알림만이 아니라 모든 텔레그램 알림이 통과하게 됩니다.
텔레그램 채팅 ID는 어떻게 찾나요?
봇에 아무 메시지나 보낸 뒤 https://api.telegram.org/bot<token>/getUpdates를 호출하고 message.chat.id를 읽으면 됩니다. 결과가 비어 있다면 업데이트가 24시간보다 오래되었거나, 봇에 웹훅이 설정되어 있는 것일 수 있습니다. 웹훅이 설정되어 있으면 getUpdates는 동작하지 않습니다.
텔레그램 알림이 400 오류로 실패하는 이유는 무엇인가요?
대부분 MarkdownV2나 HTML 모드에서 이스케이프되지 않은 문자 때문입니다. parse_mode를 빼고 일반 텍스트로 보내거나, 보내기 전에 예약 문자를 모두 이스케이프하세요.
푸시 알림 API가 텔레그램 봇보다 설정하기 어렵나요?
거의 비슷합니다. Pocket Alert를 쓰면 앱을 설치하고, 대시보드에서 API 키를 복사한 뒤, POST 요청 한 번만 보내면 됩니다. 찾아볼 채팅 ID도, 만들 봇도 없습니다.
두 곳에 모두 보낼 수 있나요?
네, 가능합니다. 많은 팀이 토론은 텔레그램에서 하고, 응답이 필요한 알림은 푸시 알림으로 보냅니다. 스크립트에서 두 API를 모두 호출할 수 있고, 웹훅을 보내는 대부분의 서비스는 URL을 여러 개 등록하는 것도 지원합니다.
무료 Pocket Alert 계정 만들기를 하고 위의 curl 명령을 실행해 보거나, 먼저 푸시 알림 API란 무엇인지를 읽어 보세요. 다른 선택지를 고민 중이라면 비교 허브에서 Pushover, ntfy, Bark, Gotify 등을 확인할 수 있습니다.