20. 카카오톡 메시지 템플릿 V2


 

  • 메시지템플릿 v2를 사용하기 위해서 개발사에서는 다음과 같이 사전 준비가 필요합니다.

  1. 카카오개발자사이트(https://developers.kakao.com/ )에 카카오계정으로 로그인 후 개발자 등록 완료합니다.

  2. [메시지 템플릿 v2] 메뉴 접근 권한을 부여받기 위해서, 카카오게임즈 사업담당자에게 권한 발급 요청합니다.

  3. kakao SDK 3.5.0 이상부터 사용가능합니다.

  4. (활용 안내 가이드 다운로드) 

메시지 템플릿 V2

  • 기존 카카오게임 메시지보다 다양한 요소를 가진 메시지로, 피드형과 리스트형 두가지 템플릿으로 구성됩니다.

  • 기존에는 여러장의 이미지나 동영상 링크를 사용할 수 없었고, 하나의 버튼으로 제한된 유입경로를 가지고 있었습니다. 

  • 신규 메시지는 게임 콘텐츠를 더욱 잘 보여줄 수 있도록 여러장 이미지와 동영상 재생 링크 및 스틸컷 첨부가 가능하며, 최대 2개의 버튼 설정을 하실 수 있습니다. 

  • PC,맥 웹 링크를 지원함으로써 매거진 타입 등의 다양한 형태를 시도하실 수 있습니다. 

 

기존 메시지

신규 메시지 V2

기존 메시지

신규 메시지 V2

기본

피드

리스트

 

 

 

 

 

메시지 템플릿 V2 지원 범위

게임 메시지

내용

게임 메시지

내용

카톡 친구에게 초대 메시지 전송

게임에 미가입한 친구에게 보내는 초대 메시지 전송

카톡 친구에게 가입확률기반 초대 메시지 전송

게임에 가입할 확률이 높은 친구목록을 기준으로 초대 메시지 전송

카톡 친구에게 게임 메시지 전송

게임에 가입한 친구에게 하트 보내기, 자랑하기, 아이템 요청 등 메시지 전송 

카톡 그룹방에 그룹방 메시지 전송

유저의 카카오톡 채팅 목록에 그룹 채팅방에 있을 경우, 그룹 채팅방으로 메시지 전송 

  • 상세 카카오톡 게임 메시지 정책은 [카카오 게임센터 - 가이드 - 카카오게임플랫폼 정책 - 3. 구현]에서 확인해 주세요.

 

메시지 템플릿 V2 API 동작 구조

  1. 게임에서 유저의 친구 목록 또는 채팅방 목록 정보를 갱신합니다.

  2. 유저가 친구 목록 또는 채팅방 목록의 메시지 전송 대상 친구에게 초대/게임/그룹 메시지 전송을 요청합니다.

  3. 게임 클라이언트 또는 서버에서 카카오게임 API 서버로 초대/게임/그룹 메시지 전송을 요청합니다. 

  4. 카카오게임 API 서버에서 요청된 파라미터와 템플릿 정보를 토대로 요청 전문을 구성합니다.

  5. 카카오게임 API 서버에서 카카오 API 서버로 요청을 전송합니다. 

  6. 카카오 API 서버에서 요청을 수행합니다.

  7. 수신자의 카카오톡으로 메시지가 보여집니다. 

메시지 템플릿 V2 사용 프로세스  

  1. 개발사는 신규 메시지 템플릿 생성 및 수정 전에, 메시지 내용에에 대해 카카오게임즈 사업담당자와 협의를 합니다. 

  2. 템플릿 등록 및 업데이트는 개발사에서 직접 설정 가능하고, 별도의 승인 절차가 없이 바로 등록이 됩니다. 

  3. 개발사는 템플릿 ID를 기반으로 V2용 API를 연동하여 개발을 진행하시면 됩니다.