チャットボット作成(Ⅲ.Office365連携編)

Office365のAPI(Microsoft Graph API)を利用して、スケジュールの確認や会議室の予約などといったユーザー操作をチャットボットが代わりに行うことができます。
※本作業を行う場合は、『Office365ビジネスプランへの登録』が必要となります。

なお、この機能はベータ機能を有効化することでお試しいただけます。
ベータ機能は、将来的に互換性のない変更や機能の廃止が行われる可能性があります。予めご了承ください。
ベータ機能を有効にする方法は、 こちら をご覧ください。

それでは、Office365連携チャットボットをつくっていきましょう。

Office365外部システム連携の流れ

Office365とDialogPlayをつなぐ方法について、まずは全体の流れをご説明します。


STEP1. (Microsoft)Application Registration Portalにアプリケーションを登録する
STEP2. (DialogPlay)Office365とDialogPlayをつなぐ
STEP3. (DialogPlay)Office365のサービスをつかう
STEP4. (DialogPlay)チャットボットをつくる
STEP5. (DialogPlay)チャットボットとしゃべる

【テンプレートを利用してOffice365連携を行う場合】
DialogPlayのテンプレート「【サンプル】Office365会議室予約ボット」を利用してOffice365連携を行う場合、 STEP1・STEP2の手順は必要 となります。
ただし、 STEP3・STEP4の手順はテンプレートを使用するため不要です。
テンプレートを使用して作成する場合は こちら をご覧ください。
※本テンプレートは、「Advanceプラン以上」かつ「ベータ機能」でダウンロード可能となります。

STEP1:(Microsoft)Application Registration Portalにアプリケーションを登録する

Office365と連携するため、認証設定を行います。まずは『Application Registration Portal』にログインし、対象となるアプリケーションを作成します。

  手順

  1. Application Registration Portal 〕の公式サイトを開き、『Application Registration Portal』にログインしてください。

  2. マイアプリケーション画面右上の “アプリの追加” ボタンをクリックしてください。


  3. 『Application Name』に作成するアプリ名を入力し “Create” ボタンをクリックしてください。

  4. 『アプリケーションID』が表示されますので、コピーして保存してください。

  5. 『アプリケーションシークレット』の “新しいパスワードを作成” ボタンをクリックしてください。

  6. 『新しいパスワードが生成されました』というメッセージと共に、パスワードが表示されますのでコピーして保存してください。
    コピーが完了しましたら、 “OK” ボタンをクリックし、ポップアップ画面を閉じてください。

  7. 『プラットフォーム』から、 “プラットフォームの追加” ボタンをクリックしてください。

  8. 『プラットフォームの追加』が表示されますので “Web” ボタンをクリックしてください。

  9. 『リダイレクトURL』が表示されますので、
    https://management-api.dialogplay.jp/oauth/callback」と入力してください。
    ※ログアウトURLを入力する必要はありません。

  10. 『Microsoft Graphのアクセス許可』の『委任されたアクセス許可』から、 “追加” ボタンをクリックしてください。

  11. 『アクセス許可を選択』が表示されますので、必要なスコープを選択し、 “OK” ボタンをクリックしてください。
    今回は自身のユーザー情報取得するため、「offline_access」「User.Read」の2つの許可を選択してください。
    ※Microsoft Graph アクセス許可一覧が知りたい場合は、 こちら をご覧ください。

  12. 保存” ボタンをクリックしてください。
    ※選択したスコープは、『委任されたアクセス許可』で確認できます。

これで、STEP1は完了です。

STEP2:(DialogPlay)Office365とDialogPlayをつなぐ

Application Registration Portalで作成したアプリケーションをDialogPlay上でOffice365連携先として登録し、チャットボット単位で呼び出せるよう設定します。

  手順

  1. 左メニューの『アカウント設定』から『Office365連携先』を選択してください。

  2. 『Office365連携先』から “新規作成” ボタンをクリックしてください。

  3. 『連携先名』を入力してください。

  4. 『テナントID』に、Application Registration Portalで使用したアカウントの、@以下のドメイン名を入力してください。
    ※独自ドメインを設定されている場合は、独自ドメインを指定してください。

    入力例:Application Registration Portalで使用したアカウントが『dialogplay@×××.onmicrosoft.com』の場合、入力する箇所は ×××.onmicrosoft.com となります。

  5. 『アプリケーションID』に、Application Registration Portalで作成したアプリケーションIDを入力してください。

  6. 『パスワード』に、Application Registration Portalで作成したアプリケーションのパスワードを入力してください。

  7. 保存” ボタンをクリックしてください。

これで、STEP2は完了です。


STEP3:(DialogPlay)Office365のサービスをつかう

シナリオ内で呼び出したいMicrosoft Graph APIを実行させるため、対象となるAPI(実行したい機能)ごとに外部システム連携として設定します。

  手順

  1. 左メニューの『外部システム連携』から、 “新規作成” ボタンをクリックします。

  2. 『外部システム連携先』に連携先名を入力してください。

  3. 『説明』に連携先の説明文を入力してください。

  4. 『タイプ』から、『Office365』を選択してください。

  5. 『対象API』から、作成するシナリオに応じてAPIを選択してください。
    今回は、『自身のユーザー情報を取得』を選択します。
    ※対象APIを選択すると、使用するAPIで利用できるResponse Map情報が表示されますので、一から設定する必要はございません。 もちろん、必要な項目をご自由に追加いただくことも可能です。

  6. 保存” ボタンをクリックしてください。

STEP4:(DialogPlay)チャットボットをつくる

  手順

  1. 左メニューの『チャットボット』から『チャットボット一覧』を選択し、 “新規作成” ボタンをクリックしてください。

  2. 『チャットボット名』と『初期発言』を入力し、”保存” ボタンをクリックしてください。

  3. 画面下部にある『連携先設定』をクリックし、『Office365連携を行う』にチェックをいれます。『連携先』に『Sample_Office365連携』を選択し、”保存” ボタンをクリックしてください。

    ※連携先設定が無効の状態で、外部連携アクション(Office365連携)を含むシナリオを実行した場合、チャットウィンドウに「申し訳ございません。この機能はご使用いただくことができません。」と表示され、正常に作動いたしませんのでご注意ください。

  4. 『シナリオ一覧』から、 “新規作成” ボタンをクリックしてください。

  5. 『シナリオ名』と『ユーザー発言例』を入力してください。

  6. 『シナリオの流れ』エリアの中にあるリストから『テキスト発言』を選択し、 “アクションを追加” ボタンをクリックしてください。

  7. 『発言内容』入力欄が表示されますので、チャットボットに発言させたい任意のメッセージを入力してください。
    入力例:ユーザー情報を表示します。

  8. 『シナリオの流れ』エリアの中にあるリストから『外部システム連携』を選択して、 “アクションを追加” ボタンをクリックしてください。

  9. 『連携先』に先ほど作成した、『自身のユーザー情報を取得』を選択してください。

  10. 『シナリオの流れ』エリアの中にあるリストから『テキスト発言』を追加し、『発言内容』に 以下の入力例を参考に入力してください。
    ※変数の使用方法については こちら をご覧ください。
    入力例:
    あなたのユーザー情報は、こちらです。
    ID: {{ID}}
    名前:{{姓}} {{名}}
    メールアドレス:{{メールアドレス}}
    役職:{{役職}}
    事務所:{{事業所}}
    電話番号(内線):{{事業所の電話}}
    携帯電話:{{携帯電話}}

  11. 保存” ボタンをクリックしてください。

  12. 「学習データが更新されています。反映するには学習ボタンを押してください。」というメッセージが表示されますので、 “保存してチャットボットを学習” ボタンをクリックしてください。

STEP5:チャットボットとしゃべる

最後のSTEPです。
作ったチャットボットとシミュレーター機能を利用して、実際に会話をしてみましょう。

  手順

  1. 左上にある『シミュレーター』をクリックし、『チャット』タブを選択してください。

  2. Office365連携を行うシナリオが実行されると、シナリオの先頭でOffice365へのサインインを促すメッセージが表示されます。
    表示されたURLをクリックすると、Office365のサインイン画面へ遷移します。

  3. Office365のサインイン画面で、Office365の『アカウント』と『パスワード』を入力し、サインインしてください。

  4. サインインすると、このアプリで必要なアクセス許可一覧が表示されます。内容を確認し、 “承諾” ボタンをクリックしてください。

  5. 「認証に成功しました。チャットボット画面に戻り、下記の検証コードを入力してください。」というメッセージと共に6桁の検証コードが表示されますので、コピーしてください。

  6. DialogPlayのチャット画面に戻り、先ほどコピーした6桁の検証コードを入力してください。
    検証コードが認証され、シナリオが表示されます。

Office365連携による活用例(応用編)

Office365上で管理されているOutlookスケジュールの確認や会議室の予約などの操作をチャットボット経由で行う場合は、以下の手順をご覧ください。


Last updated on 2018/09/21.