봇 개요

봇은 NAVER WORKS의 메시지방에서 사용할 수 있는 메시지 봇 기능이다.
봇은 다양한 시스템과 연계하여 사용할 수 있다.

봇의 작동 방식 {#how-bot-works}

봇을 사용하면 NAVER WORKS 사용자와 직접 상호 작용할 수 있다. 고객사의 메시지 수신 서버에서 Bot API를 사용해 사용자에게 메시지를 보낼 수 있으며, 사용자가 전송한 메시지에 따라 자동으로 응답할 수 있다.

bot_arch

NAVER WORKS는 봇의 인터페이스 제공하며 이를 통해 고객사의 메시지 수신 서버와 데이터를 주고받을 수 있다.

메시지 보내기 {#send-message}

봇은 'Bot API'를 사용해 메시지를 보낸다.
사용자가 보낸 메시지에 대한 응답과 봇이 먼저 전송한 메시지는 구별되지 않으며 모두 동일한 '메시지 보내기'로 처리된다.
메시지방의 구성원이 500명 이상인 경우 메시지를 보낼 수는 있지만 푸시 알림은 작동하지 않는다.

자세한 내용은 Bot API 개요를 참고한다.

메시지 수신 {#receive-message}

사용자가 보낸 메시지는 고객사의 메시지 수신 서버로 전송된다.
봇 생성 시 고객사의 메시지 수신 서버 URL(HTTPS)을 Callback URL로 설정한다. 보낸 메시지 유형에 따라 JSON 형식의 Callback Event가 URL로 전송된다.
메시지를 수신하는 Callback URL은 봇 당 하나만 등록할 수 있다.

자세한 내용은 Callback(메시지 수신)을 참고한다.

봇으로 할 수 있는 것 {#features}

사용자와 상호 작용 {#feature-talk-room}

여러 사용자와 상호 작용할 수 있도록 1:1 메시지방뿐만 아니라 1:N 메시지방에 참여할 수 있는 봇을 지원한다. 단, 외부 사용자(LINE 또는 외부 NAVER WORKS 사용자)를 포함한 메시지방에서는 봇을 사용할 수 없다.

봇은 사용자로부터 다음과 같은 다양한 메시지를 받을 수 있다.

텍스트
스티커
사진
파일
위치 공유
오디오
비디오

다양한 유형의 메시지 전송 {#feature-message}

봇으로 텍스트나 스티커, 파일 등 다양한 메시지를 보낼 수 있다.

봇으로 전송할 수 있는 메시지 유형은 다음과 같다.

Text
Sticker
Image
File
Link
Audio
Video
Location
Button Template
List Template
Carousel Template
Image Carousel Template
Flexible Template

자세한 내용은 메시지 유형를 참고한다.

메시지는 Bot API를 사용해 전송한다. 자세한 내용은 Bot API 개요를 참고한다.

메뉴 기능 {#feature-menu}

봇과의 대화 시 사용할 수 있는 메뉴 기능이다. 메시지 입력창에 표시되며 다양한 동작을 제공한다.

고정 메뉴(Persistent Menu)
리치 메뉴(Rich Menu)

자세한 내용은 메뉴를 참고한다.

다양한 액션 {#feature-action}

사용자가 메시지의 버튼이나 이미지를 눌렀을 때 봇의 동작을 다양하게 지정할 수 있다.

Postback Action
Message Acrion
URI Action
Camera Action
Camera Roll Action
Location Action
Copy Action

자세한 내용은 Action Objects를 참고한다.

봇 만들기 {#create-bot}

다음의 두 단계를 거쳐 봇을 추가한다. 봇은 최대 300개까지 추가할 수 있다.

Developer Console에서 봇 추가: NAVER WORKS 테넌트에 봇을 추가한다.
Admin에서 봇 추가: NAVER WORKS 도메인에 봇을 추가한다.

참고
테넌트는 그룹사에서 사용되는 개념으로, 하나의 테넌트는 하나 이상의 NAVER WORKS 도메인으로 구성된다.
Developer Console에서 추가된 봇은 테넌트에 등록되며, 각 도메인에 해당 봇을 등록하려면 관리자가 Admin에서 봇을 추가해야 한다.

Bot API를 사용해서 봇을 추가할 수도 있다. 자세한 내용은 Bot API 개요를 참고한다.

1. Developer Console에서 봇 추가 {#step-one-add-to-tenant}

Developer Console의 Bot에서 봇을 등록, 편집, 삭제할 수 있다.

화면 오른쪽 위의 등록하기 버튼을 클릭하고, 등록 화면에서 다음 정보를 입력한 후 저장한다.

항목 이름	설명
프로필 이미지	(선택) 봇의 프로필 이미지 파일
이름	(필수) 봇 이름. 봇 이름에 줄 바꿈을 넣으면 공백으로 처리된다.
설명	(필수) 봇 설명
Callback URL	메시지(callback)를 수신하려면 On으로 설정한다. On인 경우 callback 이벤트를 받는 URL(HTTPS 전용)과 수신되는 callback 이벤트, 사용자가 보낼 수 있는 메시지 유형을 선택한다. *주의: Callback URL은 보안상의 이유로 자체 서명된 인증서를 허용하지 않는다. 허용된 인증 기관 목록은 CA 목록을 참고한다.
정책 > 메시지방 참여	1:N 메시지방 참여 가능 여부를 설정한다.
관리자 > 정	(필수) 봇의 정 담당자
관리자 > 부	(선택 사항) 봇의 부 담당자

봇을 추가하면 다음 값이 생성된다.

항목 이름	설명
Bot ID	봇 식별자. Admin에 표시되는 봇 목록의 'Bot No'와 동일한 값으로, Bot API를 사용할 때 필요하다.
Bot Secret	서명 검증에 사용하는 비밀 정보. 자세한 내용은 Callback(메시지 수신)을 참고한다.

Developer Console에서 봇을 추가하면 NAVER WORKS 테넌트에 봇이 추가된다. 사용자에게 봇을 공개하려면 Admin에서 봇을 추가해야 한다.

봇 상태 {#bot-status}

Developer Console의 봇 목록에서 각 봇의 상태를 확인할 수 있다. 봇의 상태는 다음 중 하나이다.

상태	설명
준비 중	Admin에서 봇이 추가되지 않은 상태
서비스 중	Admin에서 봇이 추가되어 실행 중인 상태. 사용자에게 메시지를 보낼 수 있다.
서비스 중(확인 필요)	Admin에서 봇이 추가되어 실행 중이지만 별도 확인이 필요한 상태. 봇 상세 화면에서 내용을 확인한다.

2. Admin에서 봇 추가 {#step-two-add-to-domain}

Developer Console에 추가된 봇을 Admin에서 NAVER WORKS 도메인에 추가한다.

Admin에서 봇을 추가하는 방법은 Admin 사용 가이드를 참고한다.