カスタム機能を利用してOutlookに連絡先情報を登録する – DialogPlay - TIS株式会社

外部システム連携のカスタム機能を利用して、Outlookに連絡先を登録するシナリオを作成します。

Office 365連携を初めて行う場合は、以下をご覧ください。
【STEP1：（Microsoft）Microsoft Azure Portalにアプリケーションを登録する】
【STEP2：（DialogPlay）Office 365とDialogPlayをつなぐ】

事前準備

Outlookに連絡先を登録するためには、以下のアクセス許可が必要となります。
STEP1の〔 Microsoft Azure Portal 〕で登録したアクセス許可に、次の項目が含まれていることを確認してください。

[「Outlookに連絡先を登録する」で使用する許可スコープ]

名称	説明
Contacts.ReadWrite	ユーザー連絡先へのフルアクセス

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

STEP3. （DialogPlay）Office 365のサービスをつかう

手順

左メニューの『チャットボット一覧』より設定を行うチャットボットを選択し、『外部システム連携』タブから”新規作成“ボタンをクリックしてください。
『外部システム連携先』に連携先名、『説明』に連携先の説明文を入力してください。
『タイプ』から「Office 365」を選択し、『対象API』から「カスタム」を選択してください。
以下の例を参考に、接続先に関する各項目を設定してください。

①『アクセス許可』に〔Microsoft Azure Portal〕で設定した許可スコープを入力してください。
[入力例]
Contacts.ReadWrite

②『URL』に接続先URLを入力してください。
[入力例]
https://graph.microsoft.com/v1.0/me/contacts

③『Method』に「POST」を選択してください。

④『Headers』に以下の例を参考に、各項目を入力してください。
[入力例]
『名前』　Content-type
『値』　　application/json

⑤『Request Body』に以下の例を参考に入力してください。
[入力例]
```
{
 "givenName": "{{名前}}",
 "surname": "{{苗字}}",
 "displayName": "{{苗字}} {{名前}}",
 "emailAddresses": [
 {
 "address": "{{メールアドレス}}",
 "name": "{{苗字}} {{名前}}"
 }
 ],
"businessPhones": [
"{{電話番号}}"
]
}
```
外部連携先から取得する値を、以下の例を参考に入力してください。

①『Response Type』にデフォルトで「JSON」が選択されていることを確認してください。

②『Response Map』の『変換元』にJSONのキー（外部連携先から取得する値）を入力し、『変換先』にシナリオ作成時に使用する変数名を入力してください。
[入力例]
『変換元』　displayName
『変換先』　登録名
“保存“ボタンをクリックしてください。
作成した外部連携が問題なく動作しているかどうか、テストを行うことができます。
動作テストを行う場合は、”テスト“ボタンをクリックしてください。

[外部連携の実行画面]

STEP4. （DialogPlay）シナリオを追加する

手順

パンくずメニューのチャットボット名をクリックし、チャットボット画面に戻ってください。
『連携先設定』にて『Office 365連携を行う』にチェックが入り、『連携先』が設定されていることを確認してください。
※ 連携先設定が未設定の状態で、Office 365連携を利用したシナリオを実行した場合、チャットウィンドウに「外部システム連携先が設定されていない為、この機能はご使用いただくことができません。」と表示され、外部連携アクションは正常に動作しません。
『シナリオ一覧』タブから、”新規作成“ボタンをクリックしてください。
『シナリオ名』と『ユーザー発言例』を入力してください。
『シナリオの流れ』エリアの中にあるリストから「テキスト発言」を選択し、”アクションを追加“ボタンをクリックしてください。
『発言内容』に以下の例を参考に入力してください。

[入力例]
Outlookにユーザー情報の登録を行います。

『シナリオの流れ』エリアの中にあるリストから、『ヒアリング』アクションを追加し、以下の例を参考に各項目を入力してください。

[入力例]

No	ヒアリング項目名	タイプ		項目ごとの質問文
1	苗字	テキスト全体	@text	苗字を教えてください。
2	名前	テキスト全体	@text	名前を教えてください。
3	メールアドレス	連絡先表現	@email	メールアドレスを教えてください。
4	電話番号	連絡先表現	@phone_number	電話番号を教えてください。

『シナリオの流れ』エリアの中にあるリストから『外部システム連携』アクションを追加し、『連携先』にSTEP3で作成した「Outlookに連絡先を登録する」を選択してください。
『シナリオの流れ』エリアの中にあるリストから『テキスト発言』アクションを追加し、『発言内容』に以下の例を参考に入力してください。

[入力例]
```
以下の内容で登録しました。
登録名：{{登録名}}
メールアドレス：{{メールアドレス}}
電話番号：{{電話番号}}
```
“保存“ボタンをクリックしてください。
「学習データが更新されています。反映するには学習ボタンを押してください。」というメッセージが表示されますので、”保存してチャットボットを学習“ボタンをクリックしてください。

STEP5. （DialogPlay）チャットボットとしゃべる

手順

『シミュレーター』機能で、動作を確認してください。
Office 365へのサインインを促すメッセージが表示されますので、URLをクリックし、Office 365にサインインしてください。
※ 詳細については【チャットボット作成（Ⅳ.Office 365連携編）－ STEP6】をご覧ください。

[シミュレーター画面]

[Office 365画面]