議事録ボット G Suite 版

議事録ボット G Suite 版

はじめに

このドキュメントは、direct と Google Apps を連携させた議事録ボット(以下、ボット)について、各種設定から実行するまでの手順書となっています。そのため、direct および Google Apps の両サービスをご契約・ご利用中のものとしています。

まだ、ご利用でない方は、direct および Google Apps のそれぞれに無料トライアルがありますので、そちらをご参照ください。

ボット用アカウントの取得

ボット用に、新しくメールアドレスを用意します。

direct

通常のユーザと同じように、ボット用アカウントを作成します。

組織の管理ツールから、ボット用メールアドレスに招待メールを送信します。 管理ツールのご利用には権限が必要です。お持ちでない方は、契約者もしくは管理者にご連絡下さい。

組織に招待されると、ボット用メールアドレスにメールが届きます。 メールに記載されているURLをクリックしてアカウント登録手続きをしてください。

ログインページからボット用メールアドレスでログインします。 招待を承認する画面が開きますので、その画面で「承認」を選択してください。 次に、設定>プロフィール編集より、表示名とプロフィール画像をボット用に変更します。

node のインストール

https://nodejs.org/ から最新版をインストールします。v6.2.1 で動作確認しています。

サンプルプログラムの設定

サンプルプログラムをダウンロードして展開します。以降は、この展開したディレクトリ(フォルダ)にて、コマンドライン(コマンドプロンプト)で作業することになります。

direct

direct へのアクセスには、アクセストークンが利用されます。アクセストークンの取得には、アクセストークンを環境変数に設定していない状態で、以下のコマンドを実行し、ボット用のメールアドレスとパスワードを入力します。

$ bin/hubot
Email: loginid@bot.email.com
Password: *****
0123456789ABCDEF_your_direct_access_token

以下の環境変数に、アクセストークンを設定します。

$ export HUBOT_DIRECT_TOKEN=0123456789ABCDEF_your_direct_access_token

Google Apps

Google Apps へのアクセスには、Google Apps Script の「Webアプリケーションとして導入」が利用されます。

Google Drive で新しいGoogle Apps Script を作成します。テンプレートとしては「ウェブアプリケーションとしてのスクリプ」を選択します。次に、議事録ボット用の Google Apps Script をダウンロードして、テキストファイルで開いてその内容で置換します。

メニューから、公開 > 「Webアプリケーションとして導入」し、議事録ボットからアクセスできるように適切に権限を設定して公開します。このとき表示される「現在のウェブ アプリケーションの URL」を以下の環境変数に設定します。

export GAPPS_URL=https://script.google.com/a/macros/...

議事録テンプレート

Google Drive に 議事録ひな形というファイル名でテンプレートファイルを置きます。

テンプレートファイルのサンプルをダウンロードできます。このファイルは Word 形式になっていますので、Google Driveにアップロードするときは Google document に変換してください。

サンプルプログラムの実行

以下のコマンドを実行します。

$ bin/hubot

サンプルプログラムのダウンロード

  • daab-googleapps-minutes
    • 基本セット + 議事録ボットスクリプト
    • 変更履歴
      • 2017/04/07 github へ移行
      • 2015/02/04 エラーが発生したとき、コンソールに表示。
      • 2015/01/06 Google 側の API が更新されたため、Google Apps Script を更新。
      • 2014/12/15 初版
  • googleapps-minutes.gs
    • 議事録ボットスクリプトから呼び出される Google Apps Script
  • 議事録ひな形.docx
    • 議事録ボットスクリプトで利用する議事録テンプレートのサンプル