채널 개요 및 연동
이 페이지에서는 외부 메시지 채널과 개인 계정 연동의 관계, 그리고 관리자가 앱 설정을 완료한 후 사용자가 자신의 채널 계정을 인증하고 연동하는 방법을 설명합니다.
대상 독자: 채널 설정 담당자와 외부 채팅 플랫폼 사용자.
검색 키워드: Channel binding, 채널 연결, 채널 연동, 봇.
1. 채널 연결로 해결할 수 있는 문제
채널 연결은 외부 채팅 플랫폼의 계정을 AE 계정과 연결합니다. 익숙한 채팅 도구에서 요청을 보내면 시스템이 사용자의 신원을 식별하고, 권한이 있는 워크스페이스에서 Agent를 사용할 수 있습니다.
- 외부 채팅 진입점에서 Agent 사용: 요청할 때마다 AE 페이지로 돌아올 필요가 없습니다.
- 업무에 맞는 실행 환경 선택: 일반 1:1 채팅에서 워크스페이스와 Agent를 선택하면 이후 메시지에도 현재 선택이 그대로 적용됩니다.
- 설정과 사용 책임 구분: 관리자는 채널 인스턴스의 연동과 활성화를 담당하고, 사용자는 자신의 계정 연동을 담당합니다. 계정을 연동해도 더 많은 리소스 권한이 자동으로 부여되지는 않습니다.
같은 플랫폼에 채널 인스턴스가 여러 개 있을 수 있습니다. 작업할 때는 플랫폼과 인스턴스 이름을 함께 확인해야 하며, Feishu나 Slack 같은 플랫폼 이름만으로 연동 대상을 판단해서는 안 됩니다.
2. 연동 전 준비 및 채널 인스턴스 선택
사전 조건: 관리자가 채널 관리에서 해당 플랫폼의 앱 메시지 채널을 설정해 두어야 합니다. 계정 연동은 외부 플랫폼에서의 신원을 연결하는 데 사용됩니다. 플랫폼 앱 설정과 개인 계정 연동은 별개의 두 단계입니다.
대상 채널이 활성화되어 있는지, 올바른 AE 계정으로 로그인했는지, 자신의 외부 플랫폼 계정을 사용할 수 있는지 확인합니다. 새로 연동하거나 연동을 복구하려면 사용 가능한 개인 기본 공간도 있어야 합니다. 연동 작업은 공간을 자동으로 생성하거나 복구하지 않습니다.
- AE의 사용자 메뉴를 열고 채널 연결로 들어갑니다.
- 사용할 플랫폼을 펼치고 관리자가 안내한 채널 인스턴스 이름을 찾습니다. 인스턴스가 많으면 목록의 검색 기능을 사용할 수 있습니다.
- 연동됨, 연동되지 않음, 비활성화 등의 상태를 확인한 후 대상 인스턴스에 대해 연동 또는 관리 작업을 실행합니다.
연동되지 않았으면서 비활성화된 인스턴스나, 사용 가능한 연동 방식이 아직 설정되지 않은 인스턴스는 목록에 표시되지 않을 수 있습니다. 이미 연동된 인스턴스는 비활성화되어도 계속 표시될 수 있습니다. 연동됨은 신원이 연결되었다는 뜻일 뿐, 채널이 현재 메시지를 받아 실행할 수 있다는 뜻은 아닙니다.
3. 계정 인증 또는 연동 코드 확인 완료
대상 인스턴스의 연동을 클릭하고, 실제로 표시되는 인증 창이나 연동 코드 대화 상자에 따라 작업을 완료합니다. 사용할 수 있는 방식은 플랫폼과 관리자 설정에 따라 다르며, 모든 채널에서 같은 인증 창이 표시되는 것은 아닙니다.
| 방식 | 완료 방법 | 사용 팁 |
|---|---|---|
| 계정 인증 | 열린 인증 창에서 외부 계정과 권한을 확인하고 인증한 뒤, AE로 돌아와 연동 상태를 확인합니다. | Feishu, Lark, Slack, Discord는 인증 절차를 사용합니다. 일부 다른 플랫폼도 설정 후 인증 방식을 제공할 수 있습니다. |
| 연동 코드 확인 | 대화 상자에 표시된 전체 연동 명령을 복사하여 해당 봇 또는 연동 계정과의 1:1 채팅에 보내고, 연동이 완료될 때까지 기다립니다. | 명령은 플랫폼마다 다릅니다. WeCom은 "중국어 연동 키워드 + 연동 코드", DingTalk, Mattermost, Google Chat, Zoom Team Chat, WhatsApp은 "+bind 연동 코드"를 사용합니다. 실제로 생성된 명령을 그대로 복사하십시오. |
| Google Chat 파일 인증 | 연동은 되었지만 네이티브 파일 전송을 아직 인증하지 않았다면 파일 인증을 클릭하여 인증을 완료합니다. 연동되지 않은 경우에는 연결 및 인증이 표시될 수 있습니다. | 관리자가 해당 인증 방식을 먼저 설정해야 합니다. 신원 연동과 네이티브 파일 전송 인증은 서로 다른 권한입니다. |
연동 코드는 본인의 외부 계정을 확인하는 용도로만 사용됩니다. 다른 사람에게 전달하거나 공개 그룹 채팅에 보내지 마십시오. 연동 코드가 만료되면 연동을 다시 시작하고 새 명령을 사용하십시오. 완료 후 채널 연결로 돌아가 대상 인스턴스에 연동됨이 표시되는지 확인합니다.
Google Chat 다중 인스턴스 주의 사항: 같은 회사에 Google Chat 인스턴스가 여러 개 있으면 현재 연동 코드 절차로는 메뉴에서 선택한 인스턴스에 연동된다고 보장할 수 없습니다. 설정된 계정 인증 방식을 우선 사용하십시오. 연동 코드만 사용할 수 있다면 먼저 관리자에게 대상 인스턴스를 확인받고, 연동 성공 메시지만으로 연동 대상을 판단하지 마십시오.
4. 1:1 채팅에서 워크스페이스와 Agent 선택
다음 명령은 일반 1:1 채팅에 적용됩니다. 공간 선택은 이후 요청이 어느 워크스페이스에서 실행될지를 결정하고, Agent 선택은 어떤 어시스턴트를 사용할지를 결정합니다. 선택 내용은 현재 채널 연동에 저장되어 이후 메시지에도 계속 적용되며, 다음 메시지 한 건에만 적용되는 것이 아닙니다.
Feishu, Lark, Discord, DingTalk, WeCom의 대화 명령 접두사는 "/"이고, Slack, Mattermost, Google Chat, Zoom Team Chat, WhatsApp은 "+"입니다. 연동 코드 명령은 연동 팝업에 표시된 것을 기준으로 하며, 여기의 대화 명령 접두사와 섞어 쓰지 않습니다.
| 하려는 작업 | "/" 접두사 채널 | "+" 접두사 채널 |
|---|---|---|
| 선택 가능한 워크스페이스 보기 | /space | +space |
| 이름으로 워크스페이스 선택 | /space 空间名称 | +space 空间名称 |
| 개인 기본 공간으로 복원 | /space default | +space default |
| 선택 가능한 Agent 보기 | /agent | +agent |
| 이름으로 Agent 선택 | /agent Agent名称 | +agent Agent名称 |
| 현재 공간의 기본 Agent로 복원 | /agent default | +agent default |
먼저 목록을 확인한 다음 전체 이름으로 선택합니다. 이름이 같아 하나로 특정할 수 없으면 먼저 이름을 구분해야 하며, 공간이나 Agent의 ID를 대신 사용하지 마십시오. 공간은 접근 가능한 개인 공간이나 현재 회사의 공유 공간이어야 하고, Agent도 표시되고 활성화되어 있어야 합니다. 실제로 실행하려면 현재 공간의 실행 권한도 필요합니다.
- 다른 공간으로 전환: 대상 공간에서 새 대화가 생성되고, 현재 연동에서 따로 선택한 Agent가 해제되어 대상 공간의 기본 Agent가 사용됩니다. 기존 대화는 새 공간으로 옮겨지지 않습니다.
- Agent 전환: 현재 연동의 Agent 선택이 업데이트되고 모델 실행 컨텍스트가 초기화됩니다. 기존 모델 컨텍스트가 그대로 이어진다고 가정하지 마십시오.
- 대기 중이거나 실행 중이거나 사용자 입력을 기다리는 중일 때: 공간이나 Agent를 전환할 수 없으므로 먼저 현재 실행을 완료하거나 종료해야 합니다.
- 그룹 채팅: 위의 일반 1:1 채팅용 공간 선택 규칙이 적용되지 않습니다. 개인 1:1 채팅에서 한 선택을 그룹 채팅 전체의 공통 설정으로 간주할 수 없습니다.
5. 연동 관리 및 권한 범위 이해
연동 해제 및 다시 연동
채널 연결에서 연동된 인스턴스를 찾아 연동 해제를 선택하고 확인 메시지를 확인합니다. 일반적으로 연동 해제는 선택한 인스턴스에 대한 본인의 신원 연결만 해제하며, 관리자가 설정한 채널 앱은 삭제하지 않습니다. 연동 해제에 실패하면 오류 메시지에 따라 조치한 후 다시 시도하십시오. 대화 상자를 닫았다고 해서 연동이 해제된 것으로 간주하지 마십시오.
Google Chat의 현재 제한 사항: 연동을 해제하면 선택한 인스턴스뿐 아니라 같은 회사에 있는 본인의 모든 Google Chat 연동이 해제되고, 해당 연동의 네이티브 파일 전송 인증도 삭제됩니다. 그중 하나의 인스턴스만 해제하려면 먼저 관리자에게 처리 방식을 확인하십시오.
연동을 해제한 후 다시 신원을 식별하려면 확인 절차를 다시 완료해야 합니다. 연동을 복구하면 개인 기본 공간이 다시 사용되고, 이전에 따로 선택한 Agent는 해제됩니다. 다른 공간이나 Agent가 필요하면 연동 후 다시 선택하십시오. 외부 계정이 이미 다른 AE 사용자에게 연동되어 있다는 메시지가 표시되면, 기존 연동을 먼저 처리한 후 다시 시도하십시오.
연동이 모든 권한을 얻는다는 뜻은 아님
- 채널 비활성화: 연동됨이 계속 표시되더라도 그것만으로 메시지를 실행할 수 있다고 판단할 수 없습니다. 관리자에게 활성화 상태를 확인받으십시오.
- 공간 접근 및 실행: 연동으로 공간 멤버, 회사 범위, 실행 권한을 우회할 수 없습니다. 공간이나 실행 환경을 사용할 수 없으면 먼저 접근 조건을 복구해야 합니다.
- Agent와 기능: Agent의 표시 여부, 활성화 상태, 그리고 워크스페이스 및 관련 기능의 권한 요구 사항도 충족해야 합니다. 연동한다고 해서 모든 도구나 지식 베이스가 자동으로 열리지는 않습니다.
6. 자주 묻는 질문 및 다음 단계
문제가 생겼을 때 먼저 확인할 사항
- 채널 인스턴스를 찾을 수 없음: 현재 회사, 인스턴스 이름, 관리자 설정을 확인합니다. 활성화되지 않았거나 사용 가능한 연동 방식이 없는 미연동 인스턴스는 표시되지 않을 수 있습니다.
- 인증 창이 열리지 않음: 브라우저가 팝업을 차단하고 있는지 확인하고, 허용한 후 다시 인증을 시작합니다. 창은 열렸지만 인증에 실패했다면 계정과 오류 메시지를 확인합니다.
- 연동 명령을 보냈는데 연동되지 않음: 올바른 봇 또는 연동 계정에 보냈는지, 명령이 완전하고 만료되지 않았는지 확인합니다. 만료되었으면 새로 받고, 이전 코드를 반복해서 보내지 마십시오.
- 연동됨으로 표시되지만 메시지가 실행되지 않음: 채널이 활성화되어 있는지, 현재 공간에 접근하고 실행할 수 있는지, 선택한 Agent를 사용할 수 있는지 순서대로 확인합니다. 연동 상태는 신원이 연결되었다는 것만 증명합니다.
- 기존 연동에 워크스페이스가 없다는 메시지가 표시됨: 먼저 개인 기본 공간과 그 실행 환경을 사용할 수 있는지 확인한 후, 연동을 해제하고 다시 연동합니다. Google Chat 사용자는 연동을 해제하기 전에 위의 다중 인스턴스 영향 범위를 먼저 읽어야 합니다.
- 공간이나 Agent를 전환할 수 없음: 먼저 현재 실행을 종료한 후 목록의 전체 이름으로 다시 시도합니다. 이름 중복, 권한 없음, 공간 비활성화, 실행 환경 오류는 모두 먼저 처리해야 합니다.
- Google Chat에서 채팅은 되지만 네이티브 첨부 파일을 보낼 수 없음: 파일 인증 진입점이 있는지 확인하고 인증을 완료합니다. 진입점이 없으면 관리자에게 인증 설정을 확인받으십시오.