日報ボット kintone 版

日報ボット kintone 版

はじめに

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

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

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

ボット用に、新しくメールアドレスを用意します。例えば、日報ボット用に用意したアドレスが hubot-nippo@example.com だとすると、hubot-nippo@example.com が direct のログインID、hubot-nippoが kintone のログインIDになるように登録します。

direct

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

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

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

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

kintone

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

cybozu.com 共通管理からユーザを追加します。cybozu.com 共通管理のご利用方法については、こちらのヘルプページをご参照ください。共通管理のご利用には権限が必要です。お持ちでない方は、管理者にご連絡下さい。

ログインIDを入力するとき、directに登録したメールアドレスが xxx@yyy.com だとすると、xxxが kintone のログインIDになるようにします。

日報アプリをアプリストアから追加します。アプリストアからのアプリ追加方法については、こちらのヘルプページをご参照ください。

日報ボットの実行には、アプリの管理権限が必要です。アプリの設定画面から、上記のアカウントに「アプリ管理」権限を追加してください。アプリにアクセス権を設定する方法については、こちらのヘルプページをご参照ください。

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

kintone

kintone へのアクセスには、パスワード認証(X-Cybozu-Authorization)が利用されます。

以下の環境変数に、取得したアカウントの「ログイン名:パスワード」をBASE64エンコードして設定します。

$ export HUBOT_CYBOZU_NIPPO_AUTH=`echo -n 'nippo_login_id:password' | base64`

以下の環境変数に、kintone REST API のリクエストURIを設定します。

$ export HUBOT_CYBOZU_URI=https://(サブドメイン名).cybozu.com/k/v1

以下の環境変数に、アプリの情報を取得するアプリIDを指定します。

$ export HUBOT_CYBOZU_NIPPO_APPID=5

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

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

$ bin/hubot

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

  • daab-kintone-nippo
    • 基本セット + 日報ボットのスクリプト
    • 履歴
      • 2017/04/07 github に移行
      • 2015/03/13 セレクトスタンプの活用。会話時間切れの設定。会話終了時に退出。
      • 2014/12/15 初版