Safx: TypetalkのWebhookとNTTドコモの雑談対話APIとGoogle Apps Scriptで雑談ボットをつくる

先週、TypetalkにWebhookの機能が追加されました。これは、ボットに話しかけると、指定されたURLにJSONをポストしてくれる機能で、これによってボットを簡単に作ることができるようになりました。

そこで、ちょうど最近存在を知ったばかりのNTTドコモの雑談対話APIをGoogle Apps Scriptと組み合わせて、Typetalk用の雑談ボットを作ってみました。

実際の利用状況は次のような感じ。思ったよりも早くレスポンスが返されてきました。

雑談ボットは次のGistにあります。

Typetalk Docomo-Dialogue bot

ボットのしくみ

ボットの動作の概要を簡単に説明します。

ボットにメンションしたとき、Typetalkで登録したURLにメンションの内容がJSONでPOSTされます。
GAS (Google Apps Script)では、POST処理のためにdoPostという関数が実行されます。
1. まず、JSONからメッセージを取り出して、自分へのメンション (@foobar+など) を取り除きます。これは、自分のメッセージでさらにWebhookが実行されるのを防ぐためです。
2. GASのライブラリにあるUrlFetchAppを利用して雑談対話APIへJSONを投げます。
雑談対話APIからJSONが返されます。
返されたJSONから雑談対話のメッセージを取り出して、Typetalk用のJSONに入れて、(Typetalkトークンを利用して) ポスト専用URLに投げます。

ボットのコード (一部抜粋)

メインではない個所は省いています。全コードはGistにありますのでそちらを参照してください。

TypetalkからWebhookのデータを受けるあたりのコードは次の通り。 eにJSON文字列があるのでパースしてメッセージを取り出しています。

function doPost(e) {
  var jsonString = e.postData.getDataAsString();
  var post = JSON.parse(jsonString).post;
  var user = '@' + post.account.name
  var message = getMessage(post.message);

  var responseMessage = getDialogueMessage(post.account.id, message)
  postMessage(user, responseMessage)
}

雑談対話APIとのデータやりとりのコードはこんな感じ。 contentTypeをtext/jsonにして、payloadをJSON.stringifyにする必要があるとこあたりで少しはまりました。

function getDialogueMessage(userId, mes) {
  var dialogue_options = {
    'utt': mes
  }
  var options = {
    'method': 'POST',
    'contentType': 'text/json',
    'payload': JSON.stringify(dialogue_options)
  };
  var response = UrlFetchApp.fetch(dialogueUrl, options);
  var content = JSON.parse(response.getContentText());
  return content.utt;
}