Teams 채널 연동

STORM을 Microsoft Teams에서 챗봇으로 쓰기 위한 설정 방법입니다. 아래 순서대로 정보를 입력하고, 생성된 앱 패키지(zip) 를 Teams에 업로드하면 됩니다.

채널 추가하기 버튼을 클릭해 새 채널을 생성합니다.

채널 유형 중 Teams를 선택합니다.

이후 Teams 연동에 필요한 정보(채널 이름, 폴더 지정, 연동 설정 등)를 순서대로 입력하여 설정을 완료합니다.

채널 이름

Teams와 연동할 채널의 이름을 입력합니다. 채널 이름은 STORM 내에서 해당 Teams 연결을 구분하기 위한 식별자 역할을 합니다.

폴더 지정

Teams 채널이 참조할 지식 문서의 범위를 지정합니다. 지정된 폴더 내의 문서만 검색하여 STORM이 응답을 생성하게 되며, 폴더를 지정하지 않으면 전체 문서를 대상으로 검색이 이루어집니다.

💡 활용 예시

팀별 또는 목적별로 AI의 답변 컨텍스트를 분리할 수 있으며, 조직 내 지식이 혼재되지 않도록 관리할 수 있습니다.

영업팀_Teams → 영업 관련 매뉴얼, 가격 정책 폴더만 지정

고객지원_Teams → FAQ, 고객응대 매뉴얼 폴더만 지정

R&D_Project_Teams → 기술 문서, API 명세 폴더만 지정

1️⃣ 앱 적용 범위

Teams 내에서 STORM 앱이 동작할 범위를 지정합니다. 조직(테넌트) 또는 특정 팀 및 채널 단위 중 하나를 선택할 수 있습니다.

조직(테넌트)
조직 전체에서 앱을 사용할 수 있습니다. 모든 팀과 개인 채팅에서 접근 가능하며, 같은 테넌트 내 모든 사용자가 앱을 호출할 수 있습니다.

팀 링크는 테넌트 식별용으로만 입력되며, 여기서 tenantId가 추출됩니다.

팀 및 채널
지정한 팀 내에서만 앱을 사용할 수 있습니다. 팀에 속한 모든 채널이 해당 앱을 공유하며, 필요한 경우 여러 팀을 개별적으로 등록할 수 있습니다.

팀 링크에서는 groupId를 추출해 특정 팀과 연결합니다.

2️⃣ 팀 링크

Teams와의 연결을 위해 반드시 팀 링크를 입력해야 합니다. 입력된 링크를 통해 STORM이 연동에 필요한 식별자(tenantId, groupId)를 자동으로 추출합니다.

입력 방법

Teams에서 연결하려는 팀의 이름 오른쪽의 ‘옵션 더 보기(···)’ 아이콘을 클릭합니다.

‘링크 복사(Get link to team)’ 를 선택합니다.

복사한 링크를 STORM의 입력창에 붙여넣습니다.

3️⃣ Teams 앱 이름

Teams에서 STORM 에이전트를 호출할 때 사용할 앱의 이름을 입력합니다. 사용자는 Teams 채팅에서 @앱이름 형식으로 봇을 호출해 대화할 수 있습니다.

앱 이름은 Teams 내에서 고유해야 하며, 20자 이내로 설정합니다.

이름은 실제 봇의 표시명으로 노출되므로 간결하고 직관적이게 지정하는 것을 권장합니다.

4️⃣ Bot 인증 정보

Teams 봇을 등록하고 STORM과 연결하기 위한 인증 정보를 입력합니다. 필요한 인증정보로는 Bot Id와 Client secret이며 Teams Developer Portal에서 발급됩니다.

Teams Developer Portal에 접속합니다.

💡

우측 상단에 New Developer Portal 토글 버튼을 활성화해야 합니다.

Tools탭에서 Bot management에 들어갑니다.

새로운 봇을 생성하고 Endpoint address에 https://live-stargate.sionic.im/bot/msteams/messages를 입력합니다.

💡

Bot id는 Bot 목록에서 복사할 수 있습니다.

Client secrets을 발급받은 후 복사합니다.

Bot id와 Client secret 을 복사한 후 STORM Bot 인증 정보에 각각 붙여 넣습니다.

앱 패키지(zip) 생성 및 업로드

모든 정보를 입력하면 Teams 연동용 앱 패키지(zip) 파일을 생성합니다. 패키지 파일 다운로드를 진행합니다.

업로드 방법

Teams 관리자 계정으로 로그인합니다.

앱 → 앱 관리 → 앱 업로드 메뉴로 이동합니다.

STORM에서 다운로드한 zip 파일을 앱 카탈로그에 앱 업로드 방식으로 업로드합니다.

⚠️ 중요:
입력한 정보(적용 범위, Bot ID, Secret 등)를 변경한 경우, 반드시 zip을 새로 생성하여 Teams에 재업로드해야 합니다.
Teams에 앱을 업로드한 후 약 1시간 정도의 반영 시간이 필요합니다. 반영이 완료되면 Teams 내 앱 목록과 채팅에서 정상적으로 사용할 수 있습니다.

✅ Teams에서 앱 활성화 및 사용하기

Teams 관리자 계정에서 앱 업로드가 완료되면, 이제 Teams 내에서 STORM 앱을 활성화할 수 있습니다.

Teams 좌측 메뉴에서 앱(Apps) 으로 이동합니다.

앱 목록에서 STORM에서 생성한 앱을 선택하고, 추가(Add) 버튼을 클릭합니다.

추가가 완료되면 앱이 조직 내 또는 지정한 팀(채널)에 활성화됩니다.

이제 Teams의 채팅창에서 자유롭게 STORM 에이전트를 사용할 수 있습니다. 사용자는 @앱이름 형식으로 봇을 호출하여 질문하거나 대화를 시작할 수 있습니다.

Teams 채널 연동