Microsoft Teams と dejiren の接続設定方法
本記事では、Microsoft Teams と dejiren の接続設定方法について説明します。
前提条件
| サービス名 | 必要な権限 | 権限が必要な場面 |
|---|---|---|
| Microsoft Teams | 開発者ポータル操作権限 | Botアプリの作成 |
| Teams管理センター操作権限 | 作成したBotアプリの 公開承認 | |
| dejiren との連携を利用するアカウント | 外部ユーザー割り当て | |
| Microsoft Azure | 管理者権限 | 作成したBotアプリの 許可設定 |
| dejiren | VA 編集権限 (VA 管理者、もしくはVA 編集者) | 接続設定の新設 |
| システム管理者 | 外部ユーザー割り当て | |
| 一般利用者アカウント | 外部ユーザー割り当て |
設定作業の流れ
設定手順
手順1. Microsoft Teams に開発者ポータルを追加する
1.Microsoft Teams を起動します。
2.Microsoft Teams のサイドメニューにある[アプリ]をクリックします。
3.検索欄に[開発者ポータル]と文字入力して検索します。
4.検索結果として表示された[開発者ポータル]の[追加]をクリックします。
手順2. Teams開発者ポータルでBotアプリを作成する
1.MicrosoftTeams 開発者ポータルで、[新しいアプリの作成]をクリックします。
2.新しいアプリの作成で名前に任意の名称を文字入力して、マニフェストのバージョンはLatest Stableを選択し、作成をクリックします。
3.作成したアプリのサイドメニューにある[基本情報]をクリックします。
4.[説明]の[短い説明 (80文字以下)]と[簡単な説明 (4000文字以下)]それぞれに、任意の説明文字列を入力します。
5.下方向にスクロールし、各項目に値を文字入力します。
| 設定項目 | 設定項目 | 設定値 |
|---|---|---|
| 開発者情報 | 開発者または会社の名前 | 任意の文字列を入力します。 |
| Web サイト | 作成したBotアプリの公開承認 | |
| アプリのURL | プライバシーポリシー | プライバシーポリシーを記載されているページの URL を入力します。 |
| 使用条件 | 使用条件を記載されている ページの URL を入力します。 |
6.アプリケーション (クライアント) IDは入力せずに、保存をクリックします。
7.開発者ポータルのサイドメニューの[アプリの機能]をクリックします。
8.[アプリの機能]にある[ボット]をクリックします。
9.[新しいボットの作成]をクリックします。
10.[＋新しいボット]をクリックします。
11.[ボット名]に名称を文字入力して[追加]をクリックします。
12.ボットのサイドメニューの[クライアント シークレット]をクリックします。
13.[ボットのクライアント シークレッ…]をクリックします。
14.[新しいクライアント シークレットが生成されました]で表示されたシークレットキーの文字列を
控えてから、[OK]をクリックします。
(後ほど dejiren の接続設定で利用します。)
シークレットキーはこの1度しか確認できません。
15.アプリのボットまで戻り、[既存のbotを選択]で、作成したボットを選択します。
(作成したボットが２つ表示されますが、どちらを選択しても構いません)
16.[ボットで何ができますか？]で[ファイルをアップロードしてダウンロードする]にチェックをつけます。
17.[ユーザーがこのコマンドを使用できるようにする範囲]で[Personal]、[Teams]、[Group Chat]にチェックし、[保存]をクリックします。
18.ボットの下に表示される ID 文字列 (下図の[更新済み:]の箇所に続く文字列) を控えます。
(後ほど dejiren の接続設定で利用します。)
19.アプリパッケージエディターをクリックし、manifest.json を開きます。
20.manifestVersionを1.25から1.24に変更します。
21.保存をクリックします。
22.更新をクリックします。
23.確認をクリックします。
手順3.Microsoft Teams 管理 センターで、作成したBotアプリの公開承認を行う
1.開発者ポータルのサイドメニューの[公開]にある[組織に公開する]をクリックします。
2.[組織に公開する]で[アプリの公開]をクリックします。
3.Microsoft Teams 管理 センターのアプリを管理に移動します。https://admin.teams.microsoft.com/policies/manage-apps
4.検索文字列入力欄に作成したアプリ名を入力します。
5.検索結果として表示されたアプリを選択します。
6.下方にあるバージョン情報までスクロールし、[アプリ ID]の項目に表示された文字列を控えます。
(後ほど dejiren の接続設定で利用します。)
7.画面上部にある[Publish]をクリックします。
8.確認ダイアログが表示されるので、[公開]をクリックします。
手順4.Microsoft Azure – Micorosoft EntraIDで、作成したアプリの許可設定を行う
1.Microsoft Azure ポータルにアクセスします。
https://portal.azure.com/#home
2.Microsoft Azure ポータルの[Microsoft Entra ID] をクリックします。
3.Entra ID の[概要]にある[テナントID]の表示文字列を控えます。
(後ほど dejiren の接続設定で利用します。)
4.Microsoft Azure ポータルのサイドメニューの[アプリの登録]をクリックし、作成したアプリを選択します。
5.Authenticationを選択し、タブを Supported accounts に切り替えます。
6.[サポートされているアカウントの種類]を[シングルテナントのみ]を選択し、保存します。
(2025年7月31日以前に作成したアプリの場合は任意のEntra IDテナントを選択します)
7.Microsoft Azure ポータルのサイドメニューの [APIのアクセス許可]をクリックします。
8.[構成されたアクセス許可]画面で、[＋アクセス許可の追加]をクリックします。
9.[API アクセス許可の要求]画面で[Microsoft Graph]をクリックします。
10.[API アクセス許可の要求]画面が表示されるので、[アプリケーションの許可]をクリックします。
11.[アクセス許可を選択する]の検索文字列に[User.Read.All]と入力して検索し、
[User.Read.All]にチェックを付け、[アクセス許可の追加]をクリックします。
12.[＊＊＊に管理者の同意を与えます]を選択してから、[はい]をクリックします。
(＊＊＊は利用環境により異なります。)
13.[Group.Read.All]、[Sites.ReadWrite.All]、[ChannelMessage.Read.All]、[Team.ReadBasic.All]
についても、上記7～11の手順でアクセス許可を追加します。
手順5.dejiren に接続設定を作成
1.dejiren のバーチャルアシスタント (VA) 管理画面にアクセスします。
http://www.dejiren.com/va
4.[新しい接続設定をつくる]ダイアログが表示されるので、
[Microsoft Teams]を選択して、[つぎへ]をクリックします。
5.[新しい接続設定をつくる]の詳細設定画面で各項目の内容を設定します。
| 設定項目 | 設定値 | 参照元 |
|---|---|---|
| 接続名 | この接続設定を識別するための名称を文字入力します。 | ー |
| Microsoft App ID | [Teams開発者ポータル] – [ボット管理] – [作成したボット] – [ボットID]に表示された文字列を転記します。 | 手順2-18 |
| クライアントシークレット | [ボットのクライアント シークレッ…]で新しいクライアントシークレットを生成したときに表示された文字列を転記します。 | 手順2-14 |
| テナントID | [Azure] – [Micorosoft EntraID] で、[概要]の[テナントID]に表示された文字列を転記します。 | 手順4-3 |
| アプリID | [MicrosoftTeams管理センター] – [About] – [App ID]の文字列を転記します。 | 手順3-6 |
| ボットサービスURL | https://smba.trafficmanager.net/jp/ | ー |
| 2025年7月31日以前に作成されたBotを使用 | 2025年7月31日以前に作成されたBotを使用する場合、チェックボックスをONに設定します。 | ー |
| VA編集時に取得する対象のチーム | VAが送信するメッセージの送信先として、選択可能な範囲を設定します。 | ー |
6.[新しい接続設定をつくる]を下方向にスクロールして[webhookを発行する]をクリックします。
7.発行された webhook の文字列を控えます。
(後ほどボットサービスに登録します。)
手順6.外部ユーザーの割り当て（ユーザーアカウントの結びつけ）
Microsoft Teams のユーザーアカウント と dejiren のユーザアカウントを結びつけることにより、
サービス間のID連携をシームレスに実現し、Microsoft Teams と dejiren でメッセージのやり取りや
Microsoft Teams から dejiren VA の呼び出し・操作が可能になります。
1.dejiren のシステム管理画面に、システム管理者ロールに属するユーザーでアクセスします。
https://www.dejiren.com/admin
2.dejiren のシステム管理画面のサイドメニューにある[外部ユーザー割り当て]をクリックします。
3.外部ユーザー割り当て]画面で、[連携先]から[Teams]を選択して、[エクスポート]をクリックします。
4.Microsoft Teams のアカウントと dejiren アカウントの結びつけを記載するためのCSVファイルを
ダウンロードします。
作業用PCの任意の領域にCSVファイルをダウンロードして、表計算ソフトウェアで開いてください。
5.CSVファイルを編集して、保存します。
※連携必要なアカウント分の行を記入してください。
※[Operation]に[N]と指定したときは新規登録、[X]は既存登録の削除、[U]は既存登録の更新を行
えます。
6.[外部ユーザー割り当て]画面の[ CSV インポート]セクションで、クリップマークをクリックして、
作成した外部ユーザー割り当て CSV ファイルを指定します。
7.[インポート]をクリックして、CSVファイルを取り込みます。
8.インポート結果は、実行から少し時間をあけて、[インポート実行履歴]をクリックして確認してください。
※[正常終了]と表示されていない場合には、重複登録や処理指定・dejirenアカウントの表記誤りなどがないか確認して再度実行して下さい。
手順7.Microsoft Teams / 開発者ポータルで、作成したBotを「追加」し、
dejirenで発行したWebhookURLを登録する
1.Microsoft Teams のサイドメニューで[開発者ポータル]をクリックします。
2.[開発者ポータル]の上部に表示されているタブから[ツール]タブをクリックします。
5.開発者ポータルのサイドバーの[構成する]をクリックします。
6.[エンドポイントアドレス]欄に、dejiren で発行した webhook URL の文字列を転記します。
(手順5-7)
手順8.作成した Bot アプリを Microsoft Teams の任意のチャネルに追加して、
dejirenからの転送メッセージを受信できるようにする
1.Microsoft Teams のサイドメニューで[アプリ]をクリックします。
2.[アプリ]で、作成したボットの[追加]をクリックします。
※作成したボットがこの画面に表示されるまでに多少のタイムラグが生じることがあります。
一覧上に表示されていない場合には少し時間をあけてご確認ください。
以上で Microsoft Teams と dejiren の接続設定は完了です。
dejiren で この接続設定を利用する VA を作成し、Teams の任意のチャネルに Bot を追加してください。
※正常に接続ができないとき
- Azure や Teams の仕様の都合上、反映されるまでに多少の時間を要する場合がありますので、
設定完了後、即時動作が確認いただけないことがあります。
接続の正常動作がご確認いただけないときは、少し時間をあけてから
再び動作をご確認くださいますようお願い申し上げます。 - 一定時間経過後も正常に動作しない場合には、
もう一度 、手順4-11に記載の[管理者の同意を与えます]の操作を実行して、
App ID を有効化してください。
#Microsoft Teams #Teams #接続 #コネクタ #Azure #チームズ #ティームズ #チームス #ティームス #チャット
