​

Microsoft Teams (플러그인)

“여기에 들어오는 자 모든 희망을 버려라.”

​

플러그인 필수

openclaw plugins install @openclaw/msteams

openclaw plugins install ./extensions/msteams

​

빠른 설정 (초보자용)

1. Microsoft Teams 플러그인을 설치합니다.
2. Azure Bot을 만듭니다 (App ID + 클라이언트 비밀번호 + 테넌트 ID).
3. 해당 자격 증명으로 OpenClaw를 구성합니다.
4. /api/messages (기본 포트 3978)를 공용 URL 또는 터널링을 통해 노출합니다.
5. Teams 앱 패키지를 설치하고 게이트웨이를 시작합니다.

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

​

목표

• Teams 다이렉트 메시지, 그룹 채팅 또는 채널을 통해 OpenClaw와 대화합니다.
• 라우팅을 결정적으로 유지: 답장은 항상 도착한 채널로 돌아갑니다.
• 기본적으로 안전한 채널 동작을 유지 (언급이 필요함, 다르게 구성하지 않는 한).

​

구성 쓰기

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

​

접근 제어 (다이렉트 메시지 + 그룹)

• 기본값: channels.msteams.dmPolicy = "pairing"입니다. 승인될 때까지 알려지지 않은 발신자는 무시됩니다.
• channels.msteams.allowFrom은 AAD 객체 ID, UPN 또는 표시 이름을 허용합니다. 마법사는 자격 증명이 허용될 때 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: ["user@org.com"],
    },
  },
}

• channels.msteams.teams에 팀 및 채널을 나열하여 그룹/채널의 응답 범위를 지정합니다.
• 키는 팀 ID 또는 이름일 수 있으며, 채널 키는 대화 ID 또는 이름일 수 있습니다.
• groupPolicy="allowlist"이고 팀 허용 목록이 존재할 때, 목록에 있는 팀/채널만 허용됩니다 (언급 필요).
• 구성 마법사는 Team/Channel 항목을 허용하고 이를 저장합니다.
• OpenClaw는 시작 시 팀/채널과 사용자 허용 목록 이름을 ID로 해석하고 (Graph 권한이 허용될 때) 매핑을 로그합니다. 해석되지 않은 항목은 유형대로 유지됩니다.

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

​

작동 방식

1. Microsoft Teams 플러그인을 설치합니다.
2. Azure Bot을 만듭니다 (App ID + 비밀 + 테넌트 ID).
3. 봇을 참조하고 아래 RSC 권한을 포함하는 Teams 앱 패키지를 만듭니다.
4. 팀 (또는 다이렉트 메시지 개인 범위) 내에서 Teams 앱을 업로드/설치합니다.
5. ~/.openclaw/openclaw.json (또는 환경 변수)에서 msteams를 구성하고 게이트웨이를 시작합니다.
6. 게이트웨이는 기본적으로 /api/messages에서 Bot Framework 웹훅 트래픽을 수신합니다.

​

Azure Bot 설정 (필수 조건)

​

1단계: Azure Bot 생성

1. Create Azure Bot로 이동
2. 기본 탭 작성:

   필드	값
   봇 핸들	봇 이름, 예: openclaw-msteams (고유해야 함)
   구독	Azure 구독 선택
   리소스 그룹	새로 만들기 또는 기존 사용
   가격 책정 등급	개발/테스트용으로 무료
   앱 유형	싱글 테넌트 (권장 - 아래 참고)
   생성 유형	Microsoft App ID 새로 만들기

지원 중단 공지: 새로운 멀티 테넌트 봇 생성이 2025-07-31 이후 지원 중단되었습니다. 새로운 봇에 대해 싱글 테넌트를 사용하세요.

3. 검토 + 생성 → 생성 클릭 (약 1-2분 소요)

​

2단계: 자격 증명 얻기

1. Azure Bot 리소스에 가서 → Configuration 클릭
2. Microsoft App ID를 복사 → 이는 appId입니다
3. 비밀번호 관리 클릭 → 앱 등록으로 이동
4. 인증서 & 비밀 아래 → 새 클라이언트 비밀 → 값을 복사 → 이는 appPassword입니다
5. 개요로 이동 → 디렉토리 (테넌트) ID를 복사 → 이는 tenantId입니다

​

3단계: 메시징 엔드포인트 구성

1. Azure Bot → Configuration에서
2. 메시징 엔드포인트를 웹훅 URL로 설정:
   • 프로덕션: https://your-domain.com/api/messages
   • 로컬 개발: 터널 사용 (아래 로컬 개발 참조)

​

4단계: Teams 채널 활성화

1. Azure Bot → 채널에서
2. Microsoft Teams 클릭 → 구성 → 저장
3. 서비스 약관 동의

​

로컬 개발 (터널링)

ngrok http 3978
# https URL 복사, 예: https://abc123.ngrok.io
# 메시징 엔드포인트로 설정: https://abc123.ngrok.io/api/messages

tailscale funnel 3978
# Tailscale funnel URL을 메시징 엔드포인트로 사용

​

Teams 개발자 포털 (대안)

1. + 새 앱 클릭
2. 기본 정보 입력 (이름, 설명, 개발자 정보)
3. 앱 기능 → 봇으로 이동
4. 봇 ID 수동 입력 선택 후 Azure Bot App ID 붙여넣기
5. 범위 체크: 개인, 팀, 그룹 채팅
6. 배포 클릭 → 앱 패키지 다운로드
7. Teams에서: 앱 → 앱 관리 → 커스텀 앱 업로드 → ZIP 선택

​

봇 테스트

1. Azure Portal에서 → Azure Bot 리소스로 가서 → 웹 채팅에서 테스트 클릭
2. 메시지 보내기 - 응답이 보여야 합니다
3. 이는 Teams 설정 전에 웹훅 엔드포인트가 작동하는지 확인시켜줍니다

1. Teams 앱 설치 (사이드로드 또는 조직 카탈로그)
2. Teams에서 봇 찾기 후 다이렉트 메시지 보내기
3. 게이트웨이 로그에서 들어오는 활동 확인

​

설정 (최소 텍스트 전용)

1. Microsoft Teams 플러그인 설치
   • npm에서: openclaw plugins install @openclaw/msteams
   • 로컬 체크아웃에서: openclaw plugins install ./extensions/msteams
2. 봇 등록
   • Azure Bot 생성 (위 참조) 및 노트:
     • App ID
     • 클라이언트 비밀 (앱 비밀번호)
     • 테넌트 ID (싱글 테넌트)
3. Teams 앱 매니페스트
   • bot 항목에 botId = <App ID>를 포함하십시오.
   • 범위: personal, team, groupChat.
   • supportsFiles: true (개인 범위 파일 처리 필요).
   • RSC 권한 추가 (아래).
   • 아이콘 생성: outline.png (32x32) 및 color.png (192x192).
   • 모든 세 파일을 manifest.json, outline.png, color.png로 압축합니다.
4. OpenClaw 구성
   복사

   AI에게 묻기

   {
     "msteams": {
       "enabled": true,
       "appId": "<APP_ID>",
       "appPassword": "<APP_PASSWORD>",
       "tenantId": "<TENANT_ID>",
       "webhook": { "port": 3978, "path": "/api/messages" }
     }
   }
   
   환경 변수를 구성 키 대신 사용할 수도 있습니다:
   • MSTEAMS_APP_ID
   • MSTEAMS_APP_PASSWORD
   • MSTEAMS_TENANT_ID
5. 봇 엔드포인트
   • Azure Bot Messaging Endpoint를 설정:
     • https://<host>:3978/api/messages (또는 선택한 경로/포트).
6. 게이트웨이 실행
   • 플러그인이 설치되고 msteams 구성이 자격 증명과 함께 존재할 때 Teams 채널이 자동으로 시작됩니다.

​

히스토리 컨텍스트

• channels.msteams.historyLimit은 프롬프트에 래핑될 최근 채널/그룹 메시지 수를 제어합니다.
• messages.groupChat.historyLimit으로 되돌아갑니다. 0으로 설정하여 비활성화 (기본값 50).
• 다이렉트 메시지 히스토리는 channels.msteams.dmHistoryLimit (사용자 턴)으로 제한할 수 있습니다. 사용자별 오버라이드는 channels.msteams.dms["<user_id>"].historyLimit입니다.

​

현재 Teams RSC 권한 (매니페스트)

• ChannelMessage.Read.Group (애플리케이션) - 모든 채널 메시지를 @언급 없이 수신
• ChannelMessage.Send.Group (애플리케이션)
• Member.Read.Group (애플리케이션)
• Owner.Read.Group (애플리케이션)
• ChannelSettings.Read.Group (애플리케이션)
• TeamMember.Read.Group (애플리케이션)
• TeamSettings.Read.Group (애플리케이션)

• ChatMessage.Read.Chat (애플리케이션) - 모든 그룹 채팅 메시지를 @언급 없이 수신

​

예제 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는 채널 트래픽을 원한다면 채널 읽기/보내기를 포함해야 합니다.

​

기존 앱 업데이트

1. 새 설정으로 manifest.json 업데이트
2. version 필드 증가 (예: 1.0.0 → 1.1.0)
3. 아이콘과 함께 매니페스트를 재압축 (manifest.json, outline.png, color.png)
4. 새 zip 업로드:
   • 옵션 A (Teams 관리자 센터): Teams 관리자 센터 → Teams 앱 → 앱 관리 → 앱 찾기 → 새 버전 업로드
   • 옵션 B (사이드로드): Teams에서 → 앱 → 앱 관리 → 커스텀 앱 업로드
5. 팀 채널의 경우: 새 권한이 적용되도록 각 팀에서 앱을 다시 설치
6. Teams를 완전히 종료한 후 다시 시작 (창을 닫는 것만으로는 안 됩니다)하여 캐시된 앱 메타데이터를 지웁니다.

​

기능: RSC 전용 vs Graph

​

Teams RSC 전용으로 (앱 설치, Graph API 권한 없음)

• 채널 메시지 텍스트 내용 읽기.
• 채널 메시지 텍스트 내용 보내기.
• 개인 (다이렉트 메시지) 파일 첨부 수신.

• 채널/그룹 이미지 또는 파일 내용 (페이로드에 HTML 스텁만 포함).
• SharePoint/OneDrive에 저장된 첨부 파일 다운로드.
• 메시히스토리 읽기 (실시간 웹훅 이벤트 제외).

​

Teams RSC + Microsoft Graph 애플리케이션 권한으로

• 호스팅된 콘텐츠 다운로드 (메시지에 붙여넣은 이미지).
• SharePoint/OneDrive에 저장된 파일 첨부 다운로드.
• Graph를 통한 채널/채팅 메시지 히스토리 읽기.

​

RSC vs Graph API

​

Graph로 가능해진 미디어 + 히스토리 (채널에 필요)

1. Entra ID (Azure AD) 앱 등록에서 Microsoft Graph 애플리케이션 권한을 추가:
   • ChannelMessage.Read.All (채널 첨부 + 히스토리)
   • Chat.Read.All 또는 ChatMessage.Read.All (그룹 채팅)
2. 테넌트에 관리자 동의.
3. Teams 앱 매니페스트 버전을 높이고, 재업로드하고 Teams에서 앱을 재설치합니다.
4. 캐시된 앱 메타데이터를 지우기 위해 Teams를 완전히 종료한 후 다시 시작합니다.

​

알려진 제한 사항

​

웹훅 타임아웃

• 게이트웨이 타임아웃
• Teams가 메시지를 재전송함 (중복 발생)
• 응답이 누락됨

​

서식

• 기본 서식 작동: 굵게, 기울임꼴, 코드, 링크
• 복잡한 마크다운 (표, 중첩 목록)은 올바르게 표시되지 않을 수 있음
• Adaptive Cards는 투표 및 임의 카드 전송에 지원됨 (아래 참조)

​

구성

• channels.msteams.enabled: 채널 활성화/비활성화.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: 봇 자격 증명.
• channels.msteams.webhook.port (기본 3978)
• channels.msteams.webhook.path (기본 /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (기본값: pairing)
• channels.msteams.allowFrom: 다이렉트 메시지에 대한 허용 목록 (AAD 객체 ID, UPN 또는 표시 이름). Graph 액세스가 가능할 때 설정 중에 마법사는 이름을 ID로 해석합니다.
• channels.msteams.textChunkLimit: 발신 텍스트 청크 크기.
• channels.msteams.chunkMode: length (기본값) 또는 newline으로 빈 줄 (단락 경계)에서 분할 후 길이 청크.
• channels.msteams.mediaAllowHosts: 인바운드 첨부 파일 호스트에 대한 허용 목록 (기본적으로 Microsoft/Teams 도메인).
• channels.msteams.mediaAuthAllowHosts: 미디어 재시도 시 승인 헤더를 첨부할 허용 호스트 목록 (기본적으로 Graph + Bot Framework 호스트).
• channels.msteams.requireMention: 채널/그룹에서 @언급 필수 (기본값 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: 채널별 발신자별 도구 정책 오버라이드 ("*" 와일드카드 지원).
• channels.msteams.sharePointSiteId: 그룹 채팅/채널에서 파일 업로드를 위한 SharePoint 사이트 ID (자세한 내용은 그룹 채팅에서 파일 보내기 참조).

​

라우팅 및 세션

• 세션 키는 표준 에이전트 형식을 따릅니다 (자세한 내용은 /concepts/session 참조):
  • 다이렉트 메시지는 메인 세션을 공유합니다 (agent:<agentId>:<mainKey>).
  • 채널/그룹 메시지는 대화 ID를 사용합니다:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

답글 스타일: 쓰레드 vs 포스트

• Threads 스타일 채널에서 thread → 답글이 어색하게 중첩됨
• Posts 스타일 채널에서 top-level → 답글이 개별 최상위 포스트로 나타남

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

​

첨부 파일 및 이미지

• 다이렉트 메시지: 이미지 및 파일 첨부는 Teams 봇 파일 API를 통해 작동합니다.
• 채널/그룹: 첨부 파일은 M365 스토리지 (SharePoint/OneDrive)에 있습니다. 웹훅 페이로드는 실제 파일 바이트가 아닌 HTML 스텁만 포함합니다. 채널 첨부 파일을 다운로드하려면 Graph API 권한이 필요합니다.

​

그룹 채팅에서 파일 보내기

​

왜 그룹 채팅에 SharePoint가 필요한가

​

설정

1. Entra ID (Azure AD)에서 Graph API 권한 추가 → 앱 등록:
   • Sites.ReadWrite.All (애플리케이션) - SharePoint에 파일 업로드
   • Chat.Read.All (애플리케이션) - 선택 사항, 사용자별 공유 링크 활성화
2. 테넌트에 관리자 동의.
3. 자신의 SharePoint 사이트 ID를 찾으세요:
   복사

   AI에게 묻기

   # Graph Explorer 또는 유효한 토큰으로 curl을 통해:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # 예: "contoso.sharepoint.com/sites/BotFiles"에 있는 사이트의 경우
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # 응답에는 다음이 포함됩니다: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. OpenClaw 구성:
   복사

   AI에게 묻기

   {
     channels: {
       msteams: {
         // ... 다른 구성 ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

공유 동작

​

대체 동작

​

파일 저장 위치

​

투표 (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• 투표는 ~/.openclaw/msteams-polls.json에 있는 게이트웨이에 의해 기록됩니다.
• 게이트웨이는 투표를 기록하기 위해 온라인 상태를 유지해야 합니다.
• 투표는 아직 자동으로 결과 요약을 게시하지 않습니다 (필요한 경우 저장 파일을 검사).

​

Adaptive Cards (임의)

{
  "action": "send",
  "channel": "msteams",
  "target": "user:<id>",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello!" }]
  }
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello!"}]}'

​

대상 형식

# 사용자에게 ID로 전송
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# 사용자에게 표시 이름으로 전송 (Graph API 조회 결과)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# 그룹 채팅 또는 채널로 전송
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# 대화에 Adaptive Card 전송
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello"}]}'

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

{
  "action": "send",
  "channel": "msteams",
  "target": "conversation:19:abc...@thread.tacv2",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello" }]
  }
}

​

능동적 메시지 전송

• 능동적 메시지는 사용자가 상호작용한 후에만 가능합니다, 그 시점에서 대화 참조를 저장하기 때문입니다.
• /gateway/configuration에서 dmPolicy 및 허용 목록 게이트에 대한 내용을 참조하십시오.

​

팀 및 채널 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 디코드)

• 팀 ID = /team/ 이후 경로 세그먼트 (URL 디코드, 예: 19:Bk4j...@thread.tacv2)
• 채널 ID = /channel/ 이후 경로 세그먼트 (URL 디코드)
• groupId 쿼리 매개변수는 무시하십시오

​

비공개 채널

1. 봇 상호작용을 위한 표준 채널 사용
2. 다이렉트 메시지 사용 - 사용자는 항상 봇에게 메시지를 보낼 수 있음
3. 히스토리 접근을 위한 Graph API 사용 (ChannelMessage.Read.All 필요)

​

문제 해결

​

일반적인 문제

• 채널에서 이미지가 표시되지 않음: Graph 권한 또는 관리자 동의 누락. Teams 앱을 재설치하고 완전히 종료 후 다시 열기.
• 채널에서 응답이 없음: 기본적으로 언급이 필요함; 팀/채널별로 설정하거나 channels.msteams.requireMention=false로 설정.
• 버전 불일치 (Teams에 여전히 이전 매니페스트 표시): 앱 제거 + 재추가 후 Teams를 완전히 종료하여 새로고침.
• 웹훅에서 401 인증 실패: Azure JWT 없이 수동 테스트 시 예상됨 - 엔드포인트에 도달하지만 인증 실패. Azure 웹 채팅을 사용하여 제대로 테스트하십시오.

​

매니페스트 업로드 오류

• “아이콘 파일이 비어 있을 수 없음”: 매니페스트가 제대로 되어 있지 않은 아이콘 파일을 참조함. 유효한 PNG 아이콘 생성 (outline.png 32x32, color.png 192x192).
• “webApplicationInfo.Id 이미 사용 중”: 앱이 다른 팀/채팅에 설치되어 있음. 먼저 앱을 찾고 제거하거나 5-10분 기다려 전파.
• “업로드 중 오류 발생”: https://admin.teams.microsoft.com에서 업로드, 브라우저 개발자 도구 (F12) → 네트워크 탭 열기 후 실제 오류 확인.
• 사이드로드 실패: “조직의 앱 카탈로그에 앱 업로드”를 시도하여 사이드로드 제한을 우회하는 것이 종종 효과적임.

​

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 필요)
• 능동적 메시지 전송