メインコンテンツにスキップ
Teamsと連携する
祢次金正気 avatar
対応者:祢次金正気
昨日アップデートされました

QastとTeamsの連携方法についてご紹介します。

連携設定を行うことで、下記の運用が可能です。

  • Qastでメモや質問が作成・更新された際に個人チャットに通知する

  • Qastでメモや質問が作成・更新された際に指定したTeamsチャネルに通知する

    • Microsoft社仕様変更に伴い2025年12月に廃止予定

  • Teamsの投稿をQastにシームレスに投稿する

◾️Teams個人チャットへの通知およびシームレス投稿の設定

【管理者による初期設定】

* 本操作は連携開始の初回のみ発生します。 
* 本操作で下記の設定を行います。
    ・QastとTeamsの連携設定
    ・TeamsからQastへのシームレス投稿設定
    ・QastからTeams個人チャットへの通知設定
* Azure管理者の権限を持つユーザーにて操作を行ってください。

※ 「▶︎」をクリックし、番号順に手順のご確認および実施をお願いします。

1. QastでTeamsの通知連携設定を⾏う

(1)「マイページ > 通知 > Teams連携」のセクションで 「連携する」 ボタンをクリックします。

(2) Microsoftのログイン認証画面が表示されるので、Azure管理者権限を持つユーザーでログインします。

(3)アクセス許可画面が表示されるので、[組織の代理として同意する] にチェ

ックをして [承諾] ボタンをクリックします。

(クリック後、自動的にQastマイページに遷移します)

(4)「連携する」 ボタンが 「連携停⽌」 ボタンになっていることを確認します。

2.Azure上でQast連携に必要な権限が許可されているかを確認する

(1)Azure Entra IDのページを開き、左部メニュー内の「管理 > エンタープライズアプリケーション」をクリックします。

(2)テナントの検索ボックスに[Qast]と入力し、検索結果に表示された[Qast Productionアプリケーション]をクリックします。

(3)表示された詳細ページ左部メニュー の「セキュリティ > アクセス許可」 をクリックし、下記5種類の権限が付与されていることを確認します。

  • offline_access

  • ChatMessage.Send

  • TeamsAppInstallation.ReadForUser

  • Directory.Read.All

  • Chat.ReadWrite

権限が付与されていない場合の対応方法

アクセス許可画面の「テナント名に管理者の同意を与えます」 ボタンがクリックできる状態であるかをご確認ください。

【クリックできる場合】

ボタンをクリックし、表示された画⾯に従ってアクセスの要求に対して承諾する設定を⾏ってください。

本操作を行った場合、権限の上書きによりアクセス許可がリセットされてしまうため、お手数ですがQastに戻って「マイページ > 通知 > Teams連携」のセクションで「Teams連携解除」ボタンをクリックした後、再度【初回設定(Azure管理者)】の⼿順で操作を実施いただき、上記の5種類の権限が付与されていることを確認してください。

【クリックできない場合】

QastでTeamsの通知連携設定を⾏う の手順(3)で「組織の代理として同意する」にチェックをせずに操作が進んでしまった可能性があります。

下記の手順でアクセス許可の再設定をお願いします。

  1. Azure上でQast連携に必要な権限が許可されているかを確認の手順(1)-(3)を実施し、Qastアプリケーションの詳細ページを開きます。

  2. 「管理 > プロパティ」をクリックし、画面上部の「削除」をクリックし、Qastアプリケーションを削除します。

  3. 【初回設定(Azure管理者)】のQastでTeamsの通知連携設定を⾏う 手順に従い再度連携設定を実施します。

    この時、手順(3)で必ず「組織の代理として同意する」 にチェックをして 「承諾」 ボタンをクリックしてください

  4. Azure上でQast連携に必要な権限が許可されているかを確認の手順を実施し、Qastアプリケーションに5種類の権限が付与されていることを確認します。

3.Qastでチャット通知設定を行う

「マイページ > 通知 > Teams連携」のセクションで「「チャット」に通知が届きます」という設定項⽬をON に変更します。

(変更は即時反映されます)

4.Qastでカスタムアプリをダウンロードする

「マイページ > チーム > アプリ投稿」のセクションで、Teamsの「カスタムアプリをダウンロード」をクリックし、アプリをダウンロードしてください。

5.Microsoft Teams管理センターでアプリ配信設定を行う

* この操作はAzure上でTeamsの管理者権限を持つユーザにて行ってください。
* 本操作は、下記の設定(本項目より上段にかかれている設定手順)が完了した状態で実施ください。
    【初回設定(Azure管理者)】
      ・QastでTeamsの通知連携設定を⾏う 。
      ・Azure上でQast連携に必要な権限が許可されているかを確認。
      ・Qastでチャット通知設定を行う 。
      ・Qastでカスタムアプリをダウンロードする。
   
* 管理センター側で利⽤可能ユーザが全員になっていても「追加」ボタンが「承認の要求」ボタンになります。
* 管理センターで全員に許可をしていたとしても使えないままになるので注意が必要です。

(1) Microsoft Teams 管理センターを開き、画面左部メニューから「Teams のアプリ > アプリ管理」のページを開きます。

(2)右上部「アクション」のメニューから[新しいアプリをアップロード]をクリックします。

(3)[アップロード]をクリックし、Qastでダウンロードしたカスタムアプリのzipファイルを選択します。

(4)アップロード完了後、画面に表示されている「こちらのリンク」をクリックします。

(5)アプリの管理画面上部に表示されている「利用可能」項目が「全員」と表示されていることを確認します。

※「簡単な説明」の部分は「qast for production」と記載されています。

【注意事項】

*Qastアプリの利用ユーザーを制限する場合は、「ユーザとグループ」タブで個別設定をお願いします。

*カスタムアプリのアップロード後、Teams側にアプリが反映されるまでに数時間〜数日程度の所要時間が発生する場合があります。

6.Teamsでアプリの追加を⾏う

* この操作はAzure上でTeamsの管理者権限を持つユーザー以外でも実施可能です。

(1) 「Teams」を起動し、左部メニュー「アプリ > 組織向けに開発」をクリックし、

「Qastアプリ」が表⽰されますので、[追加]をクリックします。

※カスタムアプリのアップロード後、Teams側にアプリが反映されるまでに数時間〜数日程度の所要時間が発生する場合があります。

時間をあけて反映されているかをご確認下さい。

Qastアプリが表示されない場合

Qastアプリが表示されない場合は一度Teamsをサインアウトし、もう一度サインインして上記操作を実施ください。

再度サインインしてもアプリが表示されない場合は、下記の操作をお試しください。

  1. Microsoft Teams 管理センター >Teams のアプリ > アプリ管理 > Qast > ユーザーとグループ > 状態の編集」に遷移します。

  2. アプリの管理画面上部に表示されている「利用可能」項目の「全員」をクリックし、右側に表示された状態の編集画面で「該当者なし」に変更し、「適用」をクリック後、再度「全員」に設定し「適用」をクリックします。

  3. アプリの反映に時間がかかる場合があるため、数時間〜数日程度経過後に再度TeamsでQastアプリが表示されているかを確認します。

(2)表示された画面で「追加」をクリックします。

【注意事項】

  • 権限が必要ですという画面が表示された場合は、何度か同じ操作をお試しいただくか、一度サインアウトして再度操作ください。

  • 「アプリに接続できません。もう⼀度お試しください。」という画面が表⽰された場合は、数時間〜数日ほどお時間を開けて再度操作ください。

以上で個人チャットへの通知およびシームレス投稿の設定は完了です。

【連携設定の解除方法】

各ユーザーの解除方法

  1. Teams内のQastアプリ削除します。

    「Teams」を起動し、左部メニュー「アプリ > アプリを管理」をクリックし、表示された「Qast アプリ」の「個人用アプリ」の削除をお願いいたします。

  2. Qastの個人チャット通知をOFFします。

  3. QastのTeams連携を連携停止します。

    Qastの「マイページ > 通知 > Teams連携」のセクションで「連携停止」ボタンをクリックし、連携を解除します。

    上記の手順で、各ユーザーのTeams連携解除完了となります。

管理者の解除方法

  1. Microsoft Teams 管理センターでQastアプリ削除します。

    Microsoft Teams 管理センターを開き、画面左部メニューから「Teams のアプリ > アプリを管理」のページを開きます。

    Qast Productionアプリを検索いただき、右上アクションメニューよりアプリの削除をお願いいたします。

    ※削除を行うと全てのユーザーの「Teamsアプリ」から「Qastアプリ」が削除されます。

  2. Qastの個人チャット通知をOFFにします。

    Qastにログインいただき、「マイページ > 通知 > Teams連携」のセクションで「チャット」に通知が届きます」という設定項⽬をOFF に変更し、通知設定を解除します。

  3. QastのTeams連携を連携停止します。

    Qastの「マイページ > 通知 > Teams連携」のセクションで「連携停止」ボタンをクリックし、連携を解除します。

  4. Azure Entra IDページで「Qast Productionアプリケーション」の削除します。

    Azure Entra IDページを開き、左部メニュー内の「管理 > エンタープライズアプリケーション」をクリックし、

    テナントの検索ボックスに[Qast]と入力し、検索結果に表示された[Qast Productionアプリケーション]をクリックします。

    左部メニュー内の「プロパティ」をクリックし、画面上部の「削除」をクリックし、アプリの削除をお願いいたします。

    上記の手順で、管理者の方のTeams連携解除完了となります。

【ユーザーによる初期通知設定】

* 本操作は連携開始の初回のみ発生します。 
* 本操作で下記の設定を行います。
    ・QastからTeams個人チャットへの連携設定
* 本設定を行わなくてもTeamsからQastへのシームレス投稿が可能です。
    Teams個人チャットへの通知が不要の場合は設定の必要はありません。
* 本操作は【管理者による初期設定】を行った管理者以外のアカウントで操作を行ってください。
    (管理者の方は【管理者による初期設定】ですでに本設定が完了しているため対応不要です)

1. QastでTeamsの通知連携設定を⾏う

(1)「マイページ > 通知 > Teams連携」のセクションで 「連携する」 ボタンをクリックします。

(2) Microsoftのログイン認証画面が表示されるので、お使いのアカウントでログインします。

※Microsoftアカウントを複数お持ちの場合は、通知を受信したいアカウントでログインしてください。

(3)「連携する」 ボタンが 「連携停⽌」 ボタンになっていることを確認します。

2.Qastでチャット通知設定を行う

(1)「マイページ > 通知 > Teams連携」のセクションで、「連携停止」(Teamsと連携が出来ている状態です)となっていることを確認し、「チャットに通知が届きます」を「ON」に切り替えます。

3.Teamsでアプリの追加を⾏う

(1)「Teams」を起動し、左部メニュー「アプリ > 組織向けに開発」をクリックし、

「Qastアプリ」が表⽰されますので、[追加]をクリックします。

※管理者の設定にてカスタムアプリのアップロード後、Teams側にアプリが反映されるまでに数時間〜数日程度の所要時間が発生する場合があります。

(2)連携完了後は、管理者によって指定されたチャネルに下記のように通知が入ります。

【補足】

通知される内容は下記の通りです。

  • 質問およびメモの作成・更新時

  • 回答およびコメントの作成・更新時

以上で管理者およびユーザーによる初期設定は完了です。

◾️Teamsチャネルへの通知設定

* 本操作は連携開始の初回のみ発生します。 
* 本操作で下記の設定を行います。
    ・QastからTeamsの指定したチャネルへの通知設定
* 複数のTeamsチャネルに通知を送ることはできません。
* プライベートチャネル、共有チャネルへの通知設定はできません。
* 1人のユーザーが設定すれば、残りの全ユーザーに適用されます。
    (設定するユーザーがチームに招待されている必要があります。)

1.Teamsで「Incoming Webhook」アプリを追加する

(1) 「Teams」を起動し、左部メニューの「アプリ」をクリックし、「Incoming Webhook」のアプリの「追加」をクリックします。

(アプリが見つからない場合は検索ボックスに「Incoming」と入力し、検索してください)

(2)「チームに追加」をクリックします。

(3)チームを選択し、「コネクタを設定」をクリックします。

(4)コネクタ設定を行ってください。

(Teamsアプリだとうまくいかない場合は、webでお試しください。)

(5) 設定後、画面下部に表示されたURLをコピーします。

2.QastでTeamsのチャネル通知設定を行う

(1)「マイページ > 通知 > Teams連携 > incoming webhook 」内にコピーしたURLをペーストし、「連携する」をクリックします。

以上で個人チャットへの通知およびシームレス投稿の設定は完了です。

以上でTeamsチャネルへの通知設定は完了です。

◾️備考

Teamsに通知される内容については下記の記事をご参考ください。

こちらの回答で解決しましたか?