Teams 채널 관리
n8n v2.47요약
Microsoft Teams 채널은 다음에서 사용할 수 있습니다. 에이전트용 Microsoft Teams 채널은 프리뷰 상태이며 향후 릴리즈에서 변경될 수 있습니다. Teams를 연결한 후에는 채널 설정에서 변경합니다.
기능 제공 여부
Microsoft Teams 채널은 다음에서 사용할 수 있습니다.
- n8n Cloud: 모든 플랜
- 셀프 호스팅: n8n 2.32.3 이상의 모든 플랜
프리뷰 상태
에이전트용 Microsoft Teams 채널은 프리뷰 상태이며 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 환경에서는 이 채널에 의존하지 않는 것이 좋습니다.
Teams를 연결한 후에는 채널 설정에서 변경합니다. 에이전트를 열고 Channels로 이동한 다음 Microsoft Teams를 선택합니다.
채널 설정에는 다음 항목이 표시됩니다.
- 작동 위치: 에이전트를 사용할 수 있는 위치의 옵션과 관리자가 Microsoft Graph 권한을 승인했는지 여부입니다.
- Teams에서의 모습: 앱의 표시 이름, 설명, 아이콘입니다. 권장 설정에서는 Install app 메뉴도 여기에 있습니다.
- Azure Bot: 권장 설정에서는 Linked to Azure Bot과 Find it in Azure 링크가 표시됩니다. 수동 설정에서는 Find your Azure Bot 링크가 표시됩니다.
앱 업로드 또는 조직에 게시#
앱을 Teams에 추가하는 방법은 두 가지입니다.
| Install for me(업로드) | Publish to organization | |
|---|---|---|
| 앱을 추가할 수 있는 사람 | 본인과 zip 파일을 전달받은 사람 | Teams 앱 스토어를 통한 조직 내 모든 사용자 |
| 승인 주체 | Teams 정책이 사용자 지정 앱 업로드를 허용하는 경우 없음 | 본인이 Teams 관리자가 아니라면 Teams 관리자 |
| 소요 시간 | 즉시 | Microsoft가 앱을 목록에 올리기까지 최대 하루이며, 승인을 기다리는 경우 더 길어짐 |
| 업데이트 반영 방식 | 모든 사용자가 새 zip 파일을 다시 업로드 | 다시 게시하면 Teams가 모든 사용자의 앱을 업데이트 |
| 사용 가능한 설정 | 권장 설정 및 수동 설정 | 권장 설정 |
Install for me#
Install for me는 앱 패키지를 다운로드합니다. Teams에서 Apps > Manage your apps > Upload an app에서 업로드한 다음 팀이나 채팅에 추가합니다. 수동 설정에서는 Download app package 단계에 해당합니다.
Upload an app이 보이지 않으면 Teams 관리자에게 사용자 지정 앱 업로드를 허용해 달라고 요청하거나, 대신 앱을 게시합니다.
조직에 게시#
Publish to organization은 Teams의 조직 앱 카탈로그에 앱을 추가합니다. 권장 설정의 Install app 단계에서 찾을 수 있으며, 이후에는 채널 설정의 Install app 메뉴에서 찾을 수 있습니다.
- Teams 관리자인 경우 n8n이 앱을 즉시 게시하지만, Microsoft가 목록에 올리기까지 최대 하루가 걸릴 수 있습니다. 조직의 앱 정책에 따라 Teams 관리자가 Teams 관리 센터에서 모든 사용자가 사용할 수 있도록 추가 설정해야 할 수도 있습니다.
- Teams 관리자가 아닌 경우 n8n이 승인을 위해 앱을 제출합니다. 앱은 Teams 관리 센터의 Teams apps > Manage apps에서 Pending approval 상태로 대기합니다. 관리자가 승인하기 전에는 아무도 앱을 추가할 수 없습니다. 설정 화면에서 Copy a request for your administrator를 선택하면 앱 이름과 해당 페이지 링크가 포함된 메시지가 복사됩니다.
앱이 승인을 기다리고 있거나 관리자가 거부한 경우 채널 설정에 해당 상태가 표시됩니다. 관리자가 거부하면 Microsoft는 그 이유를 공유하지 않으므로 관리자에게 직접 문의하세요.
수동 설정에서는 n8n이 앱을 대신 게시할 수 없습니다. 대신 Teams 관리자에게 Teams 관리 센터에서 앱 패키지를 업로드해 달라고 요청하세요.
작동 위치 또는 모습 변경#
채널 설정에서 Where it works와 표시 이름, 설명 같은 Appearance in Teams를 변경할 수 있습니다. Teams는 새 버전을 전송하기 전까지 이전 버전의 앱을 유지합니다.
- 수동 설정: Save and download package를 선택한 다음 Teams의 Apps > Manage your apps > Upload an app에서 새 패키지를 업로드합니다.
- 권장 설정: Install app 메뉴를 열고 Publish to organization을 선택하거나, Install for me를 선택해 새 패키지를 다운로드하고 업로드합니다.
앱은 에이전트의 이름과 아이콘을 사용합니다. 나중에 에이전트의 이름이나 아이콘을 변경하면 채널 설정에 **Changes to the agent aren't in Teams yet.**라고 표시됩니다. 앱을 다시 설치하거나 게시하여 업데이트하세요.
다른 자격 증명 또는 로그인으로 전환#
자격 증명이나 Microsoft 로그인이 다르면 다른 봇이 되므로, n8n은 이미 연결된 채널에서 이를 교체할 수 없습니다. 채널 설정에서 다른 자격 증명이나 로그인을 선택하면 n8n이 **Set up Microsoft Teams again?**이라고 묻습니다. Set up again을 선택하면 현재 Teams 연결과 설정이 제거되고 설정이 처음부터 다시 시작됩니다. 새 설정을 완료할 때까지 에이전트는 Teams에서 응답하지 않습니다.
클라이언트 시크릿 갱신#
클라이언트 시크릿은 만료됩니다. 시크릿이 만료되면 에이전트가 Teams에서 응답하지 않습니다.
- 권장 설정: n8n은 조직이 허용하는 가장 긴 유효 기간(최대 24개월)으로 시크릿을 생성합니다. Create Teams app 단계가 다시 실행될 때 n8n은 앱 등록을 재사용하며, 현재 시크릿이 7일 이내에 만료되면 새 시크릿을 생성합니다.
- 수동 설정: Microsoft Entra에서 새 클라이언트 시크릿을 생성한 다음 n8n의 자격 증명을 업데이트합니다.
Teams 연결 해제#
Teams 연결을 해제하려면 에이전트에서 채널을 제거하고 Yes, remove로 확인합니다. 이미 보낸 메시지는 Teams에 남습니다. 나중에 다시 연결하려면 채널을 처음부터 다시 설정해야 합니다.
Teams 채널의 연결을 해제하거나 에이전트를 삭제해도 n8n은 Microsoft의 어떤 항목도 삭제하지 않습니다. 사용자는 여전히 앱을 설치한 상태일 수 있지만 에이전트는 더 이상 응답하지 않습니다. 권장 설정이 생성한 앱의 경우 n8n이 Teams 관리 센터로 이동하는 Open Teams 링크와 함께 알림을 표시합니다. 이러한 리소스가 더 이상 필요하지 않다면 직접 제거하세요.
- 앱 등록: Microsoft Entra의 App registrations에서 제거합니다.
- Azure Bot: Azure 포털에서 제거합니다. 권장 설정에서는
n8n-agents리소스 그룹에 있습니다. - Teams 앱: 앱을 게시한 경우 Teams 관리 센터의 Teams apps > Manage apps에서 제거합니다.
문제 해결#
조직에서 앱 등록을 허용하지 않는 경우#
Microsoft 계정으로 앱 등록을 생성할 수 없습니다. 관리자에게 해당 권한을 요청하거나, 관리자가 대신 만들어 준 앱 등록으로 수동 설정을 사용하세요.
Teams 앱에는 회사 또는 학교 계정이 필요한 경우#
개인 Microsoft 계정으로 로그인했습니다. 조직의 회사 또는 학교 계정으로 다시 로그인하세요.
계정이 Azure 구독에서 리소스를 생성할 수 없는 경우#
선택한 Azure 구독에 대한 Contributor 역할이 필요합니다. Azure 관리자에게 액세스를 요청하거나 다른 구독을 선택하세요.
자격 증명이 Microsoft Entra의 앱과 일치하지 않는 경우#
자격 증명의 세부 정보가 앱 등록과 일치하지 않습니다. 다음을 확인하세요.
- 테넌트 ID와 클라이언트 ID가 같은 앱 등록에 속해 있는지 확인합니다.
- 클라이언트 시크릿이 Secret ID가 아니라 시크릿의 Value인지 확인합니다.
- 클라이언트 시크릿이 만료되지 않았는지 확인합니다.
"The Teams bot needs an HTTPS messaging endpoint"#
Microsoft는 HTTPS URL로만 메시지를 보냅니다. 셀프 호스팅 n8n에서는 N8N_WEBHOOK_URL을 인스턴스의 공개 HTTPS URL로 설정하세요.
Teams에 Upload an app 옵션이 없는 경우#
Teams 정책이 사용자 지정 앱 업로드를 허용하지 않습니다. Teams 관리자에게 허용해 달라고 요청하거나, 대신 조직에 앱을 게시하세요.
에이전트가 채널에서 응답하지 않는 경우#
다음을 확인하세요.
- 에이전트를 게시했는지 확인합니다.
- Team channels가 켜져 있고 최신 앱 패키지가 Teams에 있는지 확인합니다.
- 누군가 스레드에서 에이전트를 @멘션했거나 Read all channel messages가 켜져 있는지 확인합니다.
에이전트가 첨부 파일을 읽을 수 없는 경우#
채널과 그룹 채팅의 파일에는 Files.Read.All 애플리케이션 권한이 필요합니다. 관리자가 다른 Graph 권한과 함께 관리자 동의로 한 번에 부여합니다. 적용되기까지 최대 한 시간이 걸릴 수 있습니다. 액세스 승인을 참조하세요.
에이전트가 사용자나 채널을 찾을 수 없는 경우#
이메일로 사용자를 찾으려면 User.ReadBasic.All이 필요하고, 이름으로 채널을 찾으려면 Team.ReadBasic.All과 Channel.ReadBasic.All이 필요합니다. 관리자가 액세스 승인에서 이를 승인합니다. 승인 전까지는 채널에서 에이전트를 한 번 @멘션하거나, 에이전트에 해당 사용자의 Teams ID를 알려 주세요.
에이전트가 다이렉트 메시지를 보내거나 게시할 수 없는 경우#
Teams는 사람들이 앱을 추가한 위치에서 에이전트가 시작한 메시지만 전달합니다. 다이렉트 메시지의 경우 해당 사용자가 Teams에서 앱을 추가해야 합니다. 게시의 경우 해당 팀 또는 그룹 채팅에 앱이 있어야 합니다. 해당 사용자나 팀 소유자에게 앱을 추가해 달라고 요청한 다음 다시 시도하세요.