Facebook Messenger Botの作り方　〜AWS Lambda(Serverless)での構築〜

2016/4/13、[FacebookがMessenger Botを発表しました](http://jp.techcrunch.com/2016/04/13/20160412agents-on-messenger/)。国内ではすでにLineもbot市場(？)に参入していて、これからbotをベースとしたサービスも続々と増えていくでしょう。Facebook Messenger Botとは何か、そして何が実現できるのか。それを知るためにも、AWS Lambda + Serverlessフレームワークを使ってbotを構築してみました。

![Serverless](https://qiita-image-store.s3.amazonaws.com/0/52054/a1d20f74-2c6d-9df4-f2dc-0acd04d803a8.png)

巷にはherokuで構築してみましたという例が多いですが、Lambda + Serverlessで構築することで次のメリットがあります

* 運用コストがほぼゼロ(Lambdaは毎月100万リクエストが無料)
* サーバーレスなので管理コストがほぼゼロ
* Serverlessは一種のInfrastructure as Codeなので、メンテが楽

逆にServerlessのアップデートが早すぎて大変(実際に今回詰まった)というデメリットはありますが、そこは気合でカバーしましょう。

# はじめに
分かる人は読み飛ばして大丈夫です

## Facebook Messenger Botとは
企業や団体が公開しているFacebookページにも、Messenger機能があります。通常は、そのFacebookページにメッセージを送ると管理者に通知がいくのですが、これをbotで返信できるようになりました。

サーバーを1台立てるだけで、あるメッセージに対して自動的に返答を返す、ということが簡単に実現できます。なんだかプロトタイピングでユーザーニーズを吸い上げるときとかに使えそうですね(と今思った)。

## AWS Lambdaとは
2015年あたりから注目されている、サーバーレスアーキテクチャを実現するAWSのサービスです。通常バックエンドの仕組みを作るときは、EC2のインスタンスを立てて〜としていましたが、Lambdaならそれが不要です。Lambdaはリクエストがある度に起動され、ある単一の関数(Lambda Functionとか呼ばれる)を実行し、レスポンスを返したら終了します。Lambdaによって、人々はサーバーのメンテナンスという仕事から解放されます。

## Serverlessとは
そのAWS Lambdaを簡単に使えるようにしたのが、ServerlessというAWS純正のフレームワークです。Lambda FunctionをAPIとして使いたい場合、API Gatewayと接続する必要があるのですが、これを簡単に設定できたり、複数のLambda Functionのデプロイを簡易化するのがServerlessです。裏ではCloud Formationが動いていて、簡単なコマンドと設定ファイルでいい感じに構築してくれます。

# 動作環境
* Serverless v0.5.5
* node.js(開発環境) v4.4.0
* node.js(Lambda上) v4.3.0

# 構築手順
それでは早速、botを構築していきましょう。

## 1.Facebookページの作成・アプリの登録
まずは、メッセージのやり取りをするFacebookページを作成します。自分のFacebookのホームから、左にある「Facebookページを作成」を選択します。ここの文章、基本的に見切れてるんだけど、これでいいのかFacebook...

テスト用ページなので、入力項目は適当で。「コミュニティ」を選択したほうが入力項目少なそうで楽でした。

![Facebookページの作成](https://qiita-image-store.s3.amazonaws.com/0/52054/59def2c6-d670-6199-4769-513e39336e7f.png)

Facebookページができたら、次はbotアプリの登録をします。Facebook Developerへの登録が必要だった気もしますが、既に登録済みだったため手順は分からず..まあそれほど難しくなかった気がします。

https://developers.facebook.com/apps/

[新しいアプリを追加]を選択

![新しいアプリを追加](https://qiita-image-store.s3.amazonaws.com/0/52054/fa9909ab-5e74-45ca-6b11-e0beea2eec94.png)

アプリの選択では[basic setup]を選びます。

![basic setupを選択](https://qiita-image-store.s3.amazonaws.com/0/52054/1afc227f-d8cb-0048-b3ef-d70fa0d6def3.png)

この辺りも適当に。ネームスペースは`test`とか適当なやつだとかぶって使えないのでご注意を。

![アプリの設定](https://qiita-image-store.s3.amazonaws.com/0/52054/593fc899-6787-e043-d410-e6119d5f28e7.png)

[Product Setup]の画面に遷移するので、[Messenger]を選択 => [スタート]。

トークン生成で、先ほど作成したFacebookページを選択。右に表示されるアクセストークンをメモしておきましょう。

![アクセストークンの生成](https://qiita-image-store.s3.amazonaws.com/0/52054/93a7d936-48c7-2703-b05b-6c1d1c3641cf.png)

念のため、対象のページがフォローされているか(botのターゲットになっているか)を確認しましょう。

![フォローするページの選択](https://qiita-image-store.s3.amazonaws.com/0/52054/114613c5-dff5-1f92-6a86-94cb62c9e482.png)


一旦ここまでで作業は完了です。このページは閉じずに置いとくと楽です。

## 2.Serverlessの構築
次は実行されるAPIの部分を、AWS上に構築していきましょう。

### プロジェクトの作成
何はともあれServerlessをインストールします。この記事を書いている時点では、`v0.5.5`を使用しています。Serverlessは結構変化が早いので、バージョンを合わせることをオススメします。また、もし`v0.5.5`以上を使用される場合、この記事の通りに動く保証はありません...

```
$ npm i serverless -g
```

インストールが完了したら、プロジェクトを作成します。`serverless`コマンドは`sls`とも打てるので、短い方で。プロジェクト作成後、そのディレクトリに移動してLambda Functionを作成します。

**注意**
Serverlessを最初に使う場合、IAMユーザの登録やアクセスキーの登録が必要だった気がします。筆者の環境には既にServerlessがセットアップされていたため、その手順をなぞることが出来ず...
このあたりの記事を参考にセットアップしてください。
[AWS Lambdaを活用したServerless Frameworkを触ってみる](http://qiita.com/susieyy/items/1c2af0ef7b88b742c37a)

```
$ sls project create
$ cd [project_name]
$ sls function create
```

runtimeにはnode.jsの最新版、API Gatewayを使うので[Create Endpoint]を選択。

![Lambda Functionの生成](https://qiita-image-store.s3.amazonaws.com/0/52054/3aa6671d-10b7-3fb2-e669-56ccc3be6a7f.png)

### APIの作成

早速Lambda Function(実行されるAPI)を書いていくのですが、その前にFacebook Messenger Botの仕様を確認します。公式のドキュメントに一度目を通しておくといいでしょう。
[Messenger Platform - Getting Started](https://developers.facebook.com/docs/messenger-platform/quickstart)

Messenger Botを構築するには、任意のサーバーで`GET`と`POST`の2つのAPIを解放する必要があります。pathはなんでも良いのですが、ここでは仮に`/facebook` として話を進めましょう。

* **GET /facebook**：正しいendpointかを認証するためのAPI
* **POST /facebok**：実際にメッセージをうけた時に呼ばれるAPI。ここでbotの処理を行う

アプリを登録するうえで、まずは`GET`のAPIは先に作る必要があります。という訳で、GET APIの作り方を見ていきましょう。

### GET /facebook

`GET`は認証用に解放するAPIです。Facebook Messenger Botに設定したURLが正しいか、このAPIを用いてチェックします。リファレンスを見る限り、次の2つの仕様を満たす必要があるようです。

* QueryStringで渡された`hub.verify_token`が、事前に生成したTokenと合っているかチェックする
* 正しい場合、QueryStringで渡さされた`hub.challenge`をそのままレスポンスとして返す、それ以外の場合は適当な文字列を返す

この仕様を満たすAPIをLambda上に構築しましょう。Serverlessでは、まずAPIの定義(API Gateway側の設定)を`s-function.json`内の`endpoints`に記述します。全体像は最後に貼ります。

まず、「どのパラメータを受け取るか」を`requestParameters`内に記述します。今回はQueryStringの`hub.verify_token`と`hub.challenge`が必要なので、この2つを指定します。

```` facebook-bot/s-function.json
  "requestParameters": {
    "integration.request.querystring.hub.verify_token": "method.request.querystring.hub.verify_token",
    "integration.request.querystring.hub.challenge": "method.request.querystring.hub.challenge"
  }
```

次に、それらの値がLambda上でどのような名前で取れるのか、`requestTemplates`にマッピングを指定します。ここでは先程の2つに加え、`method`を定義しています。今回は`GET`と`POST`のリクエストを１つのLambda Functionで取り扱うため、その判定のためにHTTP Methodを渡しています。

ここの記述はVTLという言語で書かれているらしく、詳しく知りたい方はググッてください。
もしくは公式リファレンスを
[API Gateway のマッピングテンプレートリファレンス](http://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/api-gateway-mapping-template-reference.html)

```` facebook-bot/s-function.json
  "requestTemplates": {
    "application/json": {
      "verify_token": "$input.params('hub.verify_token')",
      "challenge": "$input.params('hub.challenge')",
      "method": "$context.httpMethod"
    }
  }
```

次に、レスポンスのマッピングをします。Facebook Messenger Botはプレーンテキストを返す仕様なので、`responseTmplates`内の記述を次の用に書きかえます。

```` facebook-bot/s-function.json
  "responses": {
    // 〜中略
    "statusCode": "200",
    "responseParameters": {},
    "responseModels": {
      "application/json;charset=UTF-8": "Empty"
    },
    "responseTemplates": {
      "text/plain": "$input.path('$')"
    }
  }
```

最後に、`GET`メソッドのロジックを実装します。Lambdaに登録したハンドラの実装は、`handler.js`内にあります。ここでexportした`handerl`が、APIコールなどのイベント発火時に呼ばれるような仕組みです。リクエストパラメータは全て仮引数`event`内に格納され、第３引数の`cb`を実行することでfunctionの実行結果が返る仕組みです。

コードは、メソッドが`GET`の場合、`verify_token`を評価して正しければ`challenge`を返す、というシンプルな構造です。

``` handler.js
'use strict';

const FB_MESSANGER_TOKEN = 'xxxxxxxxxxxx';

module.exports.handler = function(event, context, cb) {
  switch (event.method.toUpperCase()) {
    case 'GET': {
      const validRequest = event.verify_token === FB_MESSANGER_TOKEN;
      return cb(null, validRequest ? event.challenge : 'Error, wrong validation token');
    }
    
    default: return cb('Error, Invalid Method');
  }
};
```

これでGET APIの作成は完了です。デプロイしましょう。
Serverlessには、`dash deploy`というCUIで簡単にデプロイ対象が選択できるコマンドが用意されいてるので、これを使います。

```
$ sls dash deploy
```

![Serverlessのデプロイ](https://qiita-image-store.s3.amazonaws.com/0/52054/35dbc0e1-d0d3-79e4-7bcb-37657813e324.png)

デプロイが完了しました!

ここまで来たら、先ほどのFacebook Developerに戻り、APIのテストをしましょう。

[Setup Webhooks]を選択。

![Webhooksを選択](https://qiita-image-store.s3.amazonaws.com/0/52054/da99f44c-ae63-2b6a-1958-df9fe66407a5.png)

LambdaのURLと、先ほど生成されたtokenを入力、[messages]にチェックを入れて確認します。指定されたURLから正しくChallengeが返ってきたら成功です。

![コールバックURL、トークンを入力](https://qiita-image-store.s3.amazonaws.com/0/52054/58a339bd-4f41-cedf-ec8b-8ed1756459d1.png)

**エラーが出る場合**
次の項目を確認してください。

#### URLが正しいか
API Gatewayのコンソールから正しいURLを確認してください。ここに表示されているEndpoint + Serverlessで指定したpathです。
![API GatewayのURL](https://qiita-image-store.s3.amazonaws.com/0/52054/3da35bfb-23ab-9961-5dc1-ecff4ee899f8.png)

#### Lambdaのログを確認
該当するLambda Functionの[View logs in CloudWatch]から、ログを確認できます。

![Lambda Functionのログ](https://qiita-image-store.s3.amazonaws.com/0/52054/a1bcdfa2-def3-f31a-6a4f-0a0e805c3207.png)

最新のログを確認してデバッグしましょう

![CloudWatchでログの確認](https://qiita-image-store.s3.amazonaws.com/0/52054/2f0515a5-2f82-2752-a9db-7427d8b19dcb.png)

### POST /facebook
ここまできたら、あとは実際にbotとしてメッセージを返すAPIを作ります。今回は、簡略化のために「来たメッセージをそのまま返すbot」にしましょう。

POST APIの仕様は、次のようになっています。
* 受けたリクエストに対しては、**とりあえず200 OKを返す**
* パラメータで渡された**sender_id(ユーザー)**に対して、POSTリクエストを投げて応答する

レスポンスでメッセージを返すわけじゃないんですね。なるほど。

早速この仕様に対応したAPIの定義を追加します。`s-function.json`にはendpointを複数指定できるので、先ほどのファイルに追記していきます。POSTリクエストのjsonで渡されたパラメータから、`entry`のみLambdaに渡してあげる設定にしています。

```faceboo/s-function.json
    {
      "path": "facebook",
      "method": "POST",
      "type": "AWS",
      "authorizationType": "none",
      "authorizerFunction": false,
      "apiKeyRequired": false,
      "requestParameters": {},
      "requestTemplates": {
        "application/json": {
          "entry": "$input.json('entry')",
          "method": "$context.httpMethod"
        }
      },
      "responses": {
        "400": {
          "statusCode": "400"
        },
        "default": {
          "statusCode": "200",
          "responseParameters": {},
          "responseModels": {
            "application/json;charset=UTF-8": "Empty"
          },
          "responseTemplates": {
            "text/plain": "$input.path('$')"
          }
        }
      }
    }
```

handlerにコードを追記します。リクエストを投げるためのモジュールを追加し、

```
$ npm i request -S
```

コードはこういう感じです。パラメータ中の`sender.id`に対してリクエストを投げるだけ。

```facebook/handler.js
const request = require('request');

const FB_MESSANGER_TOKEN = 'xxxxx';

module.exports.handler = function(event, context, cb) {
  switch (event.method.toUpperCase()) {
    case 'GET': // 略

    case 'POST': {
      event.entry[0].messaging.filter(m => m.message && m.message.text).forEach(m => sendTextMessage(m.sender.id, m.message.text));
      return cb(null, 'OK');
    }
    // 略
  }
};

function sendTextMessage(sender, text) {
  request({
    url: 'https://graph.facebook.com/v2.6/me/messages',
    qs: { access_token: FB_MESSANGER_TOKEN },
    method: 'POST',
    json: {
      recipient: { id: sender },
      message: { text: text },
    }
  }, function(error, response, body) {
    if (error) {
      console.log('Error sending message: ', error);
    } else if (response.body.error) {
      console.log('Error: ', response.body.error);
    }
  });
}
```

ここでコーディング自体は終わりなのですが、Serverlessはデフォルトでは**requireで依存したモジュールをデプロイしてくれません**。昔のバージョンだとまとめてzipにしてデプロイしてくれたのですが(ここで綺麗にハマった)、Lambdaにデプロイするモージュールが10MBまでという制限に対処するため、`v0.5.5`ではbroserifyやwebpackで最適化された１つのhandler.jsをデプロイするように変更されています。

それらは`plugin`という形で提供されていて、導入自体は楽なのですが、知らないとつらいです...
というわけで関連モジュールをインストール。browserifyとかbabelとかよく分からない人は、とりあえずコピペしましょう(でも知っておいた方がいいですよ)。

```
$ npm i serverless-optimizer-plugin babelify babel-preset-es2015 -S
```

ルートの`s-project.json`に使用するプラグインを記述します。

```s-project.json
  "plugins": [
    "serverless-optimizer-plugin"
  ]
```

そしてプラグインの設定は`s-function.json`に。browserifyするときの設定を記述するのですが、ES2015の記法を使っている場合(Arrow Functionとか)は**babelifyを通さないと死にます**。せっかくLambdaがnode v4に対応したのにバベらないといけないなんて...

```facebook/s-function.json
  "custom": {
    "excludePatterns": [],
    "optimize": {
      "exclude": ["aws-sdk"],
      "transforms": [
        {
          "name": "babelify",
          "opts": {
            "presets": ["es2015"]
          }
        }
      ]
    }
```

これで完了です。また`sls dash deploy`コマンドでデプロイしましょう。

**動かない時**

### バンドルされたコードを確認する
きちんとbrowserifyが動いているか確認します。Lambdaのコンソールからデプロイされたコードがダウンロードできるので、ちゃんとbrowseifyされているか確認します。ごちゃごちゃ圧縮されたファイルがダウンロードできたらたぶんOKです。

![コードのダウンロード.png](https://qiita-image-store.s3.amazonaws.com/0/52054/af558b7d-62cf-91c7-9542-1deb2c454edb.png)


## 動作確認

作成したFacebookページから、メッセージを送ります。

![facebookページからメッセージを送る](https://qiita-image-store.s3.amazonaws.com/0/52054/5882f373-60d5-5534-acbd-a101d7921141.png)

ちゃんとレスポンスが返ってきました！！！！！

![botの動作確認.png](https://qiita-image-store.s3.amazonaws.com/0/52054/87fd5e92-6be8-52e8-ae67-cf2ba5ee2d12.png)

## コード
今回使用したコードの全体像です。コピペしたらたぶん動きます。

### 実行したコマンド

```
$ sls project create
$ cd facebook-bot
$ sls function create

$ npm i request serverless-optimizer-plugin babelify babel-preset-es2015 -S
$ npm install  -S

$ sls dash deploy
```

### s-project.json
```s-porject.json
{
  "name": "facebook-bot",
  "custom": {},
  "plugins": [
    "serverless-optimizer-plugin"
  ]
}
```

### s-function.json

```s-function.json
{
  "name": "facebook-bot",
  "runtime": "nodejs4.3",
  "description": "Serverless Lambda function for project: facebook-bot",
  "customName": false,
  "customRole": false,
  "handler": "handler.handler",
  "timeout": 6,
  "memorySize": 1024,
  "authorizer": {},
  "custom": {
    "excludePatterns": [],
    "optimize": {
      "exclude": ["aws-sdk"],
      "transforms": [
        {
          "name": "babelify",
          "opts": {
            "presets": ["es2015"]
          }
        }
      ]
    }
  },
  "endpoints": [
    {
      "path": "facebook",
      "method": "GET",
      "type": "AWS",
      "authorizationType": "none",
      "authorizerFunction": false,
      "apiKeyRequired": false,
      "requestParameters": {
        "integration.request.querystring.hub.verify_token": "method.request.querystring.hub.verify_token",
        "integration.request.querystring.hub.challenge": "method.request.querystring.hub.challenge"
      },
      "requestTemplates": {
        "application/json": {
          "verify_token": "$input.params('hub.verify_token')",
          "challenge": "$input.params('hub.challenge')",
          "method": "$context.httpMethod"
        }
      },
      "responses": {
        "400": {
          "statusCode": "400"
        },
        "default": {
          "statusCode": "200",
          "responseParameters": {},
          "responseModels": {
            "application/json;charset=UTF-8": "Empty"
          },
          "responseTemplates": {
            "text/plain": "$input.path('$')"
          }
        }
      }
    },
    {
      "path": "facebook",
      "method": "POST",
      "type": "AWS",
      "authorizationType": "none",
      "authorizerFunction": false,
      "apiKeyRequired": false,
      "requestParameters": {},
      "requestTemplates": {
        "application/json": {
          "entry": "$input.json('entry')",
          "method": "$context.httpMethod"
        }
      },
      "responses": {
        "400": {
          "statusCode": "400"
        },
        "default": {
          "statusCode": "200",
          "responseParameters": {},
          "responseModels": {
            "application/json;charset=UTF-8": "Empty"
          },
          "responseTemplates": {
            "text/plain": "$input.path('$')"
          }
        }
      }
    }
  ],
  "events": [],
  "environment": {
    "SERVERLESS_PROJECT": "${project}",
    "SERVERLESS_STAGE": "${stage}",
    "SERVERLESS_REGION": "${region}"
  },
  "vpc": {
    "securityGroupIds": [],
    "subnetIds": []
  }
}
```

### handler.js

```handler.js
'use strict';

const request = require('request');

const FB_MESSANGER_TOKEN = 'ここにtokenを書く';

module.exports.handler = function(event, context, cb) {
  
  switch (event.method.toUpperCase()) {
    case 'GET': {
      const validRequest = event.verify_token === FB_MESSANGER_TOKEN;
      return cb(null, validRequest ? event.challenge : 'Error, wrong validation token');
    }
    
    case 'POST': {
      event.entry[0].messaging.filter(m => m.message && m.message.text).forEach(m => sendTextMessage(m.sender.id, m.message.text));
      return cb(null, 'OK');
    }
    
    default: return cb('Error, Invalid Method');
  }
};

function sendTextMessage(sender, text) {
  const messageData = {
    text:text
  }

  request({
    url: 'https://graph.facebook.com/v2.6/me/messages',
    qs: {
      access_token: FB_MESSANGER_TOKEN
    },
    method: 'POST',
    json: {
      recipient: {
        id: sender
      },
      message: messageData,
    }
  }, function(error, response, body) {

    if (error) {
      console.log('Error sending message: ', error);
    } else if (response.body.error) {
      console.log('Error: ', response.body.error);
    }
  });
}
```


## 参考
* [Messenger Platform - Getting Started](https://developers.facebook.com/docs/messenger-platform/quickstart)
* [ジャスト30分！FBメッセンジャーbotをとりあえず作ってみる手順まとめ](https://bita.jp/dml/facebookbot_exp)
* [Serverless](https://github.com/serverless/serverless)
* [serverless-optimizer-plugin](https://github.com/serverless/serverless-optimizer-plugin)
* [optimizer-pluginを使って、es6(es2015)でserverless frameworkのコードを書く](http://qiita.com/mpppk/items/a8517404361120d2b2b3)
* [AWS Lambdaを活用したServerless Frameworkを触ってみる](http://qiita.com/susieyy/items/1c2af0ef7b88b742c37a)