> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EKB 챗봇을 MS Teams에 통합

> EKB를 MS Teams로 가져오세요

EKB를 Microsoft Teams와 통합하면 지능적이고 컨텍스트를 인식하는 채팅이 팀의 협업 환경에 직접 제공됩니다. 이 가이드는 Microsoft Teams에서 EKB 챗봇을 설정하는 단계를 안내하여 Teams 인터페이스를 떠나지 않고 AI 에이전트와 원활한 통신이 가능하도록 합니다.

## 전제 조건

* 봇을 만들기 위한 Azure 관리자 접근 권한
* Teams 개발자 포털에 대한 관리자 접근 권한

## 설정 단계

### 1. Azure 봇 만들기

1. [Azure 대시보드](https://portal.azure.com/)로 이동합니다.
2. **리소스 만들기**를 클릭합니다.
3. 검색창에 `Bot`을 입력하고 **Azure Bot**을 선택합니다.
4. 새 Azure 봇을 만들고 원하는 **표시 이름**을 설정합니다.

### 2. 봇 구성

5. **구성** 탭으로 이동하여 **메시징 엔드포인트**를 서버 URL을 가리키도록 업데이트합니다.<br /><Note>**클라우드** 고객은 `https://api.getodin.ai/teams/events`를 입력하세요<br />**온프레미스** 고객은 `<your backend root URL>/teams/events`를 입력하세요</Note><br /><img src="https://mintcdn.com/automationanywhere/0A86gG9MnAmDoR6M/img/public-chatbot/teams-messaging-endpoint.png?fit=max&auto=format&n=0A86gG9MnAmDoR6M&q=85&s=f508eb9f5fa656b5d169122e47e86911" alt="메시징 엔드포인트 구성" width="954" height="652" data-path="img/public-chatbot/teams-messaging-endpoint.png" />
6. **구성** 탭에서 **App ID**와 **Tenant ID**를 복사한 다음 **비밀번호 관리**로 이동합니다.
7. 봇에 대한 새 비밀번호를 만들고 나중에 사용할 수 있도록 저장합니다.
8. Azure에서 봇의 **스트리밍 엔드포인트**를 활성화하고 해당 엔드포인트의 URL을 가리키도록 설정합니다.

### 3. Teams 채널 활성화

9. Azure 포털 왼쪽에서 **채널**을 클릭하고 봇에 대한 **Teams** 상호작용 채널을 활성화합니다.

### 4. EKB에 봇 등록

<Note>클라우드 고객은 `App ID`, `Tenant ID` 및 `App Password`를 AA 지원팀에 제공하여 봇이 등록되도록 지원 티켓을 열어주세요.</Note>

10. EKB에서 **슈퍼 관리자** 페이지로 이동하고 왼쪽에서 **Teams 봇**을 선택합니다.
11. **봇 등록**을 클릭합니다.
12. 6\~7단계에서 수집한 **App ID**, **Tenant ID**, **비밀번호**를 입력합니다. **봇 등록**을 클릭합니다.

### 5. Teams 개발자 포털에서 앱 만들기

13. [Teams 개발자 포털](https://dev.teams.microsoft.com/apps)로 이동합니다.
14. **새 앱**을 클릭합니다.
15. 앱 정보를 입력합니다:
    * **짧은 설명** — 필수, 비워둘 수 없음.
    * **긴 설명** — 필수, 비워둘 수 없음.
16. Azure의 봇 App ID로 **App ID** 필드를 채웁니다.

### 6. 봇 기능 구성

17. **앱 기능**으로 이동하여 봇을 추가하고 Azure의 **App ID**를 제공합니다.
18. 봇 기능을 다음과 같이 구성합니다:<br />
    <img src="https://mintcdn.com/automationanywhere/0A86gG9MnAmDoR6M/img/public-chatbot/teams-bot-capabilities.png?fit=max&auto=format&n=0A86gG9MnAmDoR6M&q=85&s=2c9a3640a96d0245447588ab1d1e3484" alt="Teams 봇 기능" width="395" height="422" data-path="img/public-chatbot/teams-bot-capabilities.png" />

### 7. 배포

19. 새로운 Teams 앱을 배포하는 조직의 표준 정책에 따라 패키지를 배포합니다.
20. 봇의 프로젝트 접근을 구성하려면 첫 번째 메시지로 `!setup` 명령어를 보냅니다.

***

## 권장 배포 방법

<Steps>
  <Step title="조직에 게시">
    Microsoft Teams 개발자 대시보드의 앱 페이지에서 왼쪽 사이드바 하단까지 스크롤합니다. **게시** 아래에서 **조직에 게시**를 선택합니다.<br /><img src="https://mintcdn.com/automationanywhere/0A86gG9MnAmDoR6M/img/public-chatbot/teams-publish-to-org.png?fit=max&auto=format&n=0A86gG9MnAmDoR6M&q=85&s=f1947b97a1d465923b5b7b8b10ba2328" alt="조직에 게시" width="379" height="187" data-path="img/public-chatbot/teams-publish-to-org.png" />
  </Step>

  <Step title="관리자 동의 부여">
    앱이 Teams 인스턴스에 게시되며 관리자 동의가 필요할 수 있습니다. 동의는 [Microsoft Teams 관리 센터](https://admin.teams.microsoft.com/dashboard)에서 부여할 수 있습니다.
  </Step>

  <Step title="전파 대기">
    동의가 부여된 후 봇이 사용 가능해질 때까지 권한이 전파되는 데 몇 시간이 걸립니다. 이 지연은 단일 조직으로 제한되더라도 Microsoft의 사용자 지정 애플리케이션 내부 검토 프로세스로 인해 발생합니다.
  </Step>
</Steps>

***

## Teams 봇 설정 세분화

초기 설정을 완료한 후 `!setup` 명령어를 봇에 보내 Microsoft Teams에서 응답을 받기 시작합니다.

### 기본 동작

기본적으로 봇 설정은 **봇당, Teams 인스턴스당** 세분화를 갖습니다. 봇에 구성된 프로젝트, API 키 및 시크릿은 모든 채널, 그룹 및 다이렉트 메시지를 포함한 전체 Teams 인스턴스에 적용됩니다.

### 채널별 설정(온프레미스 전용)

더 큰 세분화가 필요한 경우 — 예를 들어 채널, 그룹 또는 사용자에 따라 여러 프로젝트와 함께 하나의 봇을 사용하는 경우 — 다음 백엔드 환경 변수를 설정합니다:

```env theme={null}
TEAMS_USE_PER_CHANNEL_SETTINGS=TRUE
```

<Note>
  이 설정은 **온프레미스 고객**에게만 사용할 수 있습니다. 클라우드 호스팅 배포에서는 지원되지 않습니다.
</Note>

### 에이전트 선택

모든 구성에서 Teams Bot은 프로젝트의 **현재 설정된 기본 에이전트**와 상호작용합니다. 현재 다른 에이전트를 선택하는 옵션은 없습니다.