페이지 이동경로
  • Docs>
  • Kakao Talk Social>
  • Prerequisites

Kakao Talk Social

Prerequisites

This document explains what you have to do to use the features of Kakao Talk Social.

Tag used in this document
Tag Description
Required You must apply the settings marked with this tag before using the Retrieving friends list API.
If this tag is not attached, you can optionally apply the setting depending on the functions you want to use.

Enable scopes Required

If you want to retrieve user data through Kakao Social APIs, you must enable the required scope in [My Application] > [Kakao Login] > [Consent items]. For more about the consent items, refer to Manage consent items.

API Required scope
Retrieving Kakao Talk profile One of the followings:
- Profile Info(nickname/profile image)
- Nickname or Profile image
Retrieving friends through picker Friends List in Kakao Service(Including profile image, nickname, and favorites)
Retrieving list of friends Friends List in Kakao Service(Including profile image, nickname, and favorites)

Test retrieving list of friends Required

To retrieve the list of Kakao Talk friends through the Retrieving list of friends API and the Friend picker, you must test before Requesting permission.

After implementing the function to retrieve a list of friends by referring to the development guide for the platform you develop, test to check if your app's team members are normally retrieved as follows:

  1. Go to [My Application] > [Kakao Login] > [Consent items], and then set the Friends List in Kakao Service scope to 'Consent during use' under Personal Information.
  2. Implement the function to retrieve a list of friends by referring to the development guide for the platform you develop. If an error occurs, refer to the error cases in DevTalk.
  3. Log into your app with your Kakao Account and consent to 'Friends List in Kakao Service' scope.
  4. If any team member is not registered, add the persons to be tested as team members. If a person invited as a team member does not have a Kakao Developer's account, ask them to sign up for Kakao Developers with the Kakao Account.
  5. Ask the team members to log in to your app with their Kakao Accounts and consent to the 'Friends List in Kakao Service' scope.
  6. Request a list of friends, and then check if the team members are successfully retrieved.
    IMPORTANT: Only the team members who are linked to your app and consented to the 'Friends List in Kakao Service' scope are retrieved.

Request permission Required

Before your app gets permission, your app is:

  • Allowed to set the 'Friends List in Kakao Service' scope to 'Consent during use' only.
  • Able to retrieve the friends' information of the team members only.
IMPORTANT

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:

  1. Test the function for retrieving the list of friends.
  2. Register your company's business registration number in [My Application] > [App Settings] > [Business] to switch your app to Biz app.
  3. In DevTalk, select ➊'친구 API(Friends API)' > '친구 API 사용 신청(Request permission to use Friends API)' category > ➋[새글 쓰기(New Topic)].
    NOTE: You can change the DevTalk interface language to English. How to request pemission in DevTalk
  4. Request permission by referring to How to request permission and checklist. After reviewing your request, the Kakao platform administrator lets you know the result.

After permission is granted, you can:

  • Set the 'Friends List in Kakao Service' scope to 'Optional consent'.
  • Retrieve list of the friends who are linked to your app and consented to the 'Friends List in Kakao Service' scope through these APIs:
    • Retrieving list of friends API
    • Retrieving friends through picker API

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.