python에서 telegram bot 사용하기

프로젝트 도중에 휴대폰으로 알림을 주는 기능이 필요해서 찾다가 telegram bot(텔레그램 봇)을 사용하기로 하였습니다. telegram bot은 telegram이라는 메신저 앱에서 사용 가능한 bot(로봇과 비슷합니다.)입니다. bot은 메세지를 보내거나, 채팅방의 데이터를 수집하는 등 여러 용도로 사용이 가능합니다. 또한 API가 공개되어 있어 편리하게 사용이 가능하며 얼마 전 지진 경보를 재난안전처보다 빨리 알려주는 '지진희알림'도 Telegram bot을 이용하여 만들어 졌습니다.

 

시작에 앞서 몇가지 용어를 보고 들어가겠습니다. 이 내용을 몰라서 몇시간 헤맸습니다. 제가 나름대로 정리한 내용이라 틀린점이 있을 수 있습니다.

계정 : 하나의 주체입니다. 사용자 혹은 bot등이 여기 해당됩니다.

채널 : 열린 채팅방이라 생각하면 됩니다. 그룹이 단순히 여러명이 모여 대화를 나누는 곳이라면 여기에는 그 이상의 기능이 가능합니다. 채널을 공개하여 여러 사람이 들어올 수도 있으며(지진희알림등) 관리자등을 지정하고 이들만 채팅이 가능하도록 하는 등 알림용도로도 사용이 가능합니다. 

BotFather : bot을 생성, 관리할 수 있는 계정(bot 형태)입니다. BotFather과 대화로 bot을 생성하고 여러 기능을 설정할 수 있습니다.

준비물 : 휴대폰에 telegram 어플이 필요합니다. 메세지를 받아야 하니 당연하겠죠? 대화상대에서 BotFather를 검색하여 추가해 줍니다.

 

 

 

/start

 

 

 

라는 메세지를 보내면 시작할 수 있습니다. 여러가지 설명이 나오며 bot을 먼저 만들어야 하기에

/newbot

를 보냅니다. 그러면 이름을 지어달라고 합니다. 봇의 이름을 지어줍니다.(채팅방에서 보이는 이름입니다.) 원하는 이름을 메세지로 보내면 됩니다. 그러면 username을 지어달라고 합니다. 이는 아이디입니다.

 

 

아이콘 바로 옆에있는 bill_bot이 봇의 이름, 아이디에 있는 @로 시작하는 부분이 username입니다. 봇을 검색할 때 사용됩니다. 전체 과정은 아래와 같습니다.(user name 짓는 부분에서 중복되면서 약간의 편집이 있었습니다. 그림판 죄송합니다 ㅠㅠ) 

 

 

 

  마지막에 검은색 박스로 쳐진 부분이 있습니다. 이 부분은 token(토큰)으로 xxxx:yyyyyy 형태로 이루어 져 있습니다. 이 토큰이 있으면 해당 계정(여기서는 봇)의 권한을 거의 전부 사용할 수 있다고 보시면 됩니다. 그렇기에 관리를 해주시는 것이 필수입니다. python으로 넘어가기 전에 한가지 준비를 해주어야 합니다. 현재 봇은 생성되었지만 저에게 메세지를 보낼 수 없습니다. 왜냐하면 제가 누군지 모르니까요. 그렇기에 봇에게 먼저 말을 걸어보고 파이썬으로 넘어가도록 하겠습니다. BotFather를 추가했던 것 처럼 봇의 아이디를 검색하여 채팅을 시작합니다. 메세지는 아무거나 보내도 됩니다. 이제 코딩을 시작해 보겠습니다. python에서 저는 telegram api를 사용하기 위해 python-telegram-bot 이라는 모듈을 사용하고 있습니다. pip 혹은 소스코드를 직접 내려받아 설치가 가능합니다. pip를 이용할 경우

$pip install python-telegram-bot --upgrade

소스코드를 이용하여 직접 설치할 경우

$git clone https://github.com/python-telegram-bot/python-telegram-bot $cd python-telegram-bot $python setup.py install

설치가 완료되었다면 토큰을 이용하여 봇을 사용해 보도록 하겠습니다. (토큰이 담긴 메세지를 메일로 보내 컴퓨터에서 여는 방식으로 토큰을 입력해주었습니다. 솔직히 어떻게 하나하나 다 치고 있습니까...)

import telegram   #텔레그램 모듈을 가져옵니다.

my_token = '여기에 토큰을 입력해 주세요'   #토큰을 변수에 저장합니다.

bot = telegram.Bot(token = my_token)   #bot을 선언합니다.

updates = bot.getUpdates()  #업데이트 내역을 받아옵니다.

for u in updates :   # 내역중 메세지를 출력합니다.

print(u.message)

응답(메세지는 이렇게 많은 데이터를 담고 있습니다. 일부분은 사생활 보호를 위해(?) 삭제하였습니다.)

{'caption': '', 'text': '봇 테스트', 'new_chat_title': '', 'entities': [], 'delete_chat_photo': False, 'message_id': 6, 'chat': {'username': '보호', 'title': '', 'first_name': '보호', 'id': 39020242, 'last_name': '보호', 'all_members_are_admins': False, 'type': 'private'}, 'group_chat_created': False, 'from': {'first_name': '보호', 'id': 39020242, 'last_name': 'Park', 'type': '', 'username': 'bill_park'}, 'supergroup_chat_created': False, 'date': 1481120854, 'migrate_from_chat_id': 0, 'migrate_to_chat_id': 0, 'channel_chat_created': False, 'new_chat_photo': [], 'photo': []}

u.message에서 텍스트(내용), 누구한테서 왔는지, 발신자의 id(username과 동일하게 사용됩니다.)등을 볼 수 있습니다.  만약 수신한 텍스트(내용)만 보려면 u.message.text 를 사용하면 됩니다. 이제 메세지를 보내볼 차례입니다. 메세지를 보내기 위해서는 보낼 상대의 username - api에서 말하는 chat_id를 알아야 합니다. bot을 테스트 할 때 메세지를 보내 두었다면 또 위의 예제가 잘 실행되었다면 u.message.chat.id 로 메세지를 보낸 사람의 chat_id를 알아낼 수 있습니다. 중간에 굵게 표시되어 있는 'id': 39020242 부분이 chat_id를 나타내고 있습니다.

chat_id = bot.getUpdates()[-1].message.chat.id #가장 최근에 온 메세지의 chat id를 가져옵니다

bot.sendMessage(chat_id = chat_id, text="저는 봇입니다.")

그러면 bot이 메세지를 보낸 것을 확인할 수 있습니다.

 

 

이상으로 python에서 telegram bot 만들기를 마치도록 하겠습니다. 다음 python - telegram bot 편에서는 봇으로 채널을 이용하는 것을 알아보겠습니다.(할 일이 늘어만 갑니다.. ㅠㅠ)