1. 텔레그램 & AWS 서비스 연동하기 - 1) 텔레그램 봇과 AWS Lambda & AWS Gateway 연동

주니어 개발자 채용 정보 텔레그램 Bot을 만들었습니다.
그 과정을 다른 분들도 따라할 수 있게 시리즈로 진행할 예정입니다.

전체적인 구조는 다음과 같습니다.

intro

이 구조를 하나씩 구현해나가겠습니다.

1-1. Telegram Bot 생성

BotFather에서 새로운 봇을 생성합니다.

telegram1

/newbot을 입력해서 새로운 봇 생성을 시작합니다.
AwsTelegramTravis 라는 이름의 봇을 생성합니다.
- 본인이 원하시는 봇 이름을 입력하면 됩니다.
방금전에 생성한 AwsTelegramTravis 봇이 @AwsTelegramTravis_bot 이란 username을 갖도록 합니다.
- 앞에는 꼭 @를 붙여야 합니다.
- 마지막엔 꼭 bot이 붙어야 합니다.
마지막 메세지에 포함된 token 값은 어딘가에 꼭 저장해놓으셔야 합니다.
- 해당 Bot을 관리하는 키 값이라고 생각하시면 됩니다.

생성이 끝나셨으면 마지막 메세지에 있는 t.me/봇username 링크를 클릭합니다.
그럼 아래처럼 입장 모드가 됩니다.

telegram2

START를 클릭합니다.

그럼 아래 처럼 방금 생성한 Bot 채팅이 시작 됩니다.

telegram3

Bot 생성은 여기까지입니다.
바로 AWS Lambda로 넘어가겠습니다.

1-2. AWS Lambda와 Bot 연동

AWS Lambda의 경우 월 100만건까지 무료입니다.
개인이 쓰기에 충분한 양입니다.

바로 Lambda 페이지로 이동하신뒤, 대시보드의 함수 생성 버튼을 클릭합니다.

lambda1

아래처럼 각 항목을 선택 & 입력합니다.

lambda2

Nodejs를 사용할 예정이라 Node.js를 선택합니다.,
역할의 경우 생성된게 없으니 새 역할 생성을 선택합니다.
정책 템플릿에서 기본 Edge Lambda 권한을 선택합니다.

입력이 끝나시고 생성 버튼을 클릭하시면 아래처럼 AWS Lambda가 생성됩니다.

lambda3

간단한 코드를 하나 추가해보겠습니다.
함수 코드 영역에 아래와 같이 코드를 작성합니다.

lambda4

exports.handler = (event, context) => {
    console.log('event: ', JSON.stringify(event));
    context.succeed('Hello World, ' + JSON.stringify(event));
};

우측 상단의 저장 버튼으로 한번 저장하시고, 이 Lambda 코드가 잘 작동하는지 간단한 테스트를 해보겠습니다.
저장 버튼 옆의 테스트 이벤트 구성을 선택합니다.

lambda5

테스트로 보낼 Request Body 를 구성합니다.

lambda6

{
  "message": {
    "chat": {
      "id": 1,
      "first_name": "테스트",
      "last_name": "사용자",
      "type": "private"
    },
    "text": "안녕하세요"
  }
}

작성된 테스트를 한번 실행해보겠습니다.
테스트 버튼을 클릭합니다.

lambda7

응답 결과와 로그가 테스트로 보낸 Request Body 를 전달해주는 것을 확인할 수 있습니다!

lambda8

Lambda의 샘플 코드는 완성 되었습니다.
Lambda 생성 페이지는 그대로 두시고, 새로 브라우저를 열어 이번엔 API Gateway로 이동합니다.

API Gateway 연동

gateway1

gateway2

작업 -> 메서드 생성 버튼을 차례로 클릭합니다.

gateway3

POST 메서드를 선택하시고 아래처럼 각 항목을 입력합니다.

gateway4

그럼 아래처럼 Gateway API 가 하나 생성 됩니다.

gateway5

중앙의 테스트 버튼을 클릭합니다.
테스트할 Request Body를 입력해야하는데요.
좀전에 Lambda에서 사용한 본문을 그대로 사용하겠습니다.

gateway6

{
  "message": {
    "chat": {
      "id": 1,
      "first_name": "테스트",
      "last_name": "사용자",
      "type": "private"
    },
    "text": "안녕하세요"
  }
}

자 테스트 버튼을 클릭하시면!
우측 화면에 응답 결과가 아주 잘 나타납니다!
AWS Lambda와 Gateway가 잘 연동된것을 알 수 있습니다.

gateway7

연동된것을 확인하였으니 이 Gateway API 를 배포하겠습니다.

AWS Gateway API는 배포가 되어야만 외부에서 호출 할 수 있습니다.

gateway8

취향대로 본인의 항목을 입력하시고 배포 버튼을 클릭합니다.

gateway9

배포가 되면 외부에 제공할 수 있는 API가 할당 됩니다.
보시면 URL 호출 영역에 있는 주소가 외부에서 AWS Gateway API를 호출할 수 있는 URL 주소입니다.

gateway10

이 주소를 통해 텔레그램 봇과 통신할 예정입니다.
AWS Lambda와 AWS Gateway API도 잘 연결되었으니 이제 텔레그램과 연동해보겠습니다.

1-3. Telegram과 AWS Gateway API 연동

1-1에서 만든 Telegram Bot에 1-2에서 만든 AWS Gateway API를 웹훅으로 등록해야 합니다.

웹훅이란 이벤트에 대한 응답을 반환할 URL을 얘기합니다.

curl 이나 Postman, IntelliJ .http 등 편하신 방법으로 HTTP Get 요청을 보냅니다.

curl https://api.telegram.org/bot<API TOKEN>/setWebhook?url=<API endpoint URL>

여기서 주의하실게 몇가지 있는데요.

bot<API TOKEN>에서 bot은 무조건 붙여야 합니다.
- bot 뒤에 처음 (1-1) 발급 받은 토큰값을 바로 붙여넣으시면 됩니다.
꺽쇠 (<>)는 지우시고 붙이셔야 합니다.
API endpoint는 1-2에서 만든 AWS Gateway API의 URL을 등록하시면 됩니다.

저는 IntelliJ .http를 통해 요청을 하겠습니다.

webhook1

응답이 true로 잘 떨어졌으면 등록 완료 된 것입니다.
잘 등록되었는지 AWS Lambda 코드를 수정해서 확인해보겠습니다.

AWS Lambda 코드 수정

1-2에서 생성한 AWS Lambda 페이지로 이동합니다.
그리고 아래처럼 코드를 수정합니다.

webhook2

const https = require('https');
const util = require('util');
const TOKEN = process.env.TOKEN;

exports.handler = (event, context) => {
    console.log('event: ', JSON.stringify(event));
    const content = {
        "chat_id": event.message.chat.id,
        "text": event.message.text
    }
    ;
    sendMessage(context, content);
};

function sendMessage(context, content) {
    const options = {
        method: 'POST',
        hostname: 'api.telegram.org',
        port: 443,
        headers: {"Content-Type": "application/json"},
        path: "/bot" + TOKEN + "/sendMessage"
    };

    const req = https.request(options, (res) => {
        res.setEncoding('utf8');
        res.on('data', (chunk) => {
            context.done(null);
        });
    });

    req.on('error', function (e) {
        console.log('problem with request: ' + e.message);
    });

    req.write(util.format("%j", content));
    req.end();
}

Telegram은 요청이 오더라도, 응답 결과를 요청자에게 바로 보낼수 없습니다.
그래서 요청자의 채팅방 ID (chat_id)를 통해서 해당 채팅방으로 HTTP Request를 보내는 방식으로만 가능합니다.
Telegram에서는 메세지의 내용을 text라는 필드로 관리하기 때문에 text에는 제가 보낸 메세지 그대로를 다시 반환하도록 합니다.

그리고 Token 값이 필요한데, 이 값은 코드에서 관리하기 보다는 환경 변수로 등록해서 사용하겠습니다.