카카오톡 선물하기 for Biz 개발자 센터 에서 최신 문서와 예제 등을 확인하실 수 있습니다.

개발자 센터를 참고해주세요!

API 기능 소개

카카오톡 선물하기 for Biz는 많은 사람들에게 쉽게 마음을 선물할 수 있는 서비스입니다.

API를 이용하면 원하는 시점에 즉시 선물을 전달할 수 있습니다.

문서 History

문서버전 일시 내용 비고
1.0.0 22.01.20 최초 작성
1.1.0 22.04.15 선물 사용 상태 확인 API 추가
MMS 발송 추가, FAQ 내용 추가

용어 정의

용어 설명
고객사 API를 호출하는 고객
API회원등록 API를 사용하기 위해서는 kakao developers의 약관 동의와 앱등록이 필요합니다. 디벨로퍼스에 이미 만들어진 앱이 있다면 연결해서 사용할 수 있고, 혹은 신규로 생성할 수도 있습니다.
API 인증키 kakao developers 의 REST API 키와 동일합니다.
상품 서비스 내에서 판매되고 있는 상품입니다. 재고 등의 이슈로 API로 판매하기 어려운 상품들이 있습니다.
템플릿 API로 선물을 발송위해 필요한 선물 방법입니다. 더 나은 가치를 제공하고 관리의 편의성을 위해 상품, 발송채널, 보내고 싶은 메시지 등을 합쳐 템플릿으로 묶어서 관리합니다. 그리고 API로 호출할 때는 템플릿별로 발송요청을 합니다.
(템플릿)토큰 템플릿이 완성되면 템플릿 별로 고유의 토큰이 발행됩니다. API 호출할 때 이 토큰을 활용합니다.
수신자 선물을 받는 사람을 수신자라고 명명합니다.
주문 템플릿으로 한번에 요청하는 단위입니다. 한번 요청시에 수신자를 여러건을 동시에 요청할 수 있는데 이때 수신자가 다건이어도 주문은 1건 입니다.
선물 수신자에게 전달하는 각 건을 이야기합니다. 주문 요청시에 1건의 수신자만 요청했다면 주문과 선물은 1대1, 주문요청시에 n건의 수신자를 요청했다면 주문과 선물은 1:n이 됩니다.
선물 사용 상태 수신자에게 전달된 선물이 사용되었는지 미사용인지를 판단할 수 있습니다.
MMS 발송 카카오톡이 연결되지 않아 선물을 받을 수 없는 이용자는 MMS로 대신 선물을 받습니다. 템플릿 생성시 설정할 수 있습니다.

연동 절차

API 공통 가이드

API 목록

FAQ