본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

Related sites
  • Docs
  • Kakao Talk Channel
  • Webhook

사이드 메뉴

Docs Home

Getting started

Kakao Developers

Login

Communication

Kakao Map

Navigation

Advertisement

Search

More

Kakao Talk Channel

Webhook

This document introduces the Kakao Talk Channel webhook feature.

Before you begin

This document explains the webhook requests that Kakao sends to your service's endpoint. Note that this specification describes incoming webhook requests from Kakao, not API requests that your service makes to Kakao.

For the overall workflow and detailed implementation guide for webhooks, see Implementation steps.

Kakao Talk Channel webhook

Basic information
MethodURLRequired response formatAuthentication
POSTWebhook URL registered in [My Applications] > [Kakao Talk Channel] > [Kakao Talk Channel Add/Block Callback]HTTP status code 2XX (within 3 seconds)Service app admin key
PermissionPrerequisiteKakao LoginUser consent
-Admin key
Activate Kakao Login
Connect Kakao Talk Channel to app
Set Kakao Talk Channel webhook		--

The Kakao Talk Channel webhook notifies the service when a user adds or blocks a Kakao Talk channel linked to the app.

Upon receiving the callback, the service must respond with an HTTP status code 2XX within 3 seconds.

The webhook applies to Kakao Talk channels listed in [My Applications] > [Business] > [Connected Business Channels]. The service can use the webhook to update the status of the target channel.

Prerequisites

The Kakao Talk Channel webhook requires specifying a webhook URL, and redirection is not supported. For the details, see Set Kakao Talk Channel webhook.

Request

Header
NameTypeDescriptionRequired
AuthorizationStringAuthorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}
App admin key used to verify whether the webhook is valid.		O
X-Kakao-Resource-IDStringX-Kakao-Resource-ID: ${UNIQUE_ID}
Unique ID for distinguishing each webhook.		O
User-AgentStringUser-Agent: KakaoOpenAPI/1.0
String indicating that the webhook was sent from Kakao.		O
Parameter
NameTypeDescription
eventStringChanged status of the relationship between a user and a Kakao Talk Channel.
added or blocked.
idStringService user ID who added or blocked a Kakao Talk Channel.
id_typeStringA type of service user ID.

Either app_user_id or open_id.
  • app_user_id: a user who has agreed to provide 'Kakao Talk Channel addition status and details' among Kakao Login consent items.
  • open_id: a user who has not agreed to provide 'Kakao Talk Channel addition status and details' among Kakao Login consent items.
channel_public_idStringKakao Talk Channel profile ID that a user added or blocked.

Note: plus_friend_public_id has been deprecated and replaced with channel_public_id.
channel_uuidStringKakao Talk Channel profile ID for search purpose.

Note: plus_friend_uuid has been deprecated and replaced with channel_uuid.
updated_atDatetimeThe time when a Kakao Talk Channel is added or blocked in UTC*.

Note: timestamp (in milliseconds) has been deprecated and replaced with updated_at (in UTC).
*The time is based on Coordinated Universal Time(UTC), being 9 hours behind Korean Standard Time(KST). For the format of time, refer to RFC3339: Date and Time on the Internet.

Response

You must respond with HTTP status code 2XX within 3 seconds of receiving the webhook request.

Sample

This is the example of the webhook request that Kakao sends to your service when one of Kakao Talk Channels is added or blocked.

Webhook Request
curl -X POST "{KAKAOTALK_CHANNEL_CALLBACK_URL}"  \

  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \

  -H "Content-Type: application/json" \

  -d '{

        "event":"added",

        "id":"1111",

        "id_type":"app_user_id",

        "channel_public_id":"_FLX",

        "channel_uuid":"@ad",

        "updated_at":"2020-01-01T00:00:00Z"

    }'

Was this helpful?