Microsoft Teams を顧客向けチャットチャネルとして利用可能にするアプリの作成
このガイドでは、Bright Pattern Contact Center と連携できる Microsoft Teams 用のカスタムアプリを作成する方法について説明します。組織のメンバーは、Teams クライアントからこのアプリを使用して、コンタクトセンターとやり取りすることができます。
顧客にさまざまな連絡手段を提供するために、複数のアプリを設定することができます。
|
注: このアプリは、 ディレクトリ、チャット、およびプレゼンス統合のための Teams API アクセスを有効にする Azure アプリとは別のものです。 | |
依存関係
- Microsoft 365 テナントがカスタムアプリ開発に対応していること：
- Teams へのアクセスを許可する Microsoft 365 サブスクリプションであること。
- Microsoft 365 管理者が組織に対して Teams を有効にしていること。
- Teams 管理者がカスタム Teams アプリを有効にし、カスタムアプリのアップロードを許可していること。
- Bright Pattern Contact Center の「MS Teams」メッセンジャー連携アカウントによって生成されたアカウント ID。
開発者ポータルを追加し、アプリを作成する
Microsoft Teams クライアントアプリケーションを開き、「アプリ」タブに移動してください。
「Developer Portal」アプリを追加してください。
Developer Portal の「アプリ」タブから、「最初のアプリを作成する」をクリックします。
組織のメンバーがアプリを識別しやすいよう、わかりやすい「名前」を入力してください。
アプリの機能（ボットの設定）
アプリの作成が完了したら、「設定」＞「アプリ機能」に移動し、追加する機能として「ボット」を選択してください。
「既存のボットを選択する」、「新規ボットを作成する」、または「ボット ID を入力する」というオプションが表示されます。既存のボットをお持ちでない場合は、「新規ボットを作成する」をクリックしてください。
「ボット管理」ページで、「最初のボットを作成」ボタンをクリックしてください。表示されるダイアログで、ボットに適切な「名前」を追加してください。
ボット ID をコピーする
ボットが「ボット管理」ページに表示されます。 MS Teams 連携アカウントのアプリ IDとして使用するため、ボット ID をコピーし、ボットを開いて編集してください。
エンドポイントアドレスの追加
ボットの「設定」メニューを開き、エンドポイントアドレスを設定してください。この URL は、MS Teams 連携アカウントによって生成されたアカウント IDとコンタクトセンターの URL を組み合わせて、次のようにフォーマットして作成できます：
https://<コンタクトセンターのURL>/clientweb/msteams/webhook/<アカウントID>
クライアントシークレットの作成
ボットの「クライアントシークレット」ページに移動し、「ボットのクライアントシークレットを追加」をクリックしてください。
ダイアログに新規クライアントシークレットが表示されます。シークレットをコピーし、適切に保管してください。これは、MS Teams 連携アカウントの「アプリシークレット」として使用するために必要となります。
スコープとアクセス権の設定
「設定＞アプリ機能＞ボット」ページに戻ります。ボットを選択し、以下のアクセス権とスコープを有効にして、「保存」をクリックしてください。
- ボットでできること
-
- ファイルのアップロードとダウンロード
- ユーザーがボットを使用できるスコープを選択してください
-
- パーソナル
- チーム
- グループチャット
「設定」＞「アクセス権」ページに進み、以下のデバイスアクセス権を有効にしてください：
- ユーザーへの通知送信
- 外部アプリでのリンクを開く
最後に、ボットに正しいマルチテナントアクセス権が設定されていることを確認する必要があります。「https://portal.azure.com/」に移動し、「アプリ登録」を開いてください。
「所有しているアプリケーション」の中から、前ステップで作成したボットを開きます。
「管理＞認証」に移動し、「サポートされているアカウントの種類」の下にある「任意の組織ディレクトリ内のアカウント (任意の Microsoft Entra ID テナント - マルチテナント)」というオプションを選択してください。
「保存」をクリックし、Azure ポータルを閉じてください。
アプリの基本設定
「アプリの機能」ページ経由でアプリにボットが追加されたら、「設定＞基本情報」に移動し、ユーザーがアプリの目的を理解できるよう、いくつかのフィールドに入力してください。
アプリ名
アプリの略称と正式名称を指定してください。これらは、ユーザーが Teams アカウントにアプリを追加する際に検索する名前となります。
説明
この連携を通じてユーザーがアクセスできるサービスチャネルについて、概要と詳細の両方の説明を記載してください。
バージョン
アプリを公開するたびに、バージョン番号を1つずつ増やしてください。
開発者情報
アプリ開発者の名前とウェブサイトです。
アプリの URL
組織のプライバシーポリシーおよび利用規約への URL を必ず指定してください。
「基本情報」ページには、「アプリ ID」も表示されます。後で参照できるよう、この識別子をメモしておいてください。組織の Azure 管理者は、アプリの公開を承認するためにこの情報が必要となります。
「基本情報」ページでは、「アプリケーション (クライアント) ID」の入力が必要となります。これは、前にメモしておいたボットID です。
_ID.png)
アプリのブランディング（オプション）
組織のブランディングに合わせたカスタムアイコンを追加したり、アクセントカラーを選択したりすることができます。既定のアイコンを変更する場合は、アプリを公開するために、Microsoft が指定するサイズ要件を満たすアイコンを使用する必要があります。
アプリの公開と配布
アプリの公開準備が整いましたら、「Teams でプレビュー」をクリックして、エンドユーザーにアプリの説明がどのように表示されるかを確認してください。
結果に問題がなければ、「公開」をクリックし、「組織に公開」というオプションを選択してください。
アプリの公開を完了するには、Microsoft Azure アカウントの管理者がアプリを承認し、組織の Azure サブスクリプションに関連付ける必要があります。通常、これは Azure CLI を使用して、次のようなコマンドを実行することで作成できます：
az resource create --resource-group myGroupNameNoQuotes --name myGraphAppBillingResourceNameNoQuotes --resource-type Microsoft.GraphServices/accounts --properties "{`"appId`": `"myAppGUID`"}" --location Global --subscription mySubscriptionGUIDNoQuotes
myAppGUID の値は、アプリケーション (クライアント) ID / ボット ID です。これは、前にメモしておいたもので、組織の Azure 管理者に提供する必要があります。
ユーザーにアプリを見つけてもらう
アプリの承認と公開が完了したら、ユーザーに Microsoft Teams アカウントへのインストールを促すことができます。
ユーザーは、Microsoft Teams クライアントを開き、「アプリ＞組織向けに構築されたアプリ」の順に移動して、リストからアプリを選択することで、アプリを追加できます。
また、ご自身の Microsoft Teams クライアントのアプリプレビューページから、アプリへのリンクをコピーすることもできます。
ユーザーがアプリを開くと、チャットウィンドウが表示されます。ユーザーとアプリとのやり取りを処理するには、チャットシナリオエントリー、チャットシナリオ、および チャットサービス を設定する必要があります。