Kakao Talk Sharing: Callback

This document introduces callback information for Kakao Talk Sharing.

Before you begin

Check the Usage policy before using the callback.

Kakao Talk Sharing callback

Basic information

Method	URL	Required response format	Authentication
GET/POST	Callback URL registered in [My Applications] > [Messages] > [Kakao Talk Sharing Callback]	HTTP status code 2XX (within 3 seconds)	Service app admin key

Permission	Prerequisite	Kakao Login	User consent
-	Set Kakao Talk Sharing callback	-	-

The Kakao Talk sharing callback notifies the service when a Kakao Talk sharing message is successfully delivered to the selected friends or chat rooms. Upon receiving the callback, the service must respond with an HTTP status code 2XX within 3 seconds.

Prerequisites

The Kakao Talk sharing callback requires specifying a callback URL and method to be used, and redirection is not supported. For configuration details, refer to Set Kakao Talk Sharing callback.

Additionally, to receive the KakaoTalk sharing callback, user-defined parameters must be specified with serverCallbackArgs when sending a Kakao Talk sharing message. For the details, see the platform-specific development guides below.

• JavaScript
• Android
• iOS

Request

Header

Name	Type	Description	Required
Authorization	String	Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY} The Admin key as a type of user authentication.	O
X-Kakao-Resource-ID	String	Unique ID for each Kakao Talk Sharing callback. (Example: Rvy1c2dkzBAZ5hGD3rqYbxvr)	O
User-Agent	String	String used to identify the request sent from Kakao. Fixed to KakaoOpenAPI/1.0.	O

Parameter

Name	Type	Description	Required
CHAT_TYPE	String	Type of chatroom to which Kakao Talk Sharing message is sent. One of the followings: MemoChat: My Chatroom DirectChat: 1:1 chat with other users MultiChat: Group chat with other users OpenDirectChat: 1:1 Open Chat OpenMultiChat: Group Open Chat	O
HASH_CHAT_ID	String	A reference ID of the chatroom that receives a Kakao Talk Sharing message. As a unique hash value for each service, a different ID is assigned for each service, even for the same chatroom.	O
TEMPLATE_ID	Long	The message template ID used when sending a Kakao Talk Sharing message using the message template ID. If you do not use the message template ID when requesting, an empty value is returned in the response.	X

Response

• HTTP status code 2XX (within 3 seconds)

Sample

Request: GET method

curl -v -G GET "${KAKAOLINK_CALLBACK_URL}?CHAT_TYPE=MemoChat&HASH_CHAT_ID=${HASH_CHAT_ID}&TEMPLATE_ID=10000&custom_parameter_key=custom_parameter_value" \
    -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
    -H "X-Kakao-Resource-ID: ${UNIQUE_ID}" \
    -H "User-Agent: KakaoOpenAPI/1.0"

Request: POST method

curl -v -X POST "${KAKAOLINK_CALLBACK_URL}" \
    -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
    -H "X-Kakao-Resource-ID: ${UNIQUE_ID}" \
    -H "User-Agent: KakaoOpenAPI/1.0" \
    -H "Content-Type: application/json" \
    -d '{
            "CHAT_TYPE":"MemoChat",
            "HASH_CHAT_ID":"${HASH_CHAT_ID}",
            "TEMPLATE_ID":10000,
            "custom_parameter_key":"custom_parameter_value"
        }'