This document introduces the features of the Kakao Talk Social APIs.
The Kakao Talk Social enables your service to broaden the social media function by providing user's Kakao Talk profile and Kakao Talk friends data.
The Kakao Talk Social includes the following APIs:
|Retrieving Kakao Talk profile||Provides a user's profile information of Kakao Talk that is linked to the user's Kakao Account.
Refer to Kakao Talk profile and Usage policy.
|Retrieving friends through picker||Provides the user interface, called 'Friend picker' which a user can select Kakao Talk friends on, and provides the selected friends data.
Refer to Friend picker and Usage policy.
|Retrieving list of friends||Provides the Kakao Talk friends data for your service to leverage the friends data according to your service UI.
Refer to Retrieving list of friends and Usage policy.
If you want to implement a function of sending messages to the Kakao Talk friends obtained through the Kakao Talk Social API in your service, you need to use the Kakao Talk messaging API together. For more about the Messaging APIs, refer to Message.
You can retrieve the Kakao Talk profile data of the currently logged-in user through the Retrieving Kakao Talk profile API.
If a user selects the 'Always keep it up to date' option in [Settings] > [Kakao Account] > [Manage MyInfo] > [Profile Update Settings] on the Kakao Talk application, the updated Kakao Talk profile is applied to the Kakao Account profile. Except for this case, the Kakao Talk profile data passed in response to the Retrieving Kakao Talk profile API is different from the Kakao Account's profile data. If you want to get a user's Kakao Account profile information, use the Retrieving user information API.
This API provides the list of a user's Kakao Talk friends. Unlike the Retrieving friends through picker API that displays the Friend picker, you must implement the user interface internally for the list of friends in your service.
Example of a user interface using the Kakao Talk friend data
The Friend picker is the user interface on which a user can select Kakao Talk friends. The Retrieving friends through picker API displays the Friend picker and provides the data of the friends whom a user selects. If you want to implement the Friend picker in your service and leverage the users' Kakao Talk social information, use the Kakao SDKs.
The Friend picker provides a diverse user interface and the following features that you can implement for your service's needs.
Before your app gets permission, your app is:
Except for test purpose, you must request permission to operate your service even though you only need the team member's data.
To retrieve all of the friends' information through the Retrieving list of friends API and Friend picker as well as the team members of the app, request permission as follows:
After permission is granted, you can:
Even after you have permission, only the friends data that meets the conditions described in Usage policy is displayed on the list of friends. If a specific friend is not displayed, check FAQ.
The Kakao Talk messaging API provides a feature for sending a message to the user's friend on Kakao Talk. As well as the Kakao Talk Social features, permission is required to use the feature. You can request both permissions at once. Refer to Request permission and DevTalk.
The profile visibility option allows users to hide or show their profile on the Friends list of your service. If users select to hide their profiles on the Friends list of a service, they cannot receive any messages from their friends using the service.
Users can check or change the profile visibility settings by selecting [Preferences] at the bottom right of the message sent from their friends. If a user disables the 'Show my profile on Friends list' option on the Preference page, the user is not only displayed on the Friends list, but also the user's friends cannot send any message in the service.
[Preferences] is displayed only to the recipient’s message sent through the Kakao Talk messaging API. Note that [Preferences] is not displayed on the following messages:
Users can also change the profile visibility settings by selecting [Agree] or [Withdraw] for the '[Optional] Show my profile on Friends list' access right. Users can allow or deny this access right in either way:
If a user denies the access right, the user's profile is not displayed on the Friends list, and the user's friends cannot send any Kakao Talk messages through your service app.
You can obtain users' friends through either of the following APIs:
These APIs are only allowed for apps with the given permission. To use these API, request permission.
The friends list retrieved through these APIs may not include all Kakao Talk friends information of the user, which means that the number of the friends displayed on the friends list may differ from the actual number of Kakao Talk friends.
When a user requests the list of friends, only the user's friends who meet all of the following conditions are displayed on the friends list:
We do not provide an open API to give all Kakao Talk friends information of a user. Because the Kakao Talk friends data is private information, we strictly require consent for the user and each friend to provide their private information to a third-party. For this reason, the target of the Retrieving list of friends API and Retrieving friends through picker API is limited to the app users, not all of the Kakao Talk friends.
The Retrieving list of friends API and Retrieving friends through picker API are not allowed to use for other purposes. - You must not provide other users with the friends' relationship. - You must not retain the friends data for other purposes, except for improving user’s environment in your service. - You must not provide the analyzed or combined information related to friends' relationships.
The response to the Retrieving list of friends API and the Friend picker is affected by multi-profile. The Multi-profile function enables the Kakao Talk users to set multiple profiles and show a different profile to each friend.
Kakao Talk profile information includes a user's nickname (nickName), a profile image URL (profileImageUrl), and a Kakao Talk profile thumbnail image URL (thumbnailUrl). When you call the Retrieving list of friends API or the Friend picker, the nickname and profile image URL are passed differently in the response with the given priorities.
For example, if user A requests to retrieve the list of A's friends, the nickname and profile image of user B (A's friend) are displayed with the following priorities:
On the other hand, the multi-profile feature does not affect the response of Retrieve Kakao Talk profile API because the default profile information set by a user is used.
The Retrieving list of friends API refreshes the data every 10 minutes and returns cached responses within 10 minutes before the next API call. Once you request this API, you receive the same friends' list as the previous request within 10 minutes, even though some friend information changes. To receive the updated list of friends, you must make a request again 10 minutes later.
|Retrieving Kakao Talk profile||●||●||●||●||●|
|Retrieving friends through picker||●||●||●|
|Retrieving list of friends||●||●||●||●||●|