2. KAKAOWORK BOT API 사용해보기

일단 POSTMAN을 사용해서 api요청을 해본다.

모든 req는 json 형식으로 맞췄다.

 

참고 : https://docs.kakaoi.ai/kakao_work/botdevguide/bot_dev/   

 

1. Bot 인증

• 요청 url : https://api.kakaowork.com/v1/conversations.open
• http method : post
• header : Authorization : Bearer {YOUR_APP_KEY}
• body : { "user_id" = {USER_ID} }

 

여기서 YOUR_APP_KEY는 이전 게시물에서 bot 생성시 발급받은 app key이다

USER_ID를 몰라서 헤맸는데, 내가 해결 한 방법은 다음과 같다.

 

[이메일로 user 정보 받기]

참고 : https://docs.kakaoi.ai/kakao_work/webapireference/users/#usersfind_by_email

• 요청 url : https://api.kakaowork.com/v1/users.find_by_email?email={EMAIL}
• http method : get
• header : Authorization : Bearer {YOUR_APP_KEY}

요청 url에서 EMAIL은 내가 workspace를 만들 때 사용한 email을 넣어주었고, YOUR_APP_KEY에는 마찬가지로 bot 생성시 발급한 app key를 넣어주었다.

postman 요청 화면

[응답]

200 OK, "success": true가 반환되면 성공한 것이다.

user 부분에서 id가 해당 이메일을 가진 회원의 USER_ID가 된다.

2. APP_KEY와 USER_ID로 채팅방 생성하기

docs를 보니 1번의 Bot인증과 봇과 user간 채팅방 생성하는 url이 같았다. 따라서 email로 부터 회원 id를 받고 채팅방을 바로 생성했다

• 요청 url : https://api.kakaowork.com/v1/conversations.open  
• http method : post
• header : Authorization : Bearer {YOUR_APP_KEY}
• body : { "user_id" = {USER_ID} }

body부분. header는 위의 요청처럼 Headers에 app key를 넣어준다

response

response에서의 id가 봇-user 간 채팅방의 id가 된다. 현재는 bot-user 1:1 채팅방이고, 단체 채팅방도 생성할 수 있다.

여기서 받은 id를 통해 해당 톡방에 메세지를 보낼 수 있다

 

3. 톡방 id를 사용해서 메시지 전송하기

• 요청 url : https://api.kakaowork.com/v1/messages.send
• http method : post
• header : Authorization: Bearer {YOUR_APP_KEY}" , Content-Type: application/json
• body : { "conversation_id": "{메시지를 보낼 채팅방 ID}", "text": "Hello" }

여기서 {메시지를 보낼 채팅방 ID} 가 2번 응답에서의 id이다

보낸 후 톡방을 확인하면 된다

새로 생성된 알림봇과의 채팅방에 text hello로 톡이 온 것을 확인할 수 있다.