This document describes how to integrate Kakao Talk Social APIs into your service with the Kakao SDK for JavaScript ("JavaScript SDK").

Retrieves Kakao Talk profile information linked to the Kakao Account of the logged-in user.

You can check the types and differences of user profiles available through the Kakao API in User profile.

Call the Kakao.API.request() function, and set url to /v1/api/talk/profile to request Kakao Talk profile.

Kakao.API.request() returns Promise. If the promise is fulfilled, the Kakao Talk profile information is returned. For the detailed response fields, refer to REST API > Retrieve Kakao Talk profile.

Kakao.API.request({
  url: '/v1/api/talk/profile',
})
  .then(function (response) {
    console.log(response)
  })
  .catch(function (error) {
    console.log(error)
  })

Opens the Friend picker and returns the information of the Kakao Talk friends selected by the use

• The JavaScript SDK only supports the full screen type of picker, while the Android and iOS SDK provides both the popup and full screen format of picker.
• To see the supported web browser, refer to Supported web browser.

Call one of the following functions depends on the selection type.

The components can be set by parameters.

Kakao.Picker.selectFriends() returns Promise. If the promise is fulfilled, the information of the friends that a user selects from the Friend picker is returned through SelectedUsers.

Kakao.Picker.selectFriend({
  title: 'Select friends',
})
  .then(function (response) {
    console.log(response)
  })
  .catch(function (error) {
    console.log(error)
  })

To call the friend picker on the current web page, use returnUrl parameter.

Specify the URL of the service server that processes the response to the returnUrl parameter. returnUrl must be one of the domains in [App] > [Platform key] > [JavaScript key] > [JavaScript SDK domain] on the app management page. Use the enableBackButton parameter to disable the back button.

When the user completes choosing friends, the web page will HTTP 302 redirect with the response as an encoded query string to the returnUrl.

// Redirect method
// Success: ${returnUrl}?selected=${SelectedUsers}
// Fail: ${returnUrl}?error=${Error}
Kakao.Picker.selectFriends({
  returnUrl: 'https://developers.kakao.com', // Required
  title: 'Select friends',
  maxPickableCount: 10,
  minPickableCount: 1,
})

Retrieves Kakao Talk friend information linked to the Kakao Account of the logged-in user.

You can also add optional parameters for sort order, the number of friends to be retrieved on a page, and so on.

Call the Kakao.API.request() function, and set url to /v1/api/talk/friends to request Kakao Talk friends information.

Kakao.API.request() returns Promise. If the promise is fulfilled, a list of friends is returned. For the detailed response fields, refer to REST API > Retrieve list of friends.

If the promise is rejected because the user has not agreed to provide the Friends list, proceed the followings:

• Check if 'Friends List in Kakao Service(Including profile image, nickname, and favorites)' is set to 'Consent during use' in Consent items.
• Request additional consent to the 'Friends List in Kakao Service(Including profile image, nickname, and favorites)' scope.

Kakao.API.request({
  url: '/v1/api/talk/friends',
})
  .then(function (response) {
    console.log(response)
  })
  .catch(function (error) {
    console.log(error)
  })

• Kakao Talk Social for JavaScript SDK v1