年: 2018年

Hangouts Chatで、GASで作ったChat Botと会話するとき、Chat BotのGASプログラム側では”onMessage(event)”関数が呼び出されている。この関数の中で、ユーザからの送られてきたテキストの中身を処理することで、ユーザと様々なやり取りをすることができる。

function onMessage(event) {
  return { "text": "このメッセージをチャットで返す" };
}

ちなみに、ユーザ側が入力した内容は、`event.message.text`で取得することができる。

Hangouts Chatで、GASで作ったChat Botを呼び出すとき、関数のonAddToSpace(event)がHangouts Chat APIから呼び出される。このイベントが発生するのは、Chat Botを追加したときのみ。

function onAddToSpace(event) {
  return { "text": "このメッセージを返す" };
}

■Googleのサンプルプログラム。

function onAddToSpace(event) {
  var message = "";

  if (event.space.type == "DM") {
    message = "Thank you for adding me to a DM, " + event.user.displayName + "!";
  } else {
    message = "Thank you for adding me to " + event.space.displayName;
  }

  return { "text": message };
}

eventは、オブジェクトで、Hangouts Chatから渡される。このオブジェクトの中に、ユーザ名やDMかどうかなどの情報が入っている。

returnで指定した内容がユーザのチャットに返信される。

基本的に、開始から始まり、質問相手が質問をやめるまで、「進行」のステップが繰り返さされる。

開始：　ウェルカムメッセージ
↓
進行：　相手を次のステップに導く質問や回答。
↓
（ユーザからの応答）
↓
進行：　相手を次のステップに導く質問や回答。

文体といっても大したことではなく、Googleの指針に従うだけ。

• 文章は簡単にする
• １つの行動を促すフレーズに限定し、できるだけ関連性の高い情報を提示する。
• 何ができて、何ができないかを明確にする。
• キャラクター化しない（個性化しない）

最後の「キャラクター化しない」は難しいところ。無機質な方がよいのか、フレンドリーな方がよいのか。欧米では無機質なインターフェースの方がよいかもしれないが、日本ではキャラクター性を持たせるというのも在り。

Botは、チャットルーム内、もしくはBotにDM（ダイレクトメッセージ）を送信して、サービスを使用できるように会話型インターフェースを提供する。

Hangouts ChatのためのBotを作成すると、他のGoogleサービス、外部サービス等を会話型インターフェイスにカプセル化できる。

Hangouts Chatは、エンドポイント経由でBotと通信する。エンドポイントは以下の2種。

• HTTP（Webサービス）エンドポイント
• クラウドPub/Subエンドポイント

Botの応答は、テキストか、カードになる。カードは、「キー／値ペア」「イメージ」「アイコン」などの見た目にこった形式で応答できる。

Chat Botをデプロイするときに、「最新」の「Deployment ID」を指定している場合、GAS上でコードを書き換えて保存されたタイミングで、自動的に最新が公開される。

そのため、バージョン管理やテスト管理を行う場合には、デプロイするときに、公開バージョンを作成して、指定したほうがよい。