Microsoft Teams에 봇 연결
적용 대상: SDK v4
Microsoft Teams를 통해 사용자와 통신하도록 봇을 구성할 수 있습니다. 이 문서에서는 Teams에서 Teams 앱을 만들고, 봇을 Azure의 Teams 앱에 연결한 다음, Teams에서 봇을 테스트하는 방법을 설명합니다.
필수 구성 요소
- Azure 구독 아직 구독 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
- Teams에 연결하려는 Azure에 게시된 봇입니다.
- 사용자 지정 앱 업로드 또는 사이드로드를 사용하도록 설정된 Teams의 개발자 테넌트입니다. 자세한 내용은 Microsoft 365 테넌트 준비를 참조하세요.
- 유효한 Teams 앱 패키지입니다. 자세한 내용은 Microsoft Teams에서 앱 업로드를 참조하세요.
Azure에서 봇 구성
- Azure Portal을 엽니다.
- 봇에 대한 Azure Bot 리소스 블레이드를 엽니다.
- 채널을 열고 Microsoft Teams를 선택합니다.
- 봇 포함 코드 가져오기를 선택하고 Teams에 대한 embed 코드를 찾은 다음 코드의 https 부분을 복사합니다. 예들 들어
https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232입니다. 이 코드를 사용하여 Teams에서 봇을 테스트할 수 있습니다.
팁
- 통화 탭은 Teams 통화 기능을 지원합니다. 자세한 내용은 Microsoft Teams에 대한 전화 및 모임 봇 등록을 참조 하세요.
- 게시 탭에는 Teams 스토어에 Teams 앱을 게시하는 방법에 대한 정보가 포함되어 있습니다.
- 21Vianet에서 운영하는 Microsoft Azure는 봇 포함 코드 가져오기 기능을 지원하지 않습니다. Teams 채널을 테스트하려면 아래에 설명된 단계를 사용하여 Teams 앱을 만들고 배포합니다.
Teams에서 봇 테스트
프로덕션의 봇은 Teams 앱의 일부로 Teams에 추가되어야 합니다. 자세한 내용은 앱 테스트를 참조하세요.
Important
테스트 목적 이외의 다른 용도로 GUID로 봇을 추가하는 것은 권장되지 않습니다. 이렇게 하면 봇의 기능이 심각하게 제한됩니다. 프로덕션 환경의 봇은 앱의 일부로 Teams에 추가해야 합니다.
- 브라우저에서 embed code에서 복사한 URL을 연 다음 Teams에 봇을 추가하는 데 사용하는 Microsoft Teams 앱(클라이언트 또는 웹)을 선택합니다. Microsoft Teams에서 메시지를 보내고 받을 수 있는 연락처로 나열된 봇을 볼 수 있어야 합니다.
- Teams에서 봇과 상호 작용합니다.
팁
로컬 개발, 스테이징 및 프로덕션 환경 간에 전환할 때 엔드포인트가 변경되므로 환경당 하나의 봇 채널 등록을 사용합니다.
Teams 채널 등록을 삭제하면 다시 사용하도록 설정되면 새 키 쌍이 생성됩니다. 이렇게 하면 봇이 사전 메시징을 위해 저장했을 수 있는 29:xxx 및 a:xxx ID가 모두 무효화됩니다.
Teams에서 봇 게시
앱을 게시하는 방법에 대한 지침은 Microsoft Teams 앱을 배포하는 방법에 대한 Teams 개요를 참조하세요. 이 문서와 관련 문서에서는 다음 방법을 다룹니다.
- 봇에 대한 설치 옵션 선택 및 구성
- Teams 앱 매니페스트, 아이콘 및 패키지 만들기
- Teams에 앱 업로드
- 조직 또는 Teams 스토어에 앱 게시