Microsoft Teams

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

同梱 Plugin

openclaw plugins install @openclaw/msteams

openclaw plugins install ./path/to/local/msteams-plugin

​

クイックセットアップ

npm install -g @microsoft/teams.cli@preview
teams login
teams status   # verify you're logged in and see your tenant info

# One-time setup (persistent URL across sessions):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot
# Your endpoint: https://<tunnel-id>.devtunnels.ms/api/messages

teams app create \
  --name "OpenClaw" \
  --endpoint "https://<your-tunnel-url>/api/messages"

• Entra ID（Azure AD）アプリケーションを作成
• クライアントシークレットを生成
• Teams アプリマニフェスト（アイコン付き）をビルドしてアップロード
• bot を登録（デフォルトでは Teams 管理、Azure サブスクリプションは不要）

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<CLIENT_ID>",
      appPassword: "<CLIENT_SECRET>",
      tenantId: "<TENANT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

teams app get <teamsAppId> --install-link

teams app doctor <teamsAppId>

​

目標

• Teams DM、グループチャット、またはチャネル経由で OpenClaw と会話する。
• ルーティングを決定的に保つ: 返信は常に到着元のチャネルへ戻る。
• 安全なチャネル動作をデフォルトにする（別途設定しない限りメンションが必要）。

​

設定の書き込み

{
  channels: { msteams: { configWrites: false } },
}

​

アクセス制御（DM + グループ）

• デフォルト: channels.msteams.dmPolicy = "pairing"。不明な送信者は承認されるまで無視されます。
• channels.msteams.allowFrom には、安定した AAD オブジェクト ID、または accessGroup:core-team のような静的な送信者アクセスグループを使用してください。
• allowlist には UPN/表示名の一致に依存しないでください。これらは変更される可能性があります。OpenClaw はデフォルトで直接的な名前一致を無効にしています。明示的に有効化するには channels.msteams.dangerouslyAllowNameMatching: true を設定します。
• ウィザードは、認証情報で許可されている場合、Microsoft Graph 経由で名前を ID に解決できます。

• デフォルト: channels.msteams.groupPolicy = "allowlist"（groupAllowFrom を追加しない限りブロック）。未設定時のデフォルトを上書きするには channels.defaults.groupPolicy を使用します。
• channels.msteams.groupAllowFrom は、グループチャット/チャネルでどの送信者または静的な送信者アクセスグループがトリガーできるかを制御します（channels.msteams.allowFrom にフォールバック）。
• 任意のメンバーを許可するには groupPolicy: "open" を設定します（デフォルトでは引き続きメンションでゲートされます）。
• チャネルを一切許可しない場合は、channels.msteams.groupPolicy: "disabled" を設定します。

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["00000000-0000-0000-0000-000000000000", "accessGroup:core-team"],
    },
  },
}

• channels.msteams.teams 配下にチームとチャネルを列挙して、グループ/チャネル返信のスコープを制限します。
• キーには、変更可能な表示名ではなく、Teams リンクから取得した安定した Teams 会話 ID を使用してください。
• groupPolicy="allowlist" で teams allowlist が存在する場合、列挙されたチーム/チャネルのみが受け入れられます（メンションでゲートされます）。
• 設定ウィザードは Team/Channel エントリを受け付け、代わりに保存します。
• 起動時に、OpenClaw は team/channel と user allowlist の名前を ID に解決し（Graph 権限で許可される場合）、そのマッピングをログに記録します。解決できなかった team/channel 名は入力どおり保持されますが、channels.msteams.dangerouslyAllowNameMatching: true が有効でない限り、デフォルトではルーティングでは無視されます。

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      teams: {
        "My Team": {
          channels: {
            General: { requireMention: true },
          },
        },
      },
    },
  },
}

​

フェデレーション認証（証明書とマネージド ID）

2026.4.11 で追加

​

オプション A: 証明書ベース認証

1. 証明書（秘密鍵付き PEM 形式）を生成または取得します。
2. Entra ID → App Registration → Certificates & secrets → Certificates → 公開証明書をアップロードします。

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      certificatePath: "/path/to/cert.pem",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_CERTIFICATE_PATH=/path/to/cert.pem

​

オプション B: Azure Managed Identity

1. bot pod/VM にマネージド ID（システム割り当てまたはユーザー割り当て）があります。
2. フェデレーション ID 認証情報が、マネージド ID を Entra ID アプリ登録にリンクします。
3. 実行時に、OpenClaw は @azure/identity を使って Azure IMDS エンドポイント（169.254.169.254）からトークンを取得します。
4. トークンは bot 認証のために Teams SDK に渡されます。

• マネージド ID が有効な Azure インフラストラクチャ（AKS workload identity、App Service、VM）
• Entra ID アプリ登録上に作成されたフェデレーション ID 認証情報
• pod/VM から IMDS（169.254.169.254:80）へのネットワークアクセス

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      managedIdentityClientId: "<MI_CLIENT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id>（ユーザー割り当ての場合のみ）

​

AKS ワークロード ID のセットアップ

1. AKS クラスターでワークロード ID を有効化します。
2. Entra ID アプリ登録にフェデレーション ID 資格情報を作成します。
   az ad app federated-credential create --id <APP_OBJECT_ID> --parameters '{
     "name": "my-bot-workload-identity",
     "issuer": "<AKS_OIDC_ISSUER_URL>",
     "subject": "system:serviceaccount:<NAMESPACE>:<SERVICE_ACCOUNT>",
     "audiences": ["api://AzureADTokenExchange"]
   }'
   
3. Kubernetes サービスアカウントにアプリクライアント ID のアノテーションを付けます。
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. ワークロード ID インジェクション用に Pod にラベルを付けます。
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. IMDS（169.254.169.254）へのネットワークアクセスを確保します。NetworkPolicy を使用している場合は、ポート 80 で 169.254.169.254/32 へのトラフィックを許可する egress ルールを追加します。

​

認証タイプの比較

​

ローカル開発（トンネリング）

# One-time setup:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot

teams app update <teamsAppId> --endpoint "https://<new-url>/api/messages"

​

Bot のテスト

teams app doctor <teamsAppId>

1. Teams アプリをインストールします（teams app get <id> --install-link のインストールリンクを使用）
2. Teams で Bot を見つけて DM を送信します
3. 受信アクティビティが Gateway ログに記録されていることを確認します

​

環境変数

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE（任意: "secret" または "federated"）
• MSTEAMS_CERTIFICATE_PATH（フェデレーション + 証明書）
• MSTEAMS_CERTIFICATE_THUMBPRINT（任意、認証には不要）
• MSTEAMS_USE_MANAGED_IDENTITY（フェデレーション + マネージド ID）
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID（ユーザー割り当て MI のみ）

​

メンバー情報アクション

• Member.Read.Group RSC 権限（推奨マニフェストにすでに含まれています）
• チームをまたぐ検索の場合: 管理者同意付きの User.Read.All Graph アプリケーション権限

​

履歴コンテキスト

• channels.msteams.historyLimit は、最近のチャンネル/グループメッセージをいくつプロンプトに含めるかを制御します。
• messages.groupChat.historyLimit にフォールバックします。無効化するには 0 を設定します（デフォルト 50）。
• 取得されたスレッド履歴は送信者許可リスト（allowFrom / groupAllowFrom）でフィルターされるため、スレッドコンテキストのシードには許可された送信者からのメッセージのみが含まれます。
• 引用添付ファイルコンテキスト（Teams 返信 HTML から派生した ReplyTo*）は、現在は受信したまま渡されます。
• つまり、許可リストは誰がエージェントをトリガーできるかを制御します。現時点でフィルターされるのは、特定の補足コンテキストパスのみです。
• DM 履歴は channels.msteams.dmHistoryLimit（ユーザーターン）で制限できます。ユーザーごとの上書き: channels.msteams.dms["<user_id>"].historyLimit。

​

現在の Teams RSC 権限（マニフェスト）

• ChannelMessage.Read.Group（Application）- @mention なしですべてのチャンネルメッセージを受信
• ChannelMessage.Send.Group（Application）
• Member.Read.Group（Application）
• Owner.Read.Group（Application）
• ChannelSettings.Read.Group（Application）
• TeamMember.Read.Group（Application）
• TeamSettings.Read.Group（Application）

• ChatMessage.Read.Chat（Application）- @mention なしですべてのグループチャットメッセージを受信

teams app rsc add <teamsAppId> ChannelMessage.Read.Group --type Application

​

Teams マニフェスト例（編集済み）

{
  $schema: "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json",
  manifestVersion: "1.23",
  version: "1.0.0",
  id: "00000000-0000-0000-0000-000000000000",
  name: { short: "OpenClaw" },
  developer: {
    name: "Your Org",
    websiteUrl: "https://example.com",
    privacyUrl: "https://example.com/privacy",
    termsOfUseUrl: "https://example.com/terms",
  },
  description: { short: "OpenClaw in Teams", full: "OpenClaw in Teams" },
  icons: { outline: "outline.png", color: "color.png" },
  accentColor: "#5B6DEF",
  bots: [
    {
      botId: "11111111-1111-1111-1111-111111111111",
      scopes: ["personal", "team", "groupChat"],
      isNotificationOnly: false,
      supportsCalling: false,
      supportsVideo: false,
      supportsFiles: true,
    },
  ],
  webApplicationInfo: {
    id: "11111111-1111-1111-1111-111111111111",
  },
  authorization: {
    permissions: {
      resourceSpecific: [
        { name: "ChannelMessage.Read.Group", type: "Application" },
        { name: "ChannelMessage.Send.Group", type: "Application" },
        { name: "Member.Read.Group", type: "Application" },
        { name: "Owner.Read.Group", type: "Application" },
        { name: "ChannelSettings.Read.Group", type: "Application" },
        { name: "TeamMember.Read.Group", type: "Application" },
        { name: "TeamSettings.Read.Group", type: "Application" },
        { name: "ChatMessage.Read.Chat", type: "Application" },
      ],
    },
  },
}

​

マニフェストの注意点（必須フィールド）

• bots[].botId は Azure Bot App ID と一致している必要があります。
• webApplicationInfo.id は Azure Bot App ID と一致している必要があります。
• bots[].scopes には、使用予定のサーフェス（personal、team、groupChat）を含める必要があります。
• 個人スコープでファイル処理を行うには、bots[].supportsFiles: true が必要です。
• チャンネルトラフィックが必要な場合、authorization.permissions.resourceSpecific にはチャンネルの読み取り/送信を含める必要があります。

​

既存アプリの更新

# Download, edit, and re-upload the manifest
teams app manifest download <teamsAppId> manifest.json
# Edit manifest.json locally...
teams app manifest upload manifest.json <teamsAppId>
# Version is auto-bumped if content changed

​

機能: RSC のみ vs Graph

​

Teams RSC のみの場合（アプリはインストール済み、Graph API 権限なし）

• チャンネルメッセージのテキストコンテンツを読み取る。
• チャンネルメッセージのテキストコンテンツを送信する。
• **個人（DM）**ファイル添付を受信する。

• チャンネル/グループの画像またはファイル内容（ペイロードには HTML スタブのみが含まれます）。
• SharePoint/OneDrive に保存された添付ファイルのダウンロード。
• メッセージ履歴の読み取り（ライブ Webhook イベントを超えるもの）。

​

Teams RSC + Microsoft Graph アプリケーション権限の場合

• ホストされたコンテンツ（メッセージに貼り付けられた画像）のダウンロード。
• SharePoint/OneDrive に保存されたファイル添付のダウンロード。
• Graph 経由でのチャンネル/チャットメッセージ履歴の読み取り。

​

RSC vs Graph API

​

Graph 対応メディア + 履歴（チャンネルに必須）

1. Entra ID（Azure AD）の App Registration で、Microsoft Graph アプリケーション権限を追加します。
   • ChannelMessage.Read.All（チャンネル添付ファイル + 履歴）
   • Chat.Read.All または ChatMessage.Read.All（グループチャット）
2. テナントに対して管理者同意を付与します。
3. Teams アプリのマニフェストバージョンを上げ、再アップロードして、Teams でアプリを再インストールします。
4. キャッシュされたアプリメタデータをクリアするために、Teams を完全に終了して再起動します。

​

既知の制限

​

Webhook タイムアウト

• Gateway タイムアウト
• Teams がメッセージを再試行する（重複が発生）
• 返信のドロップ

​

書式

• 基本的な書式は機能します: bold, italic, code, リンク
• 複雑な markdown（テーブル、ネストされたリスト）は正しくレンダリングされない場合があります
• Adaptive Cards は、投票とセマンティックなプレゼンテーション送信でサポートされています（下記参照）

​

設定

• channels.msteams.enabled: チャネルを有効化/無効化します。
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: bot 認証情報。
• channels.msteams.webhook.port（デフォルト 3978）
• channels.msteams.webhook.path（デフォルト /api/messages）
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled（デフォルト: pairing）
• channels.msteams.allowFrom: ダイレクトメッセージの許可リスト（AAD オブジェクト ID 推奨）。Graph アクセスが利用可能な場合、ウィザードはセットアップ中に名前を ID に解決します。
• channels.msteams.dangerouslyAllowNameMatching: 変更可能な UPN/表示名の照合と、チーム/チャネル名による直接ルーティングを再有効化するための緊急用トグル。
• channels.msteams.textChunkLimit: 送信テキストのチャンクサイズ。
• channels.msteams.chunkMode: 長さによるチャンク分割の前に空行（段落境界）で分割するには、length（デフォルト）または newline。
• channels.msteams.mediaAllowHosts: 受信添付ファイルホストの許可リスト（デフォルトは Microsoft/Teams ドメイン）。
• channels.msteams.mediaAuthAllowHosts: メディア再試行時に Authorization ヘッダーを付与するホストの許可リスト（デフォルトは Graph + Bot Framework ホスト）。
• channels.msteams.requireMention: チャネル/グループで @mention を必須にします（デフォルト true）。
• channels.msteams.replyStyle: thread | top-level（返信スタイルを参照）。
• channels.msteams.teams.<teamId>.replyStyle: チーム単位のオーバーライド。
• channels.msteams.teams.<teamId>.requireMention: チーム単位のオーバーライド。
• channels.msteams.teams.<teamId>.tools: チャネルのオーバーライドがない場合に使われる、チーム単位のデフォルトのツールポリシーオーバーライド（allow/deny/alsoAllow）。
• channels.msteams.teams.<teamId>.toolsBySender: 送信者ごとのチーム単位デフォルトのツールポリシーオーバーライド（"*" ワイルドカードをサポート）。
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: チャネル単位のオーバーライド。
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: チャネル単位のオーバーライド。
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: チャネル単位のツールポリシーオーバーライド（allow/deny/alsoAllow）。
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: チャネル単位、送信者ごとのツールポリシーオーバーライド（"*" ワイルドカードをサポート）。
• toolsBySender キーには明示的なプレフィックスを使う必要があります: channel:, id:, e164:, username:, name:（従来のプレフィックスなしキーは現在も id: のみにマップされます）。
• channels.msteams.actions.memberInfo: Graph に基づくメンバー情報アクションを有効化または無効化します（デフォルト: Graph 認証情報が利用可能な場合は有効）。
• channels.msteams.authType: 認証タイプ - "secret"（デフォルト）または "federated"。
• channels.msteams.certificatePath: PEM 証明書ファイルへのパス（federated + certificate 認証）。
• channels.msteams.certificateThumbprint: 証明書のサムプリント（任意、認証には不要）。
• channels.msteams.useManagedIdentity: マネージド ID 認証を有効化します（federated モード）。
• channels.msteams.managedIdentityClientId: ユーザー割り当てマネージド ID のクライアント ID。
• channels.msteams.sharePointSiteId: グループチャット/チャネルでのファイルアップロード用 SharePoint サイト ID（グループチャットでのファイル送信を参照）。

​

ルーティングとセッション

• セッションキーは標準のエージェント形式に従います（/concepts/session を参照）:
  • ダイレクトメッセージはメインセッションを共有します（agent:<agentId>:<mainKey>）。
  • チャネル/グループメッセージは会話 ID を使います:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

返信スタイル: スレッドと投稿

• Threads スタイルのチャネルで thread → 返信が不自然にネストされて表示されます
• Posts スタイルのチャネルで top-level → 返信がスレッド内ではなく、個別のトップレベル投稿として表示されます

{
  channels: {
    msteams: {
      replyStyle: "thread",
      teams: {
        "19:abc...@thread.tacv2": {
          channels: {
            "19:xyz...@thread.tacv2": {
              replyStyle: "top-level",
            },
          },
        },
      },
    },
  },
}

​

解決の優先順位

1. チャネル単位 — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. チーム単位 — channels.msteams.teams.<teamId>.replyStyle
3. グローバル — channels.msteams.replyStyle
4. 暗黙のデフォルト — requireMention から導出:
   • requireMention: true → thread
   • requireMention: false → top-level

​

スレッドコンテキストの保持

​

添付ファイルと画像

• ダイレクトメッセージ: 画像とファイル添付は Teams bot ファイル API 経由で機能します。
• チャネル/グループ: 添付ファイルは M365 ストレージ（SharePoint/OneDrive）に保存されます。Webhook ペイロードには、実際のファイルバイトではなく HTML スタブのみが含まれます。チャネル添付ファイルをダウンロードするには Graph API 権限が必要です。
• 明示的なファイル優先送信では、media / filePath / path とともに action=upload-file を使います。任意の message は付随するテキスト/コメントになり、filename はアップロード名を上書きします。

​

グループチャットでのファイル送信

​

グループチャットに SharePoint が必要な理由

​

セットアップ

1. Entra ID（Azure AD）→ App Registration で Graph API 権限を追加します:
   • Sites.ReadWrite.All（Application）- SharePoint にファイルをアップロード
   • Chat.Read.All（Application）- 任意、ユーザー単位の共有リンクを有効化
2. テナントに対して 管理者の同意を付与します。
3. SharePoint サイト ID を取得します:
   # Via Graph Explorer or curl with a valid token:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Example: for a site at "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Response includes: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. OpenClaw を設定します:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

共有の挙動

​

フォールバックの挙動

​

ファイルの保存場所

​

投票（Adaptive Cards）

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• 投票は Gateway によって ~/.openclaw/msteams-polls.json に記録されます。
• 投票を記録するには、Gateway がオンラインのままである必要があります。
• 投票はまだ結果サマリーを自動投稿しません（必要に応じてストアファイルを確認してください）。

​

プレゼンテーションカード

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello!"}]}'

​

ターゲット形式

# Send to a user by ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Send to a user by display name (triggers Graph API lookup)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Send to a group chat or channel
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# Send a presentation card to a conversation
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "Hello!",
}

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello" }],
  },
}

​

プロアクティブメッセージング

• プロアクティブメッセージは、ユーザーがやり取りした後でのみ可能です。その時点で会話参照を保存するためです。
• dmPolicy と許可リストのゲーティングについては、/gateway/configuration を参照してください。

​

チーム ID とチャンネル ID（よくある落とし穴）

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    チーム会話 ID（これを URL デコードする）

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      チャンネル ID（これを URL デコードする）

• チームキー = /team/ の後のパスセグメント（URL デコード済み。例: 19:Bk4j...@thread.tacv2。古いテナントでは @thread.skype が表示される場合があり、これも有効）
• チャンネルキー = /channel/ の後のパスセグメント（URL デコード済み）
• OpenClaw ルーティングでは groupId クエリパラメーターを無視してください。これは Microsoft Entra グループ ID であり、受信する Teams アクティビティで使用される Bot Framework 会話 ID ではありません。

​

プライベートチャンネル

1. ボットとのやり取りには標準チャンネルを使用する
2. DM を使用する - ユーザーはいつでもボットに直接メッセージを送信できる
3. 履歴アクセスには Graph API を使用する（ChannelMessage.Read.All が必要）

​

トラブルシューティング

​

よくある問題

• チャンネルに画像が表示されない: Graph 権限または管理者の同意がありません。Teams アプリを再インストールし、Teams を完全に終了してから再度開いてください。
• チャンネルで応答がない: デフォルトではメンションが必要です。channels.msteams.requireMention=false を設定するか、チーム/チャンネルごとに構成してください。
• バージョン不一致（Teams に古いマニフェストが表示され続ける）: アプリを削除して再追加し、更新するために Teams を完全に終了してください。
• webhook からの 401 Unauthorized: Azure JWT なしで手動テストする場合は想定どおりです。エンドポイントには到達できていますが、認証に失敗したことを意味します。正しくテストするには Azure Web Chat を使用してください。

​

マニフェストのアップロードエラー

• 「Icon file cannot be empty」: マニフェストが 0 バイトのアイコンファイルを参照しています。有効な PNG アイコンを作成してください（outline.png は 32x32、color.png は 192x192）。
• 「webApplicationInfo.Id already in use」: アプリがまだ別のチーム/チャットにインストールされています。先に見つけてアンインストールするか、反映されるまで 5〜10 分待ってください。
• アップロード時の「Something went wrong」: 代わりに https://admin.teams.microsoft.com からアップロードし、ブラウザーの DevTools（F12）→ Network タブを開いて、実際のエラーについてレスポンス本文を確認してください。
• サイドロードに失敗する: 「Upload a custom app」ではなく「Upload an app to your org’s app catalog」を試してください。これにより、サイドロード制限を回避できることがよくあります。

​

RSC 権限が動作しない

1. webApplicationInfo.id がボットの App ID と完全に一致していることを確認する
2. アプリを再アップロードし、チーム/チャットに再インストールする
3. 組織の管理者が RSC 権限をブロックしていないか確認する
4. 適切なスコープを使用していることを確認する: チームには ChannelMessage.Read.Group、グループチャットには ChatMessage.Read.Chat

​

参考資料

• Azure Bot を作成 - Azure Bot セットアップガイド
• Teams Developer Portal - Teams アプリの作成/管理
• Teams アプリマニフェストスキーマ
• RSC でチャンネルメッセージを受信
• RSC 権限リファレンス
• Teams ボットのファイル処理（チャンネル/グループには Graph が必要）
• プロアクティブメッセージング
• @microsoft/teams.cli - ボット管理用 Teams CLI

​

関連

• チャンネル概要 - サポートされるすべてのチャンネル
• ペアリング - DM 認証とペアリングフロー
• グループ - グループチャットの動作とメンションゲーティング
• チャンネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと強化