텔레그램 알림 드라이버
사용설명서
SmartThings 기기 이벤트를 브리지 서버를 거쳐 텔레그램으로 실시간 전달하는 알림 드라이버 사용 가이드
텔레그램 쪽에서 딱 2가지만 받아오면 됩니다
봇 토큰과 Chat ID는 한 번만 발급받으면 계속 재사용합니다. 순서대로 따라 하세요.
BotFather로 봇 만들기
텔레그램에서 @BotFather 검색 → /newbot 입력 → 봇 이름 설정. 완료되면 나오는 긴 문자열이 Bot 토큰입니다.
내 봇과 대화 시작
만든 봇을 검색해서 들어간 뒤 /start를 누릅니다. 이 과정을 건너뛰면 Chat ID를 받을 수 없습니다.
Chat ID 확인
@userinfobot과 대화를 시작하면 내 Chat ID를 바로 알려줍니다. 그룹 채팅이면 봇을 그룹에 초대한 뒤 확인합니다.
-(마이너스)로 시작하는 숫자로 나옵니다. 개인 채팅은 - 없이 숫자만 있습니다.
기기 설정 화면에서 4가지 항목 입력
SmartThings 앱에서 이 드라이버로 만들어진 기기를 열고, 설정(⚙️)에서 아래 항목을 채웁니다.
| 설정 항목 | 설명 | 예시 |
|---|---|---|
| 브리지 서버 | 집 안에 있는 SmartWeb 서버 주소필수 | http://192.168.219.137:8088 |
| Telegram HTML URL | telegram.html이 올라가 있는 공개 주소필수 | http://192.168.219.137:8090/files/telegram.html |
| Bot 토큰 | BotFather에서 발급받은 토큰 | 123456789:AAxxxxxxxx |
| Chat ID | 메시지를 받을 대상. 개인은 숫자, 그룹은 -로 시작 |
123456789 / -1001234567890 |
메시지 보내기까지 4단계
기기 화면 위에서 아래로 그대로 따라 하면 됩니다.
알림 기기 추가
“텔레그램 알림 기기 추가” 스위치를 껐다가 다시 켜면 새 알림용 자식 기기가 하나 생성됩니다. 용도별로 여러 개 만들어 두면 편리합니다.
메시지 입력
기기 화면의 ✏️ 메시지 입력 링크를 눌러 보낼 문구를 작성합니다.
예: {거실:온도}도예요, 현관문이 열렸어요! ({time})발송
기기 스위치를 ON으로 켜거나, 루틴에서 “메시지 입력” 커맨드를 실행하면 즉시 발송됩니다.
결과 확인
기기 화면 상태가 실시간으로 바뀝니다. 문제가 있으면 원인이 그대로 표시됩니다.
⏳ 처리 중… → ✅ 텔레그램 발송 완료 (또는 ❌ 오류 메시지)메시지 안에 다른 기기의 값 자동으로 넣기
메시지를 작성할 때 아래 문법을 쓰면, 실제 발송되는 순간의 값으로 자동 치환됩니다.
다른 기기의 실시간 상태 값을 가져옵니다.
발송 순간의 현재 시각(한국시간)으로 바뀝니다.
알림 기기는 여러 개 만들어 쓸 수 있습니다
“현관 알림”, “온도 경고”, “택배 도착” 처럼 용도별로 자식 기기를 나눠서 만들면 루틴 구성이 훨씬 깔끔해집니다. 봇 토큰·Chat ID·브리지 서버는 허브 기기 한 곳의 설정만 따라가므로, 자식 기기마다 다시 입력할 필요가 없습니다.
{기기명:속성}으로 불러오려면 새로고침을 먼저 눌러주세요.
자주 나오는 오류 메시지
기기 화면에 뜨는 오류 문구를 눌러서 원인과 해결 방법을 확인하세요.
botToken 미설정 Bot 토큰을 입력하지 않았습니다
기기 설정에서 “Bot 토큰” 항목이 비어 있습니다. BotFather에서 발급받은 토큰을 그대로 붙여넣으세요.
chatId 미설정 Chat ID를 입력하지 않았습니다
@userinfobot으로 확인한 숫자를 정확히 입력했는지 확인하세요. 앞뒤 공백이 없어야 합니다.
bridgeServer 미설정 브리지 서버 주소가 비어 있습니다
집 안 서버(SmartWeb)의 IP 주소와 포트를 정확히 입력했는지 확인하세요. 서버가 꺼져 있지는 않은지도 확인이 필요합니다.
브리지 HTTP 오류 브리지 서버 응답에 문제가 있습니다
브리지 서버가 실행 중인지, 같은 네트워크(같은 공유기)에 연결되어 있는지 확인하세요. 서버 주소나 포트 번호가 바뀌었을 수도 있습니다.
발송 실패 텔레그램 서버가 요청을 거절했습니다
Bot 토큰이 잘못되었거나, 봇과 아직 대화를 시작하지 않았을 가능성이 큽니다. 봇을 검색해서 들어가 /start를 눌렀는지 확인하세요.