Telegram 봇을 연동하여 규칙 트리거 시 알림을 받을 수 있습니다.
Telegram 기능은 외부 인터넷 연결이 필요합니다. 폐쇄망 환경에서는 사용할 수 없습니다.
Telegram 봇 생성 (BotFather)
IOTOWN에 봇을 등록하기 전에 먼저 Telegram에서 봇을 생성해야 합니다.
1. BotFather 찾기
Telegram 앱에서 @BotFather를 검색하여 대화를 시작합니다.
2. 새 봇 생성
BotFather와 대화에서 /newbot 명령을 입력합니다.
/newbot명령 입력- 봇 이름 입력 (예: 마이테스트봇)
- 봇 username 입력 (예: iotownTest99Bot)
- HTTP API 토큰을 복사하여 보관합니다
토큰은 1234567890:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 형태입니다.
이 토큰을 안전하게 보관하세요. 누구든지 이 토큰으로 봇을 제어할 수 있습니다.
IOTOWN에 봇 등록
Telegram 봇 관리 페이지
파이프라인 > 액션 > 서비스 연동 설정 > Telegram 봇 관리로 이동합니다.
봇 추가
봇 추가 버튼을 클릭하여 새 봇을 등록합니다.
| 항목 | 설명 |
|---|---|
| 그룹 | 봇이 속할 그룹 선택 |
| 봇 이름 | IOTOWN에서 사용할 봇 이름 (예: 공장 알림봇) |
| 봇 토큰 | BotFather에서 발급받은 HTTP API 토큰 |
알림 구독하기
봇을 등록하면 인증 코드가 생성됩니다. Telegram 사용자는 이 코드로 알림을 구독할 수 있습니다.
인증 코드 확인
인증 코드는 Telegram 봇 관리 페이지에서 등록된 봇 카드에 표시됩니다.
봇과 대화하기
- Telegram에서 등록한 봇을 검색합니다 (예: @iotown_test_bot)
/start를 입력하여 대화를 시작합니다/verify 인증코드형식으로 인증 코드를 입력합니다 (예:/verify 328812)- "알림 구독이 완료되었습니다" 메시지가 표시되면 성공입니다
구독자 확인
구독자 목록 버튼을 클릭하여 현재 구독자를 확인할 수 있습니다.
- 개인 사용자 또는 그룹 채팅방이 구독자로 등록될 수 있습니다
- 구독자를 삭제하려면 휴지통 아이콘을 클릭합니다
Telegram 액션 생성
봇이 등록되면 Telegram 타입의 액션을 생성할 수 있습니다.
- 파이프라인 > 액션 > 액션 생성 클릭
- 액션 타입에서 Telegram 선택
- 설정 탭에서 사용할 봇 선택
- 페이로드 템플릿 탭에서 메시지 템플릿 작성 (선택)
- 생성 클릭
메시지 템플릿 예시
JSON
규칙에 액션 연결
생성한 Telegram 액션을 규칙에 연결합니다.
- 파이프라인 > 규칙 > 규칙 선택 또는 새 규칙 생성
- 액션 단계에서 Telegram 액션 선택
- 저장
이제 규칙 조건이 충족되면 구독자에게 Telegram 메시지가 전송됩니다.
문제 해결
봇이 응답하지 않음
- 봇 토큰이 정확한지 확인하세요
- IOTOWN 서버가 인터넷에 연결되어 있는지 확인하세요
- Telegram API 서버 (api.telegram.org)에 접근 가능한지 확인하세요
인증 코드를 입력해도 구독되지 않음
- 올바른 봇과 대화하고 있는지 확인하세요
- 인증 코드를 정확하게 입력했는지 확인하세요
- 봇이 활성화 상태인지 확인하세요
알림이 오지 않음
- 구독자 목록에 등록되어 있는지 확인하세요
- 액션이 활성화 상태인지 확인하세요
- 규칙이 활성화 상태인지 확인하세요