サポートする接続方式
Microsoft Teams 連携では、以下の 2 つの接続方式に対応しています。どちらの方式でも、ボットの会話体験（グループチャット自動作成、DM 対応）は同じです。
前提条件
- AIヘルプデスクの 管理者（Admin） ロールが必要です
- 標準ボット の場合: Microsoft Azure AD テナントの管理者権限が必要です（管理者同意の付与）
- カスタムボット の場合: Azure Active Directory でボットアプリの登録・権限付与の権限が必要です
標準ボットで接続する
管理者同意（Admin Consent）により Admina の公式 Teams アプリをインストールする方式です。Azure でアプリ登録を自社管理する必要がありません。1
連携設定を開く
左のナビゲーションから 設定 を選択し、連携 タブを開きます。
メッセージング セクションで 接続を追加 ボタンをクリックし、Microsoft Teams — 標準ボット を選択します。
2
管理者同意を付与する
Microsoft の管理者同意ページにリダイレクトされます。
Azure AD 管理者アカウントでログインし、Admina AI Helpdesk アプリへの権限付与を承認します。
3
オブザーバーユーザーを選択する
グループチャットセッションを成立させるために、オブザーバーユーザーを 1 名以上選択します。
一覧から適切なユーザーを選択し、接続 をクリックします。
オブザーバーユーザーは、グループチャットの技術的要件です。通常は問い合わせ内容を閲覧しない専用アカウントの利用を推奨します。
4
接続完了を確認する
認証が成功すると、メッセージング セクションに Microsoft Teams（標準ボット）のカードが表示されます。
カスタムボットで接続する
Azure AD でボットアプリを登録し、App ID・App Password などを AIヘルプデスクに入力して接続する方式です。接続に必要な情報
Azure 側のセットアップ
Bot Service を作成する
- Azure Portal で Bot Service に移動し、+ Create > Azure Bot を選択
- Bot handle 名やテナント設定などを入力して送信
- Microsoft App ID は新規作成または既存利用から選択
-
Bot の Configuration で Messaging endpoint を以下に設定します
- Bot の Channels で Microsoft Teams チャネルを有効化します
アプリ登録に必要な API 権限
アプリ登録の API Permissions に以下の権限を追加し、管理者の同意 を付与してください。クライアントシークレットの発行
アプリ登録の Certificates & secrets で新しいシークレットを発行し、表示された 値 を控えます（後で参照できなくなります）。この値が アプリパスワード になります。Teams アプリのアップロードとカタログ ID の取得
Microsoft Teams 管理センター の Teams アプリ > アプリの管理 からアプリパッケージ（zip）をアップロードしてください。アップロード後、アプリ詳細画面の URL に表示されるカタログ ID をコピーします。接続手順
1
連携設定を開く
左のナビゲーションから 設定 を選択し、連携 タブを開きます。
メッセージング セクションで 接続を追加 ボタンをクリックし、Microsoft Teams — カスタムボット を選択します。
2
認証情報を入力する
アプリ ID・アプリパスワード・テナント ID・Teams アプリ ID を入力し、次へ をクリックします。
入力内容を検証するため、Azure AD への確認が行われます。
3
オブザーバーユーザーを選択する
グループチャットセッションを成立させるために、オブザーバーユーザーを 1 名以上選択します。
一覧から適切なユーザーを選択し、接続 をクリックします。
オブザーバーユーザーは、グループチャットの技術的要件です。通常は問い合わせ内容を閲覧しない専用アカウントの利用を推奨します。
4
接続完了を確認する
接続が成功すると、メッセージング セクションに Microsoft Teams のカードが表示されます。
ボットを利用する
接続完了後、Teams ユーザーはボットとのダイレクトチャットで問い合わせができます。ユーザーがボットにメッセージを送信すると、グループチャットが自動的に作成されセッションが開始されます。接続を解除する
設定 > 連携 タブの メッセージング セクションで、切断するカードのゴミ箱アイコンをクリックしてください。トラブルシューティング
管理者同意が拒否された（標準ボット） Azure AD 管理者に確認し、Admina AI Helpdesk アプリへの管理者同意を承認してもらってください。 承認が難しい場合は カスタムボット での接続を検討してください。 「認証情報が無効です」と表示される（カスタムボット）- アプリ ID・パスワード・テナント ID が正しいか確認してください
- クライアントシークレットの有効期限が切れていないか確認してください
- Teams 管理センターでアプリが承認・配布されているか確認してください
- ボットサービスのエンドポイント URL が正しく設定されているか確認してください