[Open Api] Spring boot로 네이버웍스의 메시지 봇 API를 이용하여 알림 메시지 전송 하기 - 키 발급 및 메시지봇 셋팅 편
네이버웍스클라우드플랫폼 가입
당장 필수는 아니지만 추후 계정 통합이 될 수 있다고 한다.
NAVER CLOUD PLATFORM
cloud computing services for corporations, IaaS, PaaS, SaaS, with Global region and Security Technology Certification
www.ncloud.com
가입 후 아래 링크로 접속하여 상품을 신청 할 수 있다.
https://console.ncloud.com/naverWorks/myProduct
상품 사용 신청 : NAVER WORKS > My Product
- 가입은 Free 로 하면
- 5GB 용량을 제공 해준다.
- 메신저, 일정, 주소록, 홈(게시판), 설문 등의 기능을 사용할 수 있다.
관리자 페이지 접속 : NAVER WORKS > Admin (https://admin.worksmobile.com)
개발자 페이지 접속 : NAVER WORKS > Developers (https://developers.worksmobile.com)
네이버웍스 가입
https://naver.worksmobile.com/
일하는 방식을 바꾸다. 네이버웍스
네이버웍스는 업무용 메신저를 중심으로 메일, 캘린더, 드라이브, 주소록 등의 기능을 통합 제공하는 서비스입니다. 글로벌 금융사부터 소상공인까지, 10만 고객사가 이용 하고 있으며, 일본 유
naver.worksmobile.com
가입 하는 방법이 틀릴 뿐 결국 같은 서비스를 가입하는 형태이다.
둘 중 편한걸로 가입 신청 하면 된다.
PC 앱 다운로드
https://naver.worksmobile.com/download/
다운로드 - 네이버웍스
네이버웍스 iOS, Android 모바일앱과 Windows, macOS용 PC앱을 다운로드 할 수 있습니다. 또한 Windows, macOS용 드라이브 탐색기도 다운로드 할 수 있습니다. 단 드라이브 탐색기는 Basic, Premium 상품에서만
naver.worksmobile.com
API 키 발급 사이트 접속
https://developers.worksmobile.com
NAVER WORKS Developers
NAVER WORKS Developers에 오신것을 환영합니다. 귀사의 시스템/서비스와 연동할 수 있는 다양한 API가 준비되어있습니다. 바로 시작 하실 수 있도록 안내하겠습니다. 바로 시작하기
developers.worksmobile.com
로그인 후 우측 상단 'Developer Console' 접속
API 키 발급 및 정보 확인
좌측 메뉴 중 API 메뉴로 접속 한다.
Tenant ID, Domain ID
좌측 메뉴 하단에 빨강네모 표시한 부분 확인
API ID
발급 버튼을 누르면 된다.
↓
Server Api Consumer Key
발급 버튼을 누르면 옵션 선택 후 발급 된다.
↓
메시지 Bot 전체를 선택해준다. ( 메시지 봇 관련 API 모두 사용 가능 )
↓
Token 유효기간은 '365일' 선택한다. (사용안해도 365일까지 사용할 수 있다.)
Token 유효기간 자동 연동을 '예'로 선택한다. (API를 마지막 사용한 날로 부터 365일로 유효기간이 계속 변경 된다.)
↓
권한부여에 따른 여러개의 key 발급이 가능하다.
토큰 발급용 데이타(ID, 비밀키)
- Server list(ID 등록 방식) 에서 추가 버튼을 클릭 한다.(호출하는 서버의 IP 상관없이 사용 가능하다.)
- 호출하는 서버의 고정IP가 있다면 Server list(고정 IP 방식)을 사용하해서 토큰을 발급 받는 절차를 줄일 수 있다.
↓
'서버명'은 적당히 알아서 정해주면 된다.
'Key 선택'은 먼저 등록해준 Server Api Consumer Key 중 하나를 선택해주면 된다. (쌍으로 헤더에 넣어서 API 호출함)
↓
서버 Token을 발급 받을 때 사용하는 값들이다.
'ID'를 따로 적어둔다.
'비밀키'를 다운로드 받아 잘 저장해둔다.
↓
메시지 봇 생성
- API로도 제공이 된다. ( https://developers.worksmobile.com/kr/document/5?lang=ko )
- UI 로도 제공되니까 그걸로 만들겠다.( API로 만들기 귀찮으니까 ㅎㅎ )
↓
Bot 프로필 이미지 : 메시지 대화방에 표시되는 사진을 등록 하면 된다.
Bot 이름 : 메시지 대화방에 표시되는 봇의 이름이다.
Bot 설명 : 메시지 봇에 대한 간단한 설명
Callback URL : 네이버웍스 메시지봇을 이용하여 간단한 챗봇 기능을 만들때 활용 할 수 있다.
Bot 정책 - 메시지방 참여 : 다양한 그룹 대화방에 해당 메시지봇을 참여 시킬 수 있다.(단체 대화방에 메시지려면 체크 해야 한다.)
Bot 정책 - 정 : 관리자 권한을 받은 계정을 하나 아무거나 등록 해주면 된다.
↓
등록 후 고유 메시지 Bot 번호가 부여된다.
도메인에 메시지봇 사용권한 부여하기 위해 관리자 사이트 접속
메시지봇은 Tenant ID별로 공통으로 생성, 수정, 삭제 할 수 있다.
메시지봇을 사용하려면 Domain ID별로 사용 권한을 부여해야 한다.
https://admin.worksmobile.com/service/bot
Admin
admin.worksmobile.com
서비스 > Bot 메뉴에서 'Bot 추가' 버튼 클릭
↓
'추가' 를 클릭하면 바로 추가 된다.
↓
서비스 > Bot 메뉴에 다시 접속 하면 추가된걸 확인 할 수 있다.