X-SCADA AI와 텔레그램(Telegram) 연동하기
※ 해당 기능을 활용하기 위해서는 최신 버전의 X-SCADA AI가 필요합니다.
텔레그램(Telegram)은 속도와 보안에 중점을 둔 클라우드 기반의 무료 메신저 서비스입니다.
강력한 보안 기능과 사용자 편의성으로 전 세계적으로 많은 사용자들이 이용중입니다.
이번 게시글에서 텔레그램을 X-SCADA AI와 어떻게 연동하여 메시지를 보낼 수 있는지 소개할 예정입니다.
X-SCADA AI에서 발생한 경보를 텔레그램 채팅방으로 보내 실시간으로 많은 사용자에게 상황을 전파할 수 있도록 설정할 예정입니다.
1. 텔레그램 설정하기
1) 텔레그램에 접속한 뒤 검색창에서 BotFather를 검색한다.
· PC와 모바일 버전에서 동일한 순서로 진행가능하지만, 이번 게시글에서는 PC 프로그램을 기준으로 진행 예정
2) BotFather를 클릭한 뒤 [START]를 클릭한다.
3) 채팅창에 /newbot을 입력한다. (/newbot 메시지 클릭 가능)
4) 이후 봇의 표시 이름과 봇의 사용자명을 입력한 뒤 HTTP API Token을 발급한다.
· 첫번째 입력하는 봇 이름은 채팅에서 표시될 이름으로 다른 봇과 중복 가능 (이번 시간에는 tele_scada라는 이름 부여)
· 두번째로 입력한 봇 이름은 중복이 불가능한 고유한 이름으로 반드시 bot으로 끝나야 함 (tele_scada_bot이라고 지었으며, 봇의 고유 링크 주소에 활용)
· 봇 이름을 모두 지은 뒤 발급된 HTTP API Token(빨간색 박스)는 추후 X-SCADA AI에서 활용 예정
· 파란색 박스로 표시한 t.me/[봇이름] 을 클릭하여 봇의 고유 채팅 링크에 접속
5) 4)의 이미지에 있는 파란색 박스를 클릭하여 봇 고유 채팅방에 간단한 메시지를 입력한다.
· 해당 과정을 통해 채팅방 고유번호를 알아낼 예정
6) 4)에서 발급한 Token을 활용하여 특정 페이지에 접속하여 채팅방 고유번호를 파악한다.
자세한 정보는 Telegram Bot API(클릭시 이동) 페이지에서 확인가능
· 기본형 : https://api.telegram.org/bot[APIToken]/getUpdates
· 예시 : https://api.telegram.org/bot8487129936:EQLkrTfsSeHdt9_3TPzhSYhH-_q_4K7BccB/getUpdates
· 빨간색 박스로 처리한 부분이 채팅방 고유번호이며, 해당 고유번호는 X-SCADA AI 설정에서 활용 예정
2. X-SCADA AI Designer에서 텔레그램 연동 설정하기
1) X-SCADA AI Designer에서 텔레그램 연동을 위한 HMI를 제작한다.
2) 상단 보기(View) > SMS 설정(SMS Windows)를 클릭한다.
3) [Add]를 눌러 새로운 SMS 설정을 추가한 뒤 전화번호(Phone) 항목에 생성한 채팅방고유번호를 입력한 뒤 [확인(OK)]를 클릭한다.
4) 보기(View) > 스크립트 편집(Script Editor)을 클릭한다.
5) 스크립트 편집창에서 [스크립트 빌더(Script Builder)]를 클릭한 뒤 Message > Telegram Bot을 설정한 뒤 [추가(Add)]를 클릭한다.
· 우측 속성에서 Object > Message 항목과 Arguments > Token 항목을 입력
· Object > Message : SMS 설정(SMS Windows)에 추가한 설정 선택
· Arguments > Token : 텔레그램에서 봇을 만들고 얻은 HTTP API Token을 입력
6) 아래와 같이 기본 스크립트가 작성된 것을 확인한 뒤 창을 닫는다.
· SMS 내용 및 전송만을 구현했기에 추가로 설정 없음. 개인화된 이벤트가 필요한 경우 해당 창에서 스크립트를 추가 작성하여 설정 가능
7) 보기(View) > 경보 설정(Alarms Window)을 클릭한다.
8) 텔레그램으로 보내고자 하는 경보들을 추가한 뒤 우측 속성 > SMS > 전송(Send) 항목에 생성한 telegram_bot SMS 설정을 추가한다.
9) 경보 발생 시 보낼 메시지를 커스터마이징하기 위해 [메시지 설정(Message Settings)]을 설정한다.
· 아래와 같이 6개의 항목을 활용하면 현장 상황에 맞는 최적화된 메시지를 제공받을 수 있음
3. X-SCADA AI Viewer에서 텔레그램 연동 확인하기
1) 프로젝트 저장 후 X-SCADA AI Viewer로 실행하여 경보를 발생시킨다.
2) 텔레그램 채팅방에서 메시지가 정상적으로 전송되었는지 확인한다.