DB Library

방법

telegram 가입 후, telegram bot을 이용하여 채팅방 생성후 메시지 전송 API를 웹브라우저로 전송

1. telegram bot 생성

  1-1. 웹브라우저(Web browser)에서 https://web.telegram.org/#/im?p=@BotFather
  1-2. 하단의 Start 버튼 클릭 또는 /start
  1-3. /newbot
  1-4. Bot 별칭 지정: chat 리스트 등 외부에 보일 이름
  1-5. Bot 이름 지정: 반드시 이름이 bot으로 끝나야 한다. ex) hexoul_bot
  1-6. Access token 메모: 1-4까지 진행하면 BotFather가 메세지를 보내는데 이것이 Access token이다.
        "Use this token to access the HTTP API:" 바로 아래의 긴 문자열을 복사해둔다.
  1-7. chat 리스트에서 1-4. 에서 지정한 별칭을 찾아 Start 버튼 클릭 또는 /start 입력

2. 채팅방 정보 얻어오기

2-1. 내 정보 API 호출: "https://api.telegram.org/bot" + Access token + "/getUpdates" 를 웹브라우저에 입력

     1-5에서 얻은 Access token이 123ABC였다면, "https://api.telegram.org/bot123ABC/getUpdates" 가 된다.
     만약 "result": []로 되어있다면 아직 Bot 시작 전일 수 있으므로 1.7.이 잘 되었는지 확인한다.

     정상적으로 처리되었다면 아래와 같은 결과가 반환된다.

  2-2. chat_id 메모
        2-1에서 빨간 굵은 글씨로 표시한 ????????가 chat_id로 쓰인다.
        실제로는 숫자로 되어있으므로 헷갈리지 말자. 따로 메모해두자.

3. 채팅방에 메세지 보내기

    2-1에서 썼던 웹주소의 뒷부분을 변경하여 호출한다.
    Access token까지가 base url이고 API 명, 인자 등이 뒤에 붙는다.
    메세지를 보내는 API 명은 sendMessage이고 인자는 chat_id와 text로 전체적인 형태는 아래와 같다.

    Access token: 사용자마다 다름
    chat_id: 2-1에서 얻은 채팅방의 ID
    text: 보낼 내용

    >> 텔레그램에 메세지가 잘 도착한 것을 확인할 수 있다.

참고

https://hexoul.blogspot.com/2017/11/telegram-sendmessage-api.html

commands

telegram 대화창에 /명령 형태로 전달

/dm_oncall 메시지를 python 코드로 확인 후 message 전달

--------------

@bot.message_handler(commands=['dm_oncall'])
    def trigger(message):
        print("## bot.message_handler dm_oncall message => ", message)
        print("## bot.message_handler dm_oncall message.text => ", message.text)

        cmd = message.text
		
		#message send 
		msg_text = """ Select Day """
		bot.send_message(message.chat.id, msg_text)
		
		#button message send 
        button_list = show_button(["Yesterday", "Today", "Tomorrow"],"oncall", 1)
        bot.send_message(message.chat.id, "당직을 확인할 날짜를 선택하세요", reply_markup=button_list)

call_back

telegram의 대화가 출력되는 부분에 버튼 형태로 전달

버튼이름은 대화창에 출력되고, call_back 변수에 지정한 메시지는 대화창에 보여지지 않고 백그라운드에서 python에서 mssage를 캡쳐하여 처리 가능

php 코드로 telegram에 버튼형태로 call_back에 message 추가하여 전달

---------

$body = file_get_contents("php://input");
$obj = json_decode($body);
$bot_query = 'https://api.telegram.org/bot'.$obj->bot_token;
$chat_id = $obj->chat_id;

# send text
$text = 'Keyboard message test !!';

$keyboard = array(
    "inline_keyboard" => array(
        array(
            array(
                "text" => "Manager",
                "callback_data" => "/manager test"
            )
        )
    )
);
$keyboard = json_encode($keyboard, true);

$sendto = $bot_query.'/sendMessage?chat_id='.$chat_id.'&parse_mode=HTML&reply_markup='.$keyboard.'&text='.urlencode($text);

$response = file_get_contents($sendto);

Keyboard Button

telegram의 대화창에 아닌, 메시지 입력창에 버튼형태로 메시지를 전달

python 코드로 메시지 입력창에 버튼 형태로 전달

-----------

import telebot
from telegram import InlineKeyboardButton, InlineKeyboardMarkup, KeyboardButton, ReplyKeyboardMarkup

token = '14????????:XXXXXXX_XXXXX-XXXXXXXXXXXXXXX'
bot = telebot.TeleBot(token)


@bot.callback_query_handler(func=lambda c: "manager" in c.data.split(",")[0])
def manager_callback(call):

    print("## bot.callback_query_handler call.data => ", call.data)
    print("## bot.callback_query_handler call.message => ", call.message)

    try:
        data_selected = call.data

        data_oncall_Yesterday = '/dm_oncall ,Yesterday'
        data_oncall_Today = '/dm_oncall ,Today'
        data_oncall_Tomorrow = '/dm_oncall ,Tomorrow'
        data_oncall_Cancel = '/Cancel'

        main_menu_keyboard = {"keyboard":[[data_oncall_Yesterday],[data_oncall_Today],[data_oncall_Tomorrow],[data_oncall_Cancel]],"resize_keyboard": True,"one_time_keyboard": True}
        print("## main_menu_keyboard => ", main_menu_keyboard)

        bot.send_message(chat_id=call.message.chat.id, text='Select Menu.', reply_markup=json.dumps(main_menu_keyboard))

    except BaseException as e:
        print("## [Exception] manager_callback ==> ",str(e))

참고

https://blog.psangwoo.com/coding/2018/08/20/python-telegram-bot-4.html

용어

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

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

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

telegram 대화상대에서 BotFather를 검색하여 추가해 줍니다

시작

bot 이름 및 아이디 설정

순서 : 이름 입력 -> 아이디 입력

이름 : bot의 이름으로, 채팅방에서 보이는 이름입니다. ( 예제는 bill_bot )

아이디 : username으로 변수로 처리되며, 아이디에 있는 @로 시작하는 부분이 username입니다.

           봇을 검색할 때 사용됩니다.

bot 생성 과정

마지막에 검은색 박스로 쳐진 부분이 있습니다.

이 부분은 token(토큰)으로 xxxx:yyyyyy 형태로 이루어 져 있습니다.

토큰이 있으면 해당 계정(여기서는 봇)의 권한을 거의 전부 사용할 수 있다고 보시면 됩니다.

그렇기에 관리를 해주시는 것이 필수입니다.

python으로 넘어가기 전에 한가지 준비를 해주어야 합니다.

현재 봇은 생성되었지만 저에게 메세지를 보낼 수 없습니다.

왜냐하면 제가 누군지 모르니까요.

그렇기에 봇에게 먼저 말을 걸어보고 파이썬으로 넘어가도록 하겠습니다.

BotFather를 추가했던 것 처럼 봇의 아이디를 검색하여 채팅을 시작합니다.

메세지는 아무거나 보내도 됩니다.

telegram python api 설치

python 으로 message 받기

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

u.message에서 텍스트(내용), 누구한테서 왔는지, 발신자의 id(username과 동일하게 사용됩니다.)등을 볼 수 있습니다.

만약 수신한 텍스트(내용)만 보려면 u.message.text 를 사용하면 됩니다.

이제 메세지를 보내볼 차례입니다.

메세지를 보내기 위해서는 보낼 상대의 username - api에서 말하는 chat_id를 알아야 합니다.

bot을 테스트 할 때 메세지를 보내 두었다면 또 위의 예제가 잘 실행되었다면 u.message.chat.id 로 메세지를 보낸 사람의 chat_id를 알아낼 수 있습니다.

chat 그룹 안의 id부분이 chat_id를 나타내고 있습니다.

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

참고

https://blog.psangwoo.com/coding/2016/12/08/python-telegram-bot-1.html

배경

telegram으로 DB 성능 및 상태 모니터링을 하는 경우, php, python... 등으로 telegram 대화창에 메시지를 전송하는 경우 일반적으로 callbak_data에 정보를 추가하여 처리함.

callback_data로 처리를 하면 telegram 대화창에는 보이지 않지만, python에서 callbak_data를 받아서 처리 가능한 장점이 있어 많이 사용하는 것으로 보임.

이슈

callback_data에 너무 많은 정보를 전달하는 경우 일부 데이터만 전달됨

원인

callback_data에 최대로 전달할수 있는 정보는 64개의 문자로 제한됨.

참고 : https://github.com/nmlorg/metabot/issues/1