채널 관리
읽기 안내
소속 목차: 채널 및 통합.
검색 키워드: Channel management, 채널 설정, 플랫폼 자격 증명, 메시지 권한, 이벤트 구독.
- 채널 연동과 개인 계정 연동의 관계를 알아보거나, 계정 연동, 1:1 채팅의 워크스페이스 및 Agent 선택을 완료하려면 채널 개요 및 연동을 읽으십시오.
- Feishu 설정: Feishu.
- Slack 설정: Slack.
- Lark 설정: Lark.
- DingTalk 설정: DingTalk.
- Discord 설정: Discord.
- WeCom 설정: WeCom.
- Mattermost 설정: Mattermost.
- WhatsApp 설정: WhatsApp 채널 사용 설명서.
- Google Chat 설정: Google Chat 봇 설정 및 사용 가이드.
- Zoom Team Chat 설정: Zoom Team Chat 설정 매뉴얼.
- Codex, Claude Code 등 Coding Agent에서 CLI로 Agentic Engine 사용: Coding Agent.
- 작업을 받는 Agent 관리: Agent.
구체적인 작업 방법은 아래를 참고하십시오.
이 문서에서는 Agentic Engine의 채널 연동 절차를 소개합니다. 이 문서를 통해 서드파티 채널과 Agent 서비스의 통합을 빠르게 완료하여 메시지 수신, 사용자 인터랙션, 채널 통신 기능을 연결할 수 있습니다.
채널 관리로 해결할 수 있는 문제: 팀을 위해 외부 채팅 진입점을 통합하여 연동하고 관리하며, 채널 인스턴스와 메시지 분배를 설정하여 업무 요청을 적합한 Agent 또는 Team에 전달할 수 있게 합니다. 관리자는 플랫폼 앱과 채널 설정을 담당하고, 사용자는 각자 자신의 외부 계정을 따로 연동합니다. 채널을 생성했다고 해서 모든 멤버의 연동이 완료된 것은 아닙니다.
대상 독자: 시스템 관리 권한이 있는 관리자이며, 관리 범위는 현재 회사입니다. 채널 진입점이 표시되지 않거나 기능이 활성화되지 않았다는 안내가 표시되면 먼저 시스템 관리자에게 권한, 샌드박스, 채널 기능이 활성화되어 있는지 확인을 요청하십시오.
채널은 Feishu/Lark 테넌트, Slack Workspace, Discord Server, DingTalk 기업, WeCom 기업 또는 Mattermost Site 단위로 그룹 채팅 메시지 분배를 설정할 수 있습니다. 관리자는 기본 Agent/Team을 설정하고, 호출 명령이나 키워드로 그룹 채팅 작업을 서로 다른 기능에 분배할 수 있습니다. 플랫폼별로 필요한 권한, 설정 단계, 사용자 명령은 위의 해당 하위 매뉴얼을 참고하십시오.
메시지 분배의 채팅 공간은 외부 플랫폼의 연동 범위를 가리키며, AE 워크스페이스가 아닙니다. 관리자의 그룹 채팅 분배 설정과 사용자가 일반 1:1 채팅에서 워크스페이스와 Agent를 선택하는 것은 서로 다른 설정이며, 서로 대체할 수 없습니다.
연동 필수 점검: 앱 자격 증명만 입력해서는 충분하지 않습니다. 해당 채널의 하위 문서에 따라 메시지 및 파일 권한, 그룹 채팅 이벤트 구독, 인터랙션 콜백, 버전 게시 또는 재설치를 완료하십시오. 그렇지 않으면 "1:1 채팅은 정상이지만 그룹 채팅에서는 호출되지 않음", "텍스트는 정상이지만 질문 폼, 이미지 또는 생성 파일이 실패함" 같은 문제가 발생할 수 있습니다.
인스턴스와 신원: 한 기업에서 여러 채널 인스턴스를 설정할 수 있지만, 같은 Bot 신원을 같은 실행 환경에 중복 설정할 수는 없습니다. 또한 같은 Bot을 여러 클러스터 환경에 동시에 연결하지 마십시오. 중복 소비, 중복 답변, 대화 표류가 발생하거나 취소 명령이 엉뚱한 작업에 적용될 수 있습니다.
시스템 관리에서 채널 설정
관리자는 시스템 관리 → 에이전트 관리 → 채널 관리에서 Feishu, Slack 등의 채널 인스턴스를 관리합니다. 플랫폼별 자격 증명, 권한, 콜백, 게시 단계는 위의 해당 플랫폼 매뉴얼에 따라 완료하십시오.
생성 및 확인
- 채널 생성을 클릭하고, 팀이 알아보기 쉬운 채널 이름을 입력한 뒤 채널 타입을 선택합니다. 같은 플랫폼에 인스턴스가 여러 개 있으면 서로 구분할 수 있는 이름을 사용해야 합니다. 채널 타입은 생성 후 변경할 수 없습니다.
- 선택한 플랫폼에 맞게 필요한 자격 증명을 입력하고 기본 모델을 설정한 뒤, 필요하면 채널 입력 추가 안내를 입력하고 저장합니다. 기본 모델은 회사 기본값이나 채널 사용자의 개인 기본값을 참조하거나, 목록의 사용 가능 모델 중에서 선택할 수 있습니다. 이 설정은 Agent를 선택하거나 그룹 채팅 분배를 설정하는 것이 아닙니다.
- 인스턴스가 활성화되어 있는지 확인하고, 플랫폼에 따라 자격 증명 확인 또는 연결을 완료합니다. 지원되는 인스턴스는 메시지 분배에 들어갈 때 먼저 확인 상태를 점검합니다. Zoom Team Chat은 자격 증명 확인을 사용할 수 있으며, WhatsApp은 저장하고 활성화한 후 관리자가 QR 코드를 스캔하여 공유 봇 계정을 연결해야 합니다.
- 설정이 완료되면 사용자에게 채널 개요 및 연동에 따라 개인 계정 연동을 완료하도록 한 뒤, 실제로 필요한 1:1 채팅, 그룹 채팅, 파일 인터랙션을 확인합니다. 자격 증명 확인에 성공했다고 해서 모든 권한, 이벤트 구독, 인터랙션 콜백이 올바르게 설정된 것은 아닙니다.
그룹 채팅 메시지 분배 설정
해당 인스턴스에서 메시지 분배를 열고 설정할 채팅 공간을 선택한 뒤, 그룹 채팅 분배 사용 여부와 기본 Agent/Team을 설정합니다. 그런 다음 필요에 따라 호출 명령이나 키워드로 선택할 수 있는 Agent/Team을 추가합니다. 새로 추가하는 대상마다 호출 명령을 입력해야 하며, 키워드는 선택 사항입니다. 저장하기 전에 화면에 표시되는 이름 중복, 형식, 개수 문제를 처리하십시오.
설정할 수 있는 채팅 공간이 표시되지 않으면 해당 플랫폼 매뉴얼에 따라 권한, 설치, 그룹 채팅 이벤트 설정을 확인한 뒤, 여기로 돌아와 점검하거나 다시 확인하십시오. 같은 Bot의 인스턴스를 중복 생성하는 방식으로 설정 문제를 우회하지 마십시오.
유지 관리 시 주의 사항
- 키를 편집할 때 비워두면 변경 없음이 표시된 필드는 다시 입력할 필요가 없습니다. 키가 다시 표시되지 않는다고 해서 설정이 유실된 것으로 오해하지 마십시오.
- 주요 자격 증명을 수정하면 기존 확인 결과와 그룹 채팅 분배 진입점이 무효화될 수 있습니다. 주요 설정 변경 확인이 표시되면 먼저 영향을 받는 사용자를 확인하십시오. 확인 후에는 해당 사용자가 다시 연동해야 하며, 자격 증명 확인과 그룹 채팅 분배 상태도 다시 점검해야 합니다.
- 비활성화하면 해당 인스턴스가 새 메시지를 받고 처리하는 것이 중지됩니다. 삭제하면 해당 인스턴스의 사용자 연동도 해제되고 그룹 채팅 분배 설정이 정리됩니다. 삭제 시 복구할 수 없다는 안내가 표시되므로 먼저 영향 범위를 확인하고, 삭제를 일반적인 비활성화처럼 사용하지 마십시오.
채널 관리
채널 생성(Feishu)
채널 생성(Slack)