5分でつくるLINEBot（改良版）

# はじめに
この記事は[5分でつくるLINEBot](https://qiita.com/drafts/0d121ee6d48a8c1634fc)の改良版の記事です
プログラミング初心者でも5分でLINEBotが作れるように手順を極力簡単にしました。
LINEBot自作のとっかかりとして活用してください！

# 前提
・Googleアカウントを持っていること
・[LINE Developers](https://developers.line.biz/ja/)にログインできること
・[LINE Messaging API](https://developers.line.biz/ja/docs/messaging-api/overview/) についてある程度理解しておくと進めやすいです

# 手順
## 目次
1. LINE Developersにログインし、設定を行い、トークンを発行します
1. LINEBotのテンプレートをコピーし自分のGoogleフォルダに移します
1. GoogleAppScriptのコードにトークンを書き込んで、デプロイをします
1. デプロイすると発行されるURLをLINE Developersで設定します
1. オウム返しBotが完成！

という手順で、5分でできます！

## LINE Developersにログインし、設定を行い、トークンを発行します
[LINE Developers](https://developers.line.biz/ja/)にLINEのアカウントでログインします

![スクリーンショット 2022-05-15 0.33.40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/2a0f327d-9d4a-2487-41e6-71010f240588.png)

適当な名前でプロバイダーを作成します
![スクリーンショット 2022-05-15 0.33.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/8452e972-1325-c43a-dbc9-2cd4d60897cd.png)

![スクリーンショット 2022-05-15 0.34.35.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/a60fc6ad-0728-930a-3937-399ce7c8ed4d.png)

MessagingAPIでチャンネルを作成します
![スクリーンショット 2022-05-15 0.34.48.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/c04425e2-d525-c1bd-6201-c043fffa7b0b.png)


チャンネルの必須項目を適当に埋めて作成します
![スクリーンショット 2022-05-15 0.35.05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/f1c060d3-27f5-d5ca-8255-ba7b98c2e2cf.png)

![スクリーンショット 2022-05-15 0.35.58.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/4f651955-b322-3f39-0d98-9c193323520a.png)
![スクリーンショット 2022-05-15 0.36.04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/d3f76200-8d0c-194a-82c8-5df33497a55a.png)

MessagingAPI設定から設定を行います
![スクリーンショット 2022-05-15 0.43.00.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/bbee39d4-8ed9-8849-3f3c-531e7ad8b49a.png)

設定するのは2つです
・応答メッセージをオフにする
・チャンネルアクセストークンを発行し、あとで使うのでコピーしておく
![スクリーンショット 2022-05-15 0.43.58.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/28f536a2-2537-1412-bf3e-0ff578e94896.png)

## LINEBotのテンプレートをコピーし自分のGoogleフォルダに移します
LINEBotのテンプレートを用意しているので 
https://docs.google.com/spreadsheets/d/1qGT2aUAJwcfssiLk9065L2F0OLoqaa3OJ0HSWX5jyCk/edit#gid=0
を開いて、自分のフォルダにコピーします

![スクリーンショット 2022-05-15 0.48.28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/eb95ea5e-6ca6-2e27-07c6-eaf83829c8ae.png)

![スクリーンショット 2022-05-14 19.57.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/d72c0402-e31b-ee81-2d31-16fe87e45ed4.png)

## GoogleAppScriptのコードにトークンを書き込んで、デプロイをします

:::note
これ以降は、コピーした自分のスプレッドシートで作業します
コピー元のスプレッドシートはもう利用しないので閉じてください
:::

スプレッドシートを開き、拡張機能 > Apps Scriptを開きます
![スクリーンショット 2022-05-14 19.57.22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/80158186-b2bb-a101-c89e-bce54344f0e7.png)

さきほどの手順でコピーしたチャンネルアクセストークンを1行目に貼り付け、保存します（ ''の中の文字を書き換えてください ）
![スクリーンショット 2022-05-14 19.58.33.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/aee8e912-651d-cd30-db6b-9ff76aad78e8.png)

画面右上の「デプロイ」から「新しいデプロイ」を選択します
![スクリーンショット 2022-05-14 19.58.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/39c5ce0c-53e4-a955-1d54-1c64d0b90fc1.png)

左の歯車のアイコンを押し、「ウェブアプリ」をクリックします
![スクリーンショット 2022-05-14 19.59.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/234fbc3d-678e-9d7a-4425-120322c00dff.png)

以下のように設定して、デプロイを押します
「説明文」 => 適当に入力
「次のユーザーとして実行」 => 自分
「アクセスできるユーザー」 => 全員
![スクリーンショット 2022-05-14 19.59.40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/5e891f07-b682-78c7-544b-ed9ee89dec59.png)


アクセスを承認をクリック
![スクリーンショット 2022-05-14 20.00.23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/b7cf4a54-0eb3-6578-dd23-09960fb4e3ae.png)

アカウントを選択し
![スクリーンショット 2022-05-14 20.00.31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/04d52934-1729-f7fa-c146-b67af5879635.png)

詳細をクリック
![スクリーンショット 2022-05-14 20.00.39.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/34f71886-242b-0cba-9f7a-46ee42f161ea.png)
ページへ移動
![スクリーンショット 2022-05-14 20.00.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/a5e89597-6788-b6bc-d5d2-8d90b2291fd1.png)

許可をクリック
![スクリーンショット 2022-05-14 20.00.54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/0c393bb5-a512-fcbb-7087-e2815a296750.png)

これでデプロイ完了です
次で使うのでURLをコピーしてください
![スクリーンショット 2022-05-14 20.01.06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/7849767e-89c4-3228-6eb0-b1a84b902a8e.png)

## デプロイすると発行されるURLをLINE Developersで設定します
再びLINE Developersに戻ります

Webhook URLを編集し、先ほどのURLを設定します
![スクリーンショット 2022-05-14 20.01.39.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/78186ca7-9fc8-d938-56cb-23db192e238f.png)
![スクリーンショット 2022-05-14 20.01.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/08175b8a-00f5-be0e-ed7e-63f974cce1aa.png)

検証を押して、成功と出たらOKです
![スクリーンショット 2022-05-14 20.01.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/ae44f53d-4c2b-1efe-20a8-cf894a741c90.png)

Webhookの利用をONにします
![スクリーンショット 2022-05-17 18.05.40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/3a140b03-5c1b-6ba8-2667-423b3b1b3265.png)


以上で実装は完了です。
QRコードを読み込んでボットと友達になり、メッセージを送ってみるとそのまま返却してくれます

![スクリーンショット 2022-05-15 1.11.41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/78faafc0-56f7-19a3-5abe-f9a89c1fc56a.png)

# ソースコードに変更を加えたら
ソースコードに変更を加えたら再度デプロイが必要です
![スクリーンショット 2022-05-17 18.04.42.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/aea2d645-60ee-2daf-a0d5-e4a617b9ad5d.png)

新バージョンを選択してデプロイ（URLは変更されないので、LINEDevelopersで操作は不要です）
![スクリーンショット 2022-05-17 18.04.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/7853aa22-806f-29a0-7605-e2bbcff8288c.png)

# コードの解説

```js
var CHANNEL_ACCESS_TOKEN = '①で発行したチャネルアクセストークンを貼り付け'; 
const logSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('log');
var replyToken, json

//ポストで送られてくるので、ポストデータ取得
function doPost(e) {

  // ① ========================================
  // 動作確認用のログ出力
  // log_to_sheet("A", "doPost")

  // ② ========================================
  // LINEBotから送られてきたデータを、プログラムで利用しやすいようにJSON形式に変換する
  json = JSON.parse(e.postData.contents);

  // ③ ========================================
  //返信するためのトークン取得
  replyToken= json.events[0].replyToken;
  if (typeof replyToken === 'undefined') {
    return;
  }

  // ④ ========================================
  // 返信するメッセージを作成
  messages = test_message()

  // テスト動作ができたら、your_messageの中身を追加して、自分のオリジナルのLINEBotにしてみましょう
  // messages = your_message()

  // メッセージの中身を確認したい時には以下のコメントアウトを外して、sheet「log」に書き込まれる内容を確認しましょう
  // log_to_sheet("A", messages)

  // ⑤ ========================================
  // line-bot-sdk-gas のライブラリを利用しています ( https://github.com/kobanyan/line-bot-sdk-gas )
  const linebotClient = new LineBotSDK.Client({ channelAccessToken: CHANNEL_ACCESS_TOKEN });

  // メッセージを返信
  linebotClient.replyMessage(replyToken, messages);

  // ⑥ ========================================
  return ContentService.createTextOutput(JSON.stringify({'content': 'post ok'})).setMimeType(ContentService.MimeType.JSON);
}

// 動作確認用のオウム返しのメッセージを作成する関数
function test_message() {
  //送られたLINEメッセージを取得
  var user_message = json.events[0].message.text;  

  //送られたメッセージをそのままオウム返し
  var reply_messages = [user_message];
 
  // メッセージを返信
  var messages = reply_messages.map(function (v) {
    return {'type': 'text', 'text': v};    
  });

  return messages
}

// 自分で編集する関数
function your_message() {
  // 好きな処理を書く
  var your_messages = [{'type':'text', 'text': '返信したいメッセージ'}]
  return your_messages
}

// 処理の確認用にログを出力する関数
function log_to_sheet(column, text) {
  if(logSheet.getRange(column + "1").getValue() == ""){
    lastRow = 0
  } else if(logSheet.getRange(column + "2").getValue() == ""){
    lastRow = 1
  } else {
    var lastRow = logSheet.getRange(column + "1").getNextDataCell(SpreadsheetApp.Direction.DOWN).getRow();
    // 無限に増えるので1000以上書き込んだらリセット
    console.log("lastRow", lastRow)
    if(lastRow >= 1000){
      logSheet.getRange(column + "1:" + column + "10").clearContent()
      lastRow = 0
    }
  }
  var putRange = column + String(lastRow + 1)
  logSheet.getRange(putRange).setValue(text);
}

```

## ① log_to_sheet("A", "doPost")
GASでLINEBotを作る際につまづきやすいところとして、エラーが起きたときに何が起きてるのかわからない！というのがあります。
それを解消するために、スプレッドシートに「log」というシートを用意し、今どこまで処理が進んでいるのか？というのを調べるために、log_to_sheetという関数を用意しました。
```js
log_to_sheet("出力する列", 出力する内容)
```
という内容で呼び出すと利用でき、
```js
log_to_sheet("A", "doPost")
```
だと、シート「log」のA列の一番上の空いているセルに"doPost"と書き込むことができます。
これを出力していると、LINEBotが動かない時に、そもそもLINEBotからGASに処理が飛んできているのか？という判定に使え、doPostという文言が出力されていないと、「LINEDevelopersに貼り付けたWebhookURLが間違っていないか？」と効率よく検証をすることができます。

## ② json = JSON.parse(e.postData.contents);

[LINE 公式のMessaging API](https://developers.line.biz/ja/docs/messaging-api/overview/)から画像を拝借しました。
![messaging-api-architecture.f40bffbb.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/9e5856f0-2378-11ea-3885-a9bd773074aa.png)

この記事では、この画像の右側のYOUR SYSTEMの部分をGASで作っています![スクリーンショット 2023-01-02 2.22.13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/9a4ba1df-308f-dbee-3bd2-102589463c94.png)
　LINEから文字が入力された際、「入力された文字」は "e.postData.contents" という変数の中に入っています。
そのほかに、リプライトークンと呼ばれる「特定の相手に返信をするための合言葉」も入っていて、それらをプログラム上で扱いやすいように、JSONと呼ばれるデータ形式に変換します。

## ③ 返信するためのトークン取得
リプライトークンと呼ばれる「特定の相手に返信をするための合言葉」は、先ほど変換したjsonのデータから以下のように取り出せます。
```js
replyToken= json.events[0].replyToken;
```

もし何らかのアクシデントでリプライトークンが入手できなかった場合は、その後の処理が無駄になるので、ここで処理を中断させます
```js
  if (typeof replyToken === 'undefined') {
    return;
  }
```

## ④ 返信するメッセージを作成
返信するメッセージは以下の形式にする必要があります
```js
[{'type':'text', 'text':'メッセージ'}]
```
参考：[テキストメッセージの公式リファレンス](https://developers.line.biz/ja/reference/messaging-api/#text-message)
スタンプなど他の形式で送りたい場合は、[公式リファレンス](https://developers.line.biz/ja/reference/messaging-api/#message-objects)で調べてみてください

送られてきたメッセージをそのままオウム返しにするtest_messageという関数を用意しているので
```js
messages = test_message()
```
と書けば、変数messagesに送られてきたメッセージがそのまま詰められた返信メッセージのデータが挿入されます。自分用のプログラムを書く時にも返信する内容を以下のようにしてあげればOKです。
```js
[{'type':'text', 'text':'メッセージ'}]
```

## ⑤ line-bot-sdk-gas のライブラリを利用してクライアントを生成
前回の記事([5分でつくるLINEBot](https://qiita.com/drafts/0d121ee6d48a8c1634fc))から大きく変えた点です。
[LINE Messaging API を Google Apps Script で利用するためのライブラリ作りました](https://qiita.com/kobanyan/items/1a590cda9deb85e86296)の記事で紹介されているライブラリをスプレッドシートに組み込んでいます。

このライブラリを使うことで、返信をするためのコードがグッと少なくなります
```js:ライブラリなし
UrlFetchApp.fetch('https://api.line.me/v2/bot/message/reply', {
  'headers': {
    'Content-Type': 'application/json; charset=UTF-8',
    'Authorization': 'Bearer ' + CHANNEL_ACCESS_TOKEN,
  },
  'method': 'post',
  'payload': JSON.stringify({
    'replyToken': replyToken,
    'messages': messages,
  }),
});
```

```js:ライブラリあり
const linebotClient = new LineBotSDK.Client({ channelAccessToken: CHANNEL_ACCESS_TOKEN });
linebotClient.replyMessage(replyToken, messages);
```

### そもそもライブラリとは？
GASでは、作ったプログラムを他の人が利用できるようにする機能があり、先ほどの記事で紹介されていたライブラリを組み込んで、このスプレッドシートでも利用できるようにしています。
このline-bot-sdk-gasというライブラリは、Node.jsで利用できる「SDK」（ソフトウェア開発キット）と同じようなことがGASでも出来るように作られているため、[Messaging API公式リファレンス](https://developers.line.biz/ja/reference/messaging-api/#send-reply-message)のNode.js用のサンプルコードを参考に開発を進めることができます
![スクリーンショット 2023-01-02 2.55.16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/27192/ff41ba94-420a-591f-0d88-b7b42ff26a30.png)

実際に使える関数の詳しい内容は[こちら](https://github.com/kobanyan/line-bot-sdk-gas#%E3%83%A1%E3%82%BD%E3%83%83%E3%83%89)から確認してください。

## ⑥ 関数の終了をLINEBotに伝える
LINEBotに処理が終わったことを伝えます。ここは特に変更が必要になることはないと思います。
```js
return ContentService.createTextOutput(JSON.stringify({'content': 'post ok'})).setMimeType(ContentService.MimeType.JSON);
```

# おわり
以上、簡単にLINEBotを作るやり方の紹介でした！