#はじめに
LINEのFAQボットつくりたいなー、と思い立ち、その時ついでに思い付いたいくつかの自分のニーズにこたえられる要件を追加して実装してみました。思ったのはこんなの。
- LINEのBOT
- FAQのメンテナンスが簡単
- サーバー環境の構築とかがめんどくさいのでそれも簡単にやりたい
⇒ Google Spread Sheet × Google Apps Script × LINE の組み合わせが最強だった。
##やったこと
- LINE上で質問をすると、それに対してテキストの部分一致で対象の「質問」を抽出して、それに対する「回答」を出してくれるFAQBOTを作りました。
- 質問・回答の追加・更新などのメンテナンスはGoogle Spread Sheet上で管理。
- あと「誰が」「どんな質問したか」もわかるようにしてあります。
##準備するもの
ホントのホントに1からやってみようと思ってやったので、準備したのはこのぐらいです。
さすがにここから躓くことはないかな。。。
- LINEのアカウント
- Googleのアカウント
#手順
##作業1. LINEの開発用Channel作成 ～ TOKEN発行
連携させたいLINE公式アカウントのChannel発行とTOKENの発行をまずやります。
といっても、私はこちらの記事の「Channelを作成する」までを参考にさせていただきました。
そのまんまで問題ないです（記載されてる通り、developersの画面は後々利用するので、発行後はひらきっぱにしておいてください）。
##作業2. Google Spread Sheet上での準備
スプレッドシートの準備をします。
スプレッドシートを作成したら、後々使うシートを２つ作成して下さい。
その名も「faq」と「maybe」と「debug」。
シートを作成したら「faq」のシートに、準備用でテキトーにFAQ用の質問と回答をA列とB列それぞれに記載しておきましょう。
##作業3.スクリプトエディタでGASを編集
スクリプトエディタを開きます。
開いたスクリプトエディタ上に、次のソースコードをコピペ。
// 利用しているシート
var SHEET_ID = '（①スプレッドシートのIDをコピペ）';
// 利用しているSSのシート名（※変えるとみえなくなる）
var SHEET_NAME = 'faq';
// 利用しているもしかしてSSのシート名（※変えるとみえなくなる）
var SHEET_NAME_MAYBE = 'maybe';
// LINE Message API アクセストークン
var ACCESS_TOKEN = '（②LINEのdevelopersアカウント上で取得したTOKENをコピペ）';
// 通知URL
var PUSH = "https://api.line.me/v2/bot/message/push";
// リプライ時URL
var REPLY = "https://api.line.me/v2/bot/message/reply";
// プロフィール取得URL
var PROFILE = "https://api.line.me/v2/profile";
/**
* doPOST
* POSTリクエストのハンドリング
*/
function doPost(e) {
var json = JSON.parse(e.postData.contents);
reply(json);
}
/**
* doGet
* GETリクエストのハンドリング
*/
function doGet(e) {
return ContentService.createTextOutput("SUCCESS");
}
/**
* reply
* ユーザからのアクションに返信する
*/
function reply(data) {
// POST情報から必要データを抽出
var lineUserId = data.events[0].source.userId;
var postMsg = data.events[0].message.text;
var replyToken = data.events[0].replyToken;
var action = data.events[0].message.action;
// 記録用に検索語とuserIdを記録
// debug(postMsg, lineUserId);
debug(action, lineUserId);
// 検索語に対しての回答をSSから取得
var answers = findResponseArray(postMsg);
// 回答メッセージを作成
var replyText = '「' + postMsg + '」ですね。かしこまりました。以下、回答です。';
// 回答の有無に応じて分岐
if (answers.length === 0) {
// 「類似の検索キーワード」がないかチェック
var mayBeWord = findMaybe(postMsg);
if (typeof mayBeWord === "undefined") {
// 回答がない場合の定型文
sendMessage(replyToken, '答えが見つかりませんでした。別のキーワードで質問してみてください。');
} else {
sendMayBe(replyToken, mayBeWord);
}
} else {
// 回答がある場合のメッセージ生成
answers.forEach(function(answer) {
replyText = replyText + "\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝\n\nQ：" + answer.key + "\n\nA：" + answer.value;
});
// 1000文字を超える場合は途中で切る
if (replyText.length > 1000) {
replyText = replyText.slice(0,1000) + "……\n\n＝＝＝＝＝＝＝＝＝＝＝＝＝\n\n回答文字数オーバーです。詳細に検索キーワードを絞ってください。";
}
// メッセージAPI送信
sendMessage(replyToken, replyText);
}
}
// SSからデータを取得
function getData() {
var sheet = SpreadsheetApp.openById(SHEET_ID).getSheetByName(SHEET_NAME);
var data = sheet.getDataRange().getValues();
return data.map(function(row) { return {key: row[0], value: row[1], type: row[2]}; });
}
// SSから「もしかして」データを取得
function getMayBeData() {
var sheet = SpreadsheetApp.openById(SHEET_ID).getSheetByName(SHEET_NAME_MAYBE);
var data = sheet.getDataRange().getValues();
return data.map(function(row) { return {key: row[0], value: row[1], type: row[2]}; });
}
// 単語が一致したセルの回答を配列で返す
function findResponseArray(word) {
// スペース検索用のスペースを半角に統一
word = word.replace(' ',' ');
// 単語ごとに配列に分割
var wordArray = word.split(' ');
return getData().reduce(function(memo, row) {
// 値が入っているか
if (row.value) {
// AND検索ですべての単語を含んでいるか
var matchCnt = 0;
wordArray.forEach(function(wordUnit) {
// 単語を含んでいればtrue
if (row.key.indexOf(wordUnit) > -1) {
matchCnt = matchCnt + 1;
}
});
if (wordArray.length === matchCnt) {
memo.push(row);
}
}
return memo;
}, []) || [];
}
// 単語が一致したセルの回答を「もしかして」を返す
function findMaybe(word) {
return getMayBeData().reduce(function(memo, row) { return memo || (row.key === word && row.value); }, false) || undefined;
}
// 画像形式でAPI送信
function sendMessageImage(replyToken, imageUrl) {
// replyするメッセージの定義
var postData = {
"replyToken" : replyToken,
"messages" : [
{
"type": "image",
"originalContentUrl": imageUrl
}
]
};
return postMessage(postData);
}
// LINE messaging apiにJSON形式でデータをPOST
function sendMessage(replyToken, replyText) {
// replyするメッセージの定義
var postData = {
"replyToken" : replyToken,
"messages" : [
{
"type" : "text",
"text" : replyText
}
]
};
return postMessage(postData);
}
// LINE messaging apiにJSON形式で確認をPOST
function sendMayBe(replyToken, mayBeWord) {
// replyするメッセージの定義
var postData = {
"replyToken" : replyToken,
"messages" : [
{
"type" : "template",
"altText" : "もしかして検索キーワードは「" + mayBeWord + "」ですか？",
"template": {
"type": "confirm",
"actions": [
{
"type":"postback",
"label":"はい",
"data":"action=detail",
},
{
"type": "message",
"label": "いいえ",
"text": "いいえ、違います。"
}
],
"text": "答えが見つかりませんでした。もしかして検索キーワードは「" + mayBeWord + "」ですか？"
}
}
]
};
return postMessage(postData);
}
// LINE messaging apiにJSON形式でデータをPOST
function postMessage(postData) {
// リクエストヘッダ
var headers = {
"Content-Type" : "application/json; charset=UTF-8",
"Authorization" : "Bearer " + ACCESS_TOKEN
};
// POSTオプション作成
var options = {
"method" : "POST",
"headers" : headers,
"payload" : JSON.stringify(postData)
};
return UrlFetchApp.fetch(REPLY, options);
}
/** ユーザーのアカウント名を取得
*/
function getUserDisplayName(userId) {
var url = 'https://api.line.me/v2/bot/profile/' + userId;
var userProfile = UrlFetchApp.fetch(url,{
'headers': {
'Authorization' : 'Bearer ' + ACCESS_TOKEN,
},
})
return JSON.parse(userProfile).displayName;
}
// userIdシートに記載
function lineUserId(userId) {
var sheet = SpreadsheetApp.openById(SHEET_ID).getSheetByName('userId');
sheet.appendRow([userId]);
}
// debugシートに値を記載
function debug(text, userId) {
var sheet = SpreadsheetApp.openById(SHEET_ID).getSheetByName('debug');
var date = new Date();
var userName = getUserDisplayName(userId);
sheet.appendRow([userId, userName, text, Utilities.formatDate( date, 'Asia/Tokyo', 'yyyy-MM-dd HH:mm:ss')]);
}
コピペした中の「①スプレッドシートのIDをコピペ」にスプレッドシートのIDをコピペ
（まんまかよ）
※スプレッドシートのIDは「スプレッドシート画面を開いた時のURLのここ」です。
続いてコピペした中の「②LINEのdevelopersアカウント上で取得したTOKENをコピペ」にスプレッドシートのIDをコピペ
（再度まんま）
※TOKENは、さっき作ったLINE developersのアカウント画面で発行したもの。ここ。
（または再発行してもよし）
##作業3. アプリケーションを公開
GASの画面で「ウェブアプリケーションとして導入」を選択
こんな感じで入力。「導入」を選択。
「許可を確認」を選択
Googleのアカウント承認画面が出るので、ログイン中のアカウントを選択します。
なんかドキドキしつつ進めます。「詳細」から
安全ではないページに移動します（ドキドキした）
「許可」を選択
画面に戻ってきてウェブアプリケーションのURLが発行されるので、こいつをコピペします
##作業4. LINEアカウントでWebhookの設定
今しがた発行された「ウェブアプリケーションのURL」を、LINE developersの「WEBhook URL」に設定します。
（一応接続確認もしましょう）
##作業5. できた（はず）
諸々設定がうまくいっていれば、これで発行されたLINE公式アカウント宛てにLINEのメッセージを送ると、質問に対して回答が返ってくるはずです。
#おしまい
どっちかというと非エンジニア向けにいちいちキャプチャをとりながらやってみました。
ソースいじりたい方はぜひいじってみて下さい。
（というか、エンジニアの方からはソースの至らぬところに対してのアドバイスをいただきたいです。。。）
あと、「やってるけど動かねえ！」みたいなあるあるのトラブルシューティングもあるんですが、それはちょっとボリューム増えちゃうので、次回とかにしたいと思います。
おわり。