This document introduces the features of the Kakao Talk Channel API.

Kakao Talk Channel API helps you make better use of Kakao Talk Channel, the business home of Kakao Talk. It provides a connection page that allows users to easily navigate to the Kakao Talk Channel add page or start a 1:1 chat from your service.

To use the Kakao Talk Channel API, the app must be connected to a Kakao Talk Channel and user consent to the [Kakao Talk Channel addition status and details] consent item is required. For instructions on connecting a Kakao Talk Channel, see Connect Kakao Talk Channel to app. For consent item settings, see Kakao Talk Channel consent item settings.

Kakao Talk Channel provides the following APIs.

• Add Kakao Talk Channel: Easy addition of Kakao Talk Channel using Kakao SDK
• Manage Kakao Talk Channel customers: Convenient customer group management for administrators
• Manage Kakao Talk Channel relationship: Efficient friend management for administrators

This section explains how to connect a Kakao Developers app and a Kakao Talk Channel. For how to disconnect a channel, see Connected Kakao Talk Channel.

A Kakao Talk Channel can be connected only to an app owned by the same business operator. Convert each to a Biz app and a Business channel respectively by registering identical business information in both the app and the Kakao Talk Channel. After converting to a Biz app and Business Channel, you can connect a Kakao Talk Channel to the app via Request additional features. See the steps below.

Login with an account that has the Owner or Editor role for the app, and select [Check eligibility] in [App] > [Request additional features] on the app management page. After checking the eligibility requirements, you must agree to them.

[App] > [Request additional features] > When you select [Request] in the [Additional features] section under [Connect Kakao Talk Channel], the Connectable Kakao Talk Channel list appears. Selecting a desired channel connects the app and the Kakao Talk Channel. You can check the connected channels in Connected Kakao Talk Channel and disconnect them if necessary.

Kakao SDK provides two selectable features to add Kakao Talk Channels depending on the service environment. See the details of each feature below.

Follow Kakao Talk Channel(followChannel()) is a convenient feature for adding a Kakao Talk Channel and receiving the result with only one API request. Any additional process to know the result is not required since the addition result is provided in the response.

If the user is not available to add the Kakao Talk Channel, a guidance screen for each status will be provided.

Refer to the screens and guidelines below.

If the service uses Kakao Login, process the request for adding Kakao Talk Channel according to the user's login status.

1. Request followChannel().
2. Add Kakao Talk Channel screen will be displayed.
3. Response informs whether the user added the Kakao Talk Channel.

1. Request Kakao Login.
2. Kakao Login consent screen will be displayed.
   • Users can add the Kakao Talk Channel on the Kakao Login consent screen.
3. Check Kakao Talk Channel relationship to figure out whether the user added the Kakao Talk Channel.
   • If added, provide features appropriate for the situation. (Example: Promotion page for users who added the Kakao Talk Channel)
   • If not added, Request Follow Kakao Talk Channel as Logged in users.

If the service is not using Kakao Login, process the request for adding Kakao Talk Channel as below.

1. Request followChannel().
2. Login with Kakao Account screen is displayed.
3. After login, Add Kakao Talk Channel screen is displayed.
4. Response informs whether the user added the Kakao Talk Channel.

Kakao Talk Channel API provided by Kakao SDK displays a bridge page for users to go to a Kakao Talk Channel. When the user accesses the bridge page, a pop-up that asks whether to move to the Kakao Talk Channel is presented. If the user accepts, the Kakao Talk app is launched through the Custom URL Scheme and moves to the corresponding Kakao Talk Channel. Users can add the Kakao Talk Channel as a friend or start a chat on the Kakao Talk Channel.

We recommend using Follow Kakao Talk Channel instead of Add Kakao Talk Channel for more convenience in implementation.

This section explains the Kakao Talk Channel management features provided by Kakao Developers.

You can use the Kakao Talk Channel customer file registration and management features provided in the Kakao Talk Channel Manager Center with the below API.

• Customer management: Register customer file
• Customer management: View customer file
• Customer management: Add user
• Customer management: Delete user

By uploading customer files based on user information obtained through Kakao Login or Kakao Sync Simple Signup with the Kakao Talk Channel customer management API, you can create condition-based friend groups in the Kakao Talk Channel Manager Center and send more targeted messages. For more details, see the Kakao Talk Channel Manager Center notice.

To use the Kakao Talk Channel customer management API, you must first agree to the relevant policies. For the agreement method, see Customer Management API Policy Agreement.

The Kakao Talk Channel customer management API must be called only from the server. Developer documentation can be found in REST API.

This section explains the features for checking the status and receiving notifications regarding addition and blocking of Kakao Talk Channels.

Use Check Kakao Talk Channel relationship API to figure out whether the user added the Kakao Talk Channel. This API helps to Add Kakao Talk Channel or Manage Kakao Talk Channel customers according to the addition status. Refer to the guides below.

• REST API
• JavaScript
• Android
• iOS

Use Kakao Talk Channel webhook to get notifications when the user adds or blocks the Kakao Talk Channel. This feature helps the services manage the friend list more precisely for the relationship changes out of the service.

You can check the KakaoTalk Channel ID in [채널 (Channel)] > [채널 정보 (Channel Info)] > [채널 URL (Channel URL)] on the [KakaoTalk Channel Partner Center]. The value after excluding the https://pf.kakao.com/ part of the channel URL is the profile ID of the KakaoTalk Channel. See the example below.

• Channel URL: https://pf.kakao.com/_ZeUTxl
• Channel ID: _ZeUTxl

You can connect Kakao Talk Channels to your app that meet the below conditions

• Channels with master or manager permissions.
• Channels converted to a Business Channel by registering business information.
  • For Business Channels that use Kakao services such as Talk Store but do not have business information registered, registration is required in [채널 (Channel)] > [비즈니스 심사 (Business verification)] on the KakaoTalk Channel Partner Center.
• Channels with the same business information registered as the app.
• Channels not connected to the app.

A business channel is a Kakao Talk Channel that has business information registered by the service owner. For how to request converting a Kakao Talk Channel into a business channel, see below instructions.

1. Log in to the Kakao Talk Channel Partner Center with the Kakao Account that manages your service's Kakao Talk Channel. If your service does not have a Kakao Talk Channel, you can create one at the Kakao Talk Channel Partner Center.
2. After selecting the Kakao Talk Channel to convert into a business channel, go to [채널 (Channel)] > [비즈니스 심사 (Business verification)] to request the conversion. Application guidelines vary by industry, so ensure you review the Business Channel Review Guide before applying. The business channel review takes approximately 3-5 business days. For inquiries, contact the Customer Center.

If you need a test Kakao Talk Channel that does not affect the service, you can create a developer channel by selecting [개발자용 채널 만들기(Create developer channel)] in the Kakao Talk Channel Manager Center. At least one Business Channel is required for the button to be displayed. Connect the developer channel to the test app, and set it as the primary channel for use.

To use the Check Kakao Talk Channel relationship API after connecting Kakao Talk Channel to the app, set up consent items and obtain the user's consent. In the app management page [App] > [Kakao Login] > [Consent Items], set [Kakao Talk Channel addition status and history (plusfriends)] to [Required consent] or [Optional consent] as the consent level. This consent item can only be set when a Kakao Talk Channel is connected to the app.

Refer to Scope of support to know whether each Kakao SDK supports each feature.