1.문서에서 카카오톡 메시지, 메시지 API 검수 신청 방법을 반드시 확인하세요.
- API 검수 신청을 하기 전의 테스트 단계에서 서비스에 도입하여 충분히 테스트 하신 후, 서비스 오픈 혹은 배포 전에 검수 신청하기해주시기 바랍니다.
- 테스트 과정에서 발생하는 문제들에대해서는 [faq] 친구 목록 api, 메시지 전송 api를 연동하는 과정에서 자주 겪는 에러를 참고해보시기 바랍니다.
2.검수 방법
반드시 신청하시는 서비스에 API나 SDK가 연동되어 정상적으로 호출이 된 상태만 검수받을 수 있습니다.
-
해당 앱의 ‘[내 애플리케이션 > 설정 > 일반 > 비즈 앱 정보 > 사업자 정보 등록]’ 에서 비즈앱 신청을 해주세요.
-
신청에 사용한 사업자등록증 사본을 카카오 계정(@kakao)에 메시지로 전달해주세요.
사업자 등록번호: 651-81-00957
- App id: ID 661338
- OWNER의 개발자 계정 (email), 앱 이름을 알려주세요.
- OWNER의 개발자 계정은 ‘내 애플리케이션 > 설정 > 팀 관리’ 에서 확인하세요
- Owner: Skander Mankai - email: skander.mankai10@gmail.com
- Developer: David Gula - email: david.gula@nxtsoft.sk
- 앱에서의 API를 활용하는 이유/방식을 알려주세요.
- 친구 api를 함께 사용하실 계획이라면 알려주시기 바랍니다.
Front는 다음과 같은 단일 플랫폼에서 모든 커뮤니케이션 채널을 재그룹화하는 고객 커뮤니케이션 플랫폼입니다.
이메일
SMS
왓츠앱
라인
페이스북 메신저
등.
- 친구 api를 함께 사용하실 계획이라면 알려주시기 바랍니다.
다음을 위해 메시지 API를 사용해야 합니다.
고객 커뮤니케이션의 메인 백오피스인 Front에서 인바운드 메시지 수신
프론트에서 아웃바운드 답장을 보내 카카오톡 메시지에 답장하세요.
수신자를 식별하고 Front에서 메시지를 보낼 수 있으려면 Friend API에 액세스할 수 있어야 합니다.
- 메시지 전송 API가 적용된 서비스를 저희가 직접 확인하기 위해, '로그인을 하는 시점부터 해당 서비스까지 이동하는 순서’를 상세히 알려주세요.
-[누가 어떻게 로그인을 하는지]
-[어떤 동작으로 친구 목록을 확인하는지]
-[어떤 동작으로 메시지를 전송하는지]- 이미 오픈/운영중인 서비스는 iOS/Android 마켓 링크 혹은 웹 서비스 주소를 알려주세요.
누가, 어떻게 로그인하는지 : 카카오톡 계정이 있는 사용자가 프론트앱을 통해 커스텀 채널에 로그인합니다. 그런 다음 FrontApp은 OAuth 확인 프로세스를 수행하고 액세스 토큰을 획득합니다. 그런 다음 요청과 함께 당사 서비스에 전송하고 이를 카카오 API에 대한 요청에 대한 베어러 토큰으로 사용합니다.
- 이미 오픈/운영중인 서비스는 iOS/Android 마켓 링크 혹은 웹 서비스 주소를 알려주세요.
친구 목록 확인 방법: FrontApp은 이메일 클라이언트이므로 UI를 통한 친구 목록 표시는 지원하지 않습니다. 이메일/프로필 닉네임을 기반으로 친구를 선택합니다. 예를 들어 사용자가 Front를 통해 메시지를 보낼 때 주소 필드에 친구의 이메일/닉네임을 입력합니다. 그런 다음 그러한 이메일/닉네임을 가진 친구를 찾으려고 시도하고 구체적인 계정을 찾으면 메시지를 보냅니다. 그렇지 않으면 오류가 발생합니다.
메시지를 보낼 작업: 서비스가 Front에서 메시지를 수신할 때 메시지가 전송됩니다. 즉, 사용자가 Front 사용자 정의 채널에 메시지를 작성합니다. 지금은 Postman을 사용하여 요청을 수동으로 수행하여 테스트하고 있습니다. 앞으로 사용자가 Front에서 메시지를 보내려고 하면 서비스에서 웹훅 메시지를 받게 됩니다.
Here is the example of request to kakao api.
This is used to retrieve the list of friends:
GET https://kapi.kakao.com/v1/api/talk/friends HTTP/1.1
Host: kapi.kakao.com
Accept: application/json
Authorization: Bearer KnRAcj2951gXLETKxR1avg3p4AM1_1G195KZlgo9cpcAAAF-VDEyGg
This is used to send the message to a friend:
POST https://kapi.kakao.com/v1/api/talk/friends/message/default/send HTTP/1.1
Host: kapi.kakao.com
Accept: application/json
Authorization: Bearer KnRAcj2951gXLETKxR1avg3p4AM1_1G195KZlgo9cpcAAAF-VDEyGg
Content-Type: application/x-www-form-urlencoded
Content-Length: 395
Parameters:
receiver_uuids=[“l6WUrJqvlqSTpIi7jL6Gs4OzhbCcqpytnq2V-w”]&template_object={“object_type”:“text”,“text”:“Anything+less+than+immortality+is+a+complete+waste+of+time.”,“link”:{“web_url”:“https://developers.kakao.com/",“mobile_web_url”:“https://developers.kakao.com/”},“button_title”:"Kakao+Developers”}
- 테스트가 완료되어 서비스에 적용된(될) '실제 동작 화면 영상 혹은 캡쳐’를 첨부해주세요.
3.검수를 마친 후
검수를 마치면 "내 애플리케이션 > 설정 > 사용자 관리 > 동의항목 > 설정"에서 “카카오톡 메시지 전송” 접근권한 관리항목을 설정할 수 있게 됩니다.