この操作ができるサービス：Wevox Admin

この操作ができる人：オーナー

実施できること：

Wevoxでは、メール以外にも"Microsoft Teams"""と呼ばれるコミュニケーションツールでサーベイの通知を行うことができます。

操作方法

【Teams上の設定】

1.Teams上で “Wevoxで通知したい全ユーザーが所属するチーム” を用意する

Wevoxの通知を、Teams上で受け取るためには、 “Wevoxで通知したい全ユーザーが所属するチーム” をTeams上に用意する必要があります。

a.) 「既定のディレクトリ」を利用する場合

Teamsではデフォルトで、「既定のディレクトリ」という全ユーザーが所属するチームが用意されております。

通常は、こちらの「既定のディレクトリ」に対して、後述するAzure上での設定・Wevoxへの設定値の入力を行ってください。

Teamsの仕様上、「既定のディレクトリ」の上限人数が5000名のため、

それ以上の人数において、Wevoxの通知をTeams上で受け取る設定を行う場合は、

b.) 「既定のディレクトリ」を利用しない場合 にお進みください。

Wevoxの通知をTeams上で受け取る人数が5000名以下の場合は、

b.) 「既定のディレクトリ」を利用しない場合をスキップし、【Azure上の設定】にお進みください。

b.) 「既定のディレクトリ」を利用しない場合

Teamsの仕様上、「既定のディレクトリ」の上限人数が5000名のため、それ以上の人数において、Wevoxの通知をTeams上で受け取る設定を行う場合は、別途チームを作成し、作成したチームごとに、後述する設定を行ってください。

例.) 20000名でのご利用の場合、5000名のチームを4つ作成し、それぞれのチームに対して、後述する設定を行なってください。

2.Microsoft Teams 管理センターでカスタムアプリを許可する

この後の手順で、Teamsにカスタムアプリを追加するため、一時的にカスタムアプリの追加を許可する必要がございます。

a.) [Microsoft Teams 管理センター]>[Teamsアプリ]>[権限ポリシー]を表示する

b.) [グローバル（組織全体のデフォルト）]をクリック

c.) カスタムアプリで[すべてのアプリを許可する]をクリックし、[保存]をクリック

【Azure上の設定】

1.Azure上で、Botアプリを作成する

a.) AzureADのホーム画面を表示する

b.) [Azure Active Directory]をクリック

c.) [アプリを登録]をクリックし、[新規作成]をクリック

d.) [アプリケーションの登録]にて、下記の情報を入力し、[登録]をクリック

名前:「WevoxTeamsBot」

サポートされているアカウントの種類:

「任意の組織ディレクトリ内のアカウント (任意の Azure AD ディレクトリ - マルチテナント)と個人のMicrosoft アカウント (Skype、Xboxなど)」

リダイレクトURI:

https://wevox.io/notifications/settings/teams/callback_account

e.) 登録したアプリの[アプリケーションID]を確認

[アプリケーションの登録]の後に遷移する、アプリの概要画面にて、下記の【B: アプリケーションID】を手元にお控えください。

※ 後ほど、Azure上での入力及びWevox上での入力に使用します。

2.手順1で登録したアプリで、認証の設定を行う

a.) アクセストークンとIDトークンの許可を行う

1.) アプリの概要画面から、左メニューの[認証]をクリック。

2.) 画面遷移後、[暗黙的な許可およびハイブリッドフロー]の項目にて、

アクセストークン (暗黙的なフローに使用)
ID トークン (暗黙的およびハイブリッドフローに使用)

の2つにチェックを入れる。

3.) [保存]をクリック

b.) 新しいクライアントシークレットを発行する

[証明書とシークレット]をクリックし、

[新しいクライアントシークレット]をクリック。

説明: wevox-teams-bot-initial
有効期限: 24ヶ月

と入力し、[追加]をクリック。

c.) 新しいクライアントシークレットの値を確認する。

クライアントシークレットが発行されるので、「値」の欄に記載されている【C: クライアントシークレット】を手元にお控えください。シークレットIDではなく、「値」の欄に記載されている情報が【C: クライアントシークレット】です。

※ 後ほど、Azure上での入力及びWevox上での入力に使用します。

3.手順1で登録したアプリで、APIのアクセス許可を設定

a.) [APIのアクセス許可]をクリック

b.) [アクセス許可の追加]をクリックした後で、[Microsoft Graph]をクリック

c.) [委任されたアクセス許可]をクリック

d.) [委任されたアクセス許可]にて、[アクセス許可の追加]を行う

検索欄に、「AppCatalog.ReadWrite.All」と入力。

表示されるチェックボックスに、チェックを入れる。

[アクセス許可の追加]をクリック。

e.) 再度、[アクセス許可の追加]をクリックした後で、[Microsoft Graph]をクリック

f.) [アプリケーションの許可]をクリック

g.) [アプリケーションの許可]にて、[アクセス許可の追加]を行う

検索欄に、「TeamMember.Read.All」と入力し、チェックを入れる。

同様に、

検索欄に、「TeamsAppInstallation.ReadForUser.All」と入力し、チェックを入れる。

検索欄に、「TeamsAppInstallation.ReadWriteForTeam.All」と入力し、チェックを入れる。

上記で3つのアクセス許可にチェックを入れた後で、[アクセス許可の追記]をクリック。

h.) [既定のディレクトリに管理者の同意を与えます] をクリックし、同意を付与する

3.Azure Botを作成する

a.) AzureADのホーム画面を表示する

b.) 画面上部の検索欄に「Azure Bot」と入力し、[Azure Bot] をクリック

c.) [Azure Bot] の各項目を入力し、[確認と作成] をクリック

「ボットハンドル」〜「作成の種類」までの各項目を下記のように入力。

ボットハンドル	(例) wevox-teams-bot-channel
サブスクリプション	※ 貴社のサブスクリプションを選択ください
リソースグループ	teams-bot
価格レベル	F0 (S1でも可)
アプリの種類	マルチテナント
作成の種類	既存のアプリの登録を使用する
アプリID	e.) で取得した【B: アプリケーションID】

入力後、[確認と作成] → [作成] をクリック。

デプロイが開始されるため、完了まで待つ。

d.) [構成] をクリックし、[メッセージエンドポイント]を入力する

画面左の[設定]→[構成]をクリックする。

構成画面にて、上部のメッセージングエンドポイントに以下のURLを入力する。

https://wevox.io/apis/microsoft_teams/bot_integration

入力後、[適用]をクリック。

e.) [チャンネル]をクリックし、Teamsのアイコンをクリック。

f.) サービス条件のチェックボックスにチェックをした上で、[同意]をクリック。

g.) [Microsoft Teams Commercial]を選択した上で、[適用]をクリック。

4.Wevoxに入力する各設定値を確認する

Wevoxに入力する各設定値一覧

入力情報	説明
【A: チームID】	Azureホーム画面 → Azure Active Directory → グループ → Botをインストールするグループを選択 → オブジェクト ID
【B: アプリケーションID】	Azureホーム画面 → Azure Active Directory → アプリの登録 → 登録済みアプリをクリック → アプリケーション（クライアント）ID
【C: クライアントシークレット】	チャネル登録時に入力した「パスワード」（アプリ登録の際に「証明書とシークレット」で作成したクライアントシークレット情報）
【D: テナントID】	Azureホーム画面 → Azure Active Directory → アプリの登録 → 登録済みアプリをクリック → ディレクトリ（テナント）ID
【E: チャネルID】	チームをWebブラウザーで開く → URL欄を確認 → パラメータ名「threadId」の値