카카오 메세지 API 테스트 나에게 보내기

메시지 API는 사용자가 카카오톡 친구에게 카카오톡 메시지를 보내는 기능을 제공합니다.

이 API는 메시지를 통한 정보 공유 및 서비스 재방문 효과에 초점을 두고 만들어졌습니다.

메시지 API로 보낸 메시지는

카카오디벨로퍼스(Kakao Developers, 이하 개발자 웹사이트)에 등록된 애플리케이션(이하 앱) 정보를 담고 있어,

사용자가 메시지를 통해 서비스 웹사이트나 앱을 방문할 수 있습니다.

메시지 API로 보낼 카카오톡 메시지는 공유할 정보의 특징이나 메시지의 성격에 따라 적합한

템플릿을 선택하여 구성할 수 있습니다. 지원하는 메시지의 종류와 만드는 방법은 메시지 템플릿을 참고합니다.

메시지를 보내는 방법은 크게 두 가지로,

카카오톡 공유 API를 사용하는 방법과 카카오톡 메시지 API를 사용하는 방법이 있습니다.

두 API의 차이점은 다음과 같습니다.

설명	카카오톡 공유 API	카카오톡 메시지 API
카카오톡 친구 목록 페이지	카카오톡 앱에서 카카오톡 친구 목록 이용	친구 목록 가져오기 API를 사용해 자체 구현
메시지 전송이 가능한 친구의 범위	카카오톡의 모든 친구	친구 목록 가져오기 API의 정보 제공 조건에 맞는 친구
카카오톡 앱으로 이동해 메시지 전송	O	X
메시지 전송 요청 실행	카카오톡	서비스 클라이언트 또는 서버
사용 신청 및 검수	X	O
REST API 지원	X	O
메시지 전송 성공 여부 확인	카카오톡 공유 전송 성공 알림 기능을 사용해 자체 구현	API 응답으로 확인

 

 

 

 

카카오톡 공유 API는 서비스 클라이언트에서 카카오톡 앱을 실행시켜 카카오톡 메시지를 보내는 반면, 카카오톡 메시지 API는 카카오톡 앱을 실행시키지 않고 서비스 클라이언트나 서버를 통해 카카오톡 친구에게 메시지를 보낼 수 있도록 합니다. 대신, 두 가지 API 모두 카카오톡 메시지를 전송하므로 사용자 카카오계정에 연결된 카카오톡이 없는 상태, 즉 카카오톡 미사용자라면 메시지 보내기 요청 시 에러가 발생합니다.

카카오톡 공유 API는 카카오가 제공하는 카카오톡 친구 또는 대화 목록 페이지를 띄워 사용자가 메시지를 보낼 수 있도록 합니다. 따라서 서비스가 카카오톡 친구 정보를 출력하는 페이지를 직접 만들 필요가 없고, 모든 카카오톡 친구가 목록에 포함됩니다. 대신, 카카오톡 친구 정보를 데이터로 제공하지 않습니다. 카카오톡 공유 API는 웹 페이지 소스코드에 공유할 내용을 정의하는 등 상대적으로 간단하게 기능을 구현할 수 있습니다.

 

 

반면 카카오톡 메시지 API는 친구 목록 가져오기 API를 통해 받은 친구 정보 중 지정한 친구에게 메시지를 보내는 기능을 제공합니다. 카카오톡 친구 정보를 데이터로 제공하지만 카카오톡 친구 목록 페이지를 띄워주지 않습니다. 따라서 서비스는 사용자의 카카오톡 친구 정보를 받아 처리하는 기능과 친구 목록을 직접 만들어야 합니다. 또한 친구 목록 가져오기 API와 카카오톡 메시지 API는 각각 사용 권한 신청이 필요합니다.

 

 

 

 

이 페이지에서는 카카오톡 메시지 API를 통해

나에게 메세지 보내는 방법을 테스트 해보겠습니다

 

https://developers.kakao.com/

Kakao Developers

먼저 위 링크로 접속하여 회원가입을 진행합니다. 

카카오로그인화면

 

기존에사용하는 카카오톡을 사용하여 로그인 하거나 신규로 카카오 아이디를 만들어서 회원가입을 합니다 

 

카카오계정과 사용할 이름을 넣고 회원가입

 

디벨로퍼메인화면

 

시작하기 또는 내어플리케이션을 클릭

 

필요한 내용을 넣고 저장

 

메뉴 - 도구 - REST API 탭으로 이동

 

상단의 메뉴에서 도구 메뉴에서 REST API 테스트 메뉴로 이동을 합니다.

 

메시지 - 나에게 기본 템플릿으로 메시지 보내기

 

메시지 - 나에게 기본 템플릿으로 메시지 보내기 메뉴로 이동하여 인증 앱우측 가로 막대 부분을 클릭하여 

이전에 생성한 앱으로 변경을 해줍니다 

 

토큰발급

이상태로 토큰발급을 하면 아래와 같이 권한 에러가 발생하게 됩니다

권한이 부족하여 발생하는 오류로 입니다

 

 

 

상단 메뉴의 내 어플리케이션 -> 앱설정으로 이동하여 아래와 같이 권한 부여 및 활성화 설정을 진행합니다. 

카카오로그인 활설화설정

 

 

메세지전송 동의항목설정

 

 

 

다시토큰발급

 

동의하기

 

 

메세지전송테스트

 

{     "object_type": "text",     "text": "메세제 전송 테스트!!",     "link": {} }

메세지는 json 형태로 테스트를 진행해 봅니다. 

 

메시지수신

 

 

요청코드예시를 참조하여 아래와같이 postman에서 테스트를 할 수 있습니다

 

postman인증

 

header변경

메세지body작성

 

메세지수신

 

 

 

나에게 보내기 요약

기본 정보

메서드	URL	인증 방식
POST	https://kapi.kakao.com/v2/api/talk/memo/default/send	액세스 토큰

 

권한	사전 설정	카카오 로그인	사용자 동의
-	플랫폼 등록 카카오 로그인 활성화 동의항목	필요	필요: 카카오톡 메시지 전송(talk_message)

 

 

요청헤더

이름	설명	필수
Authorization	Authorization: Bearer ${ACCESS_TOKEN} 인증 방식, 액세스 토큰으로 인증 요청	O

 

 

본문

이름	타입	설명	필수
template_object	Object	메시지 구성 요소를 담은 객체(Object) 피드, 리스트, 위치, 커머스, 텍스트, 캘린더 중 하나	O

 

 

응답본문

이름	타입	설명	필수
result_code	Integer	전송 성공 시 0	O