기업용 카카오워크
home
카카오워크 사용자
home
🔖

봇 관리

Bot과 카카오 i 캐스퍼 관리

카카오워크 관리자 서비스 > 봇 관리 메뉴에서는 업무에 활용할 Bot을 개발하고, 카카오 i 캐스퍼 지식 검색 서비스의 데이터를 등록 및 관리할 수 있습니다.
Bot(봇)이란 특정 작업을 자동으로 수행하도록 프로그래밍된 응용 프로그램입니다. 카카오워크에서는 업무에 필요한 서비스를 연결한 Bot을 개발 및 관리하는 기능을 제공합니다. 워크스페이스 멤버들은 Bot을 통해 관련 알림을 채팅방 메시지로 빠르게 확인할 수 있습니다. 봇 관리 > 워크스페이스 봇 관리, Bot 개발자 관리, Bot 개발 메뉴에서는 Bot 관리자를 지정하거나 Bot을 생성 및 관리할 수 있고, API 가이드 Block Kit Builder를 Bot 개발에 활용할 수 있습니다.
카카오 i 캐스퍼 지식 검색 서비스는 카카오워크 채팅방 내 AI 어시스턴트인 카카오 i 캐스퍼를 활용한 사내 지식 정보 서비스입니다. 카카오 i 캐스퍼 지식 검색 서비스를 제공하기 위해서는 사내 지식 데이터를 직접 등록해야 합니다. 봇 관리 > QnA 데이터 관리 메뉴에서 서비스에 활용할 사내 지식 데이터를 등록 및 관리할 수 있습니다.
구분
설명
봇 관리 ▼
워크스페이스에서 사용 중인 Bot 내역 및 활성화 여부 설정
워크스페이스용 Bot을 생성할 수 있는 개발자 관리
워크스페이스 내부 Bot 개발 및 관리
워크스페이스에서 Bot과 멤버가 대화를 하기 위해 필요한 정보를 조회하거나 정보를 적용하는데 필요한 Web API의 사용법 및 정보 제공 - [카카오 i 기술문서] Web API 레퍼런스 가이드 참고
카카오워크에서 제공하는 UI 프레임워크인 Block Kit을 활용하여 커스텀 Bot 화면을 자유롭게 구성할 수 있도록 도와주는 Builder 사이트 - [Builder 사이트] Block Kit Builder 바로가기 - [카카오 i 기술문서] Block Kit Builder 상세 가이드 참고
카카오 i 캐스퍼 지식 검색에서 활용할 서비스 데이터 등록 및 관리

Bot(봇) 관리하기

카카오워크 관리자 서비스 > 봇 관리 메뉴에서는 기존 Bot을 관리하고 신규 Bot(ex. 일정 관리 Bot, 근태 관리 Bot 등)을 개발할 수 있습니다. 또한 AI 어시스턴트 카카오 i 캐스퍼를 활용한 사내 지식 정보 검색 서비스를 만들 수 있습니다.
업무에 필요한 협업 서비스 및 사내 시스템을 카카오워크 Bot으로 연결하고 중요한 알림을 빠르게 확인할 수 있습니다.

워크스페이스 봇 관리하기

카카오워크 관리자 서비스 > 봇 관리 > 워크스페이스 봇 관리 메뉴에서 워크스페이스에서 사용 중인 Bot 내역과 활성화 여부를 설정할 수 있습니다.
그림. 워크스페이스 봇 관리
구분
설명
① 사용 중인 기본 Bot
워크스페이스 기본 Bot 중 활성화된 Bot - 활성화된 Bot만 사용 개수에 포함
② 등록된 개발자 생성 Bot
워크스페이스 개발자가 직접 개발한 Bot - 개발자가 직접 등록한 Bot이 사용 개수에 포함

Bot 개발자 관리하기

카카오워크 관리자 서비스 > 봇 관리 > Bot 개발자 관리 메뉴에서는 워크스페이스용 Bot을 생성할 수 있는 개발자를 추가하고 관리할 수 있습니다.
그림. Bot 개발자 관리
구분
설명
① 개발자 추가 등록
클릭 시 워크스페이스용 Bot을 생성할 수 있는 개발자 추가 등록 가능
② Bot 개발자 리스트 ▼
현재 등록된 개발자 목록
개발자
Bot을 개발할 개발자
등록자
Bot 개발자를 지정한 관리자
등록일
해당 Bot 개발자를 등록한 날짜
권한 해제
멤버의 개발자 권한을 해제 - 사전에 Bot 개발자로 등록되어 있을 경우, 권한을 해제할 수 없으며 Bot 개발 메뉴에서 해당 Bot을 삭제 후 가능

개발자 등록하기

개발자를 신규 등록하는 방법은 다음과 같습니다.
1.
봇 관리 > Bot 개발자 관리 화면으로 이동하여 [개발자 추가 등록] 버튼을 클릭합니다.
그림. 개발자 추가 등록
2.
개발자로 등록할 멤버 이름 검색 후, [추가] 버튼을 클릭합니다.
그림. 개발자 등록 팝업창
안내 관리자 권한이 없는 사용자가 개발자로 지정될 경우, 카카오워크 관리자 서비스봇 관리 메뉴에만 접근할 수 있습니다.

권한 해제하기

봇 관리 > Bot 개발자 관리에서 [권한 해제] 버튼을 클릭하여 개발자 권한을 해제할 수 있습니다.
그림. 개발자 권한 해제

Bot 개발하기

카카오워크 관리자 서비스 > 봇 관리 > Bot 개발 메뉴에서는 워크스페이스의 커스텀 Bot을 생성하고 관리할 수 있습니다. Bot 개발은 개발자 권한으로 지정된 멤버만 개발할 수 있습니다.
관리자도 Bot 개발을 하기 위해서는 먼저 개발자 등록을 완료해야 합니다.
안내 Bot 개발 서비스는 현재(22년 11월 기준) Beta 버전으로 제공됩니다.
그림. Bot 개발 화면
구분
설명
① Bot 생성하기
커스텀 Bot 생성
② Bot 리스트 ▼
현재 등록된 Bot의 리스트 - 카카오워크 앱에 Bot 노출 여부 설정은 관리자만 설정 가능
Bot 아이콘
Bot 아이콘 이미지
이름
Bot 이름
개발자
Bot을 개발한 개발자
등록일
Bot 최초 등록일
수정일
Bot 최신 수정 날짜
Bot 목록 노출
슬라이드 버튼을 ON/OFF 하여 멤버의 카카오워크 앱에 Bot 노출 여부를 설정 - 관리자만 설정 가능
관리
Bot을 수정 및 삭제 - [수정] 아이콘: Bot 정보 및 기능 수정 - [삭제] 아이콘: Bot 삭제

Bot 생성하기

신규 Bot을 생성하는 방법은 다음과 같습니다.
1.
봇 관리 > Bot 개발 화면에서 [Bot 생성하기] 버튼을 클릭합니다.
그림. Bot 생성
2.
Bot 정보를 입력한 후, [생성] 버튼을 클릭합니다.
그림. Bot 정보 입력 팝업창
구분
필수 여부
설명
이름
필수
Bot의 이름
한 줄 설명
필수
Bot 목록에 표시할 문구
문의
필수
Bot 담당자 정보(아이디, 메일 등)

Bot 수정하기

Bot의 정보를 수정하는 방법은 다음과 같습니다.
1.
봇 관리 > Bot 개발자 관리 메뉴에서 [수정] 아이콘을 클릭합니다.
그림. 생성된 Bot 수정
2.
제작된 Bot의 기본 정보와 권한 등을 설정합니다.
a.
Bot 기본 정보 탭에서 정보 수정 후 [저장] 버튼을 클릭합니다.
App Key는 Bot 생성 시 자동으로 부여되며, Bot 인증 시 Request 파라미터에 입력하는 값입니다.
그림. Bot 기본 정보 수정
구분
필수 여부
설명
Bot 기본 정보 탭 ▼
Bot의 권한과 기능을 수정할 수 있는 탭
제작사
필수
Bot 제작사 - 제작사는 해당 워크스페이스명으로 고정
아이콘
선택
Bot의 아이콘 이미지
이름
필수
Bot의 이름
한 줄 설명
필수
Bot 목록에 표시할 문구
소개
선택
Bot의 역할 또는 알림 상황 설명 문구
App Key
필수
Bot 생성 시 자동으로 부여되는 값 - Bot 인증 시 Request 파라미터에 App Key를 이용하여 인증 요청
문의
필수
Bot 담당자 정보 - 아이디, 메일 등
b.
Bot 권한 및 기능 탭에서 정보 수정 후 [저장] 버튼을 클릭합니다.
그림. Bot 권한 및 기능 설정
구분
필수 여부
설명
Bot 권한 및 기능 탭 ▼
Bot의 권한과 기능을 수정할 수 있는 탭
Bot 권한 선택 ▼
선택
Bot 제작에 필요한 API 권한 선택 가능 - 자세한 설명은 Web API 가이드 참고
멤버 조회
선택
사용자 정보를 다루는 멤버 조회 API
채팅방 조회
선택
채팅방을 조회하는 채팅방 조회 API
메시지 발송
선택
메시지를 다루는 메시지 발송 API
부서, 조직도 조회
선택
특정 워크스페이스에 속한 부서 정보를 조회하는 부서, 조직도 조회 API
채팅방 개설
선택
채팅방을 개설하는 채팅방 개설 API
URL 등록 ▼
선택
Bot이 동작하는데 필요한 URL 등록 가능 - URL 등록 후 교육용 카카오워크 담당자가 해당 정보 확인 후 등록 완료 메일 발신 - Request URL과 Callback URL의 활용 시점에 관한 부분은 Bot 시작 가이드의 반응형 시나리오 참고
Request URL
선택
메시지의 Button(Button Block, Action Block) 블록을 눌렀을 때, 모달 블록 구성을 호출할 수 있는 URL
Callback URL
선택
Request URL에서 받은 모달 화면에서 사용자가 입력하거나 선택한 정보를 POST 요청으로 보내기 위한 URL
안내 자세한 Bot 개발 방법은 [카카오 i 기술문서] Bot 개발 가이드[카카오 i 기술문서] Web API 레퍼런스 문서를 참고하시기 바랍니다.

카카오 i 캐스퍼 지식 검색

카카오워크의 모든 채팅방에는 AI 어시스턴트 카카오 i 캐스퍼가 탑재되어 있습니다. 카카오 i 캐스퍼는 사용자의 질문에 답변을 제공하는 서비스로 기본적으로는 어학, 백과, 뉴스 등에 대한 정보 제공과 조 편성, 일정 관리 등 업무를 돕는 기능을 수행합니다.
카카오 i 캐스퍼 지식 검색이란 카카오 i 캐스퍼를 활용한 카카오워크만의 차별화된 사내 정보 검색 서비스입니다. 질의 문장에 내부 검색에서(으로), 지식 검색에서(으로), 내부 검색해줘, 지식 검색해줘 라는 문구를 포함하여 작성 시, 사내 복지 제도, 인사 제도, 용어 사전 등 우리 회사만의 지식 정보에 대한 답변을 제공합니다.
카카오 i 캐스퍼 지식 검색 서비스를 제공하기 위해서는 관리자가 질문과 답변 데이터를 직접 등록해야 합니다. 카카오 i 캐스퍼 데이터는 Bot 관리 권한이 있는 관리자가 카카오워크 관리자 서비스 > 봇 관리 > QnA데이터 관리 메뉴에서 등록합니다.
그림. 지식 검색 서비스 예시
안내 카카오 i 캐스퍼 지식 검색 서비스는 STANDARD 요금제 이상부터 제공됩니다. 현재 용량 제한없이 데이터를 등록할 수 있으나, 추후 요금제에 따라 기능 및 용량에 제한이 발생할 수 있습니다.

QnA 데이터 관리자 서비스

카카오 i 캐스퍼 지식 검색에 활용할 데이터는 QnA 데이터 관리자 서비스에서 등록합니다. QnA 데이터 관리자 서비스 접속 방법과 구성은 다음과 같습니다.
QnA 데이터 관리자 서비스 접속하기
QnA 데이터 관리자 사이트는 카카오워크 관리자 서비스의 봇 관리 메뉴에서 접속할 수 있습니다.
그림. QnA 데이터 관리자 서비스 접속
구분
접속 방법
카카오워크 관리자 서비스
봇 관리 > QnA 데이터 관리 클릭
QnA 데이터 관리자 서비스 화면 구성
그림. QnA 데이터 관리자 서비스 화면 구성
구분
설명
① 서비스 데이터 삭제
등록된 서비스 및 데이터 삭제
② 서비스 리스트
현재 관리 중인 QnA 서비스의 리스트
서비스 상태
서비스 상태 정보 - 데이터 업로드 필요: 데이터가 등록되기 이전의 상태로, 신규 데이터 업로드 가능 - 서비스 반영 에러: 데이터 등록 과정 중 에러가 발생한 상태로, 데이터 삭제 후 재등록 필요 - 서비스 반영 중: 데이터 등록 후 서비스에 반영 중인 상태 - 서비스 반영 완료: 서비스에 데이터 등록이 완료된 상태
서비스 카테고리
현재 카카오워크에서 제공하는 서비스 정보 - QnA 데이터: 질문(Question)과 답변(Answer)값으로 이루어진 데이터셋 - 용어 사전: 용어명(Keyword)과 용어 설명(Description)으로 이루어진 데이터셋
데이터 등록일
최초로 서비스가 생성되고 데이터가 등록된 일자
최종 수정일
데이터를 마지막으로 수정한 일자
파일 다운로드
현재 서비스에 저장되어 있는 데이터 파일 다운로드
서비스 사용여부
슬라이드 버튼을 ON/OFF 하여 서비스 사용 여부 설정 - 카카오 i 캐스퍼에 해당 서비스가 노출되지 않도록 조정 가능
데이터 등록
서비스에 활용할 데이터 업로드

데이터 등록하기

카카오 i 캐스퍼 지식 검색 서비스를 사용하기 위해서는 질문과 답변에 활용될 데이터를 직접 등록해야 합니다. 등록된 데이터는 카카오워크 내에 암호화되어 안전하게 보관됩니다. 새로운 데이터를 등록하는 방법은 다음과 같습니다.
1.
서비스 관리에서 생성하고자하는 서비스 카테고리의 데이터 업로드를 클릭합니다.
QnA 데이터: 질문(Question)과 답변(Answer)값으로 이루어진 데이터셋
용어 사전: 용어명(Keyword)과 용어 설명(Description)으로 이루어진 데이터셋
그림. 데이터 업로드
구분
설명
서비스 상태
서비스 상태 정보
데이터 업로드 필요
데이터가 등록되기 이전의 상태로, 신규 데이터 업로드 가능
서비스 반영 에러
데이터 등록 과정 중 에러가 발생한 상태로, 데이터 삭제 후 재등록 필요
서비스 반영 중
데이터 등록 후 서비스에 반영 중인 상태
서비스 반영 완료
서비스에 데이터 등록이 완료된 상태
2.
데이터 등록 팝업창에서 입력 양식 다운로드를 클릭하여 데이터셋을 입력하기 위한 양식 파일을 다운로드합니다.
그림. 양식 파일 다운로드
3.
데이터 등록 팝업창 하단에 표기된 데이터셋 작성 가이드를 참고하여, 양식에 맞게 데이터셋을 작성합니다.
4.
[파일 업로드] 버튼을 클릭해 작성 완료된 CSV 파일을 등록합니다.
주의 반드시 UTF-8 타입의 CSV 형식의 파일만 업로드합니다.
UTF-8 타입 외의 CSV 파일이거나 UTF-8 타입을 지원하지 않는 소프트웨어로 파일을 수정하는 경우, 한글 깨짐 현상이 발생하여 데이터 반영에 문제가 발생할 수 있습니다.
그림. 파일 업로드
5.
[등록] 버튼을 클릭합니다.
최초 데이터 등록 시 서비스 반영까지 최대 30분의 시간이 소요됩니다.
데이터 업로드가 정상적으로 진행되면, 해당 서비스 상태가 서비스 반영 중서비스 반영 완료로 변경됩니다.
그림. 데이터 등록

데이터 업데이트하기

기존에 등록된 서비스 데이터를 업데이트하는 방법은 다음과 같습니다.
주의
데이터가 등록되어 있는 상태에서 새로운 데이터를 등록하면, 덮어쓰기 방식으로 서비스에 반영됩니다. 이전에 등록된 데이터셋은 유지되지 않으니 주의하시기 바랍니다.
1.
서비스 관리에서 수정하고자 하는 서비스 카테고리의 [파일 다운로드] 버튼을 클릭해 현재 등록되어 있는 데이터셋을 다운로드합니다.
그림. 파일 다운로드
2.
다운로드한 파일을 수정 및 저장합니다.
3.
서비스 관리에서 업데이트 하고자하는 서비스 카테고리의 데이터 업로드를 클릭합니다.
그림. 데이터 업로드
4.
데이터 등록 팝업창에서 [파일 업로드] 버튼을 클릭하여 수정한 CSV 파일을 업로드합니다.
그림. 파일 업로드

데이터 삭제하기

등록된 서비스 데이터를 삭제하는 방법은 다음과 같습니다. 서비스 관리에서 삭제할 서비스에 체크하고 [서비스 데이터 삭제] 버튼을 클릭합니다.
데이터 삭제가 완료되면, 데이터 업로드 필요 상태로 변경됩니다.
그림. 데이터 삭제
주의
서비스 데이터가 삭제되면 사용자는 해당 지식 검색 서비스를 이용할 수 없습니다.
서비스 데이터 삭제는 즉시 서비스에 반영되지 않을 수 있습니다. 서비스 사용 여부 토글을 비활성화하여 실서비스에서 해당 데이터를 사용하지 않도록 설정한 뒤 데이터를 삭제하는 것을 권장합니다.
목차
관련 문서
 워크스페이스 개설  워크스페이스 환경 설정  워크스페이스 멤버 관리  워크 서비스 관리  워크보드 관리  바로가기 관리  게시판  봇 관리  보안 결제  통계  더보기  메시지 암호화 설정 인증키  기기 인증  부록 A. 카카오워크 관리자 서비스
Kakao i 서비스 이용약관 | 개인정보처리방침 Copyright Kakao Enterprise Corp. All Rights Reserved.