FAQ

이 문서는 카카오톡 소셜에 대해 자주 묻는 질문과 답변을 제공합니다.

공통

Q. 특정 친구가 카카오톡 친구 목록 조회 API 응답에 포함되어 있지 않습니다.

아래 친구 정보 제공 불가 사유 중 해당하는 항목이 있는지 확인합니다.

1. 카카오톡 친구 목록 조회 API 사용 권한이 없습니다.
   : 사용 방법을 참고해 권한을 신청합니다. 테스트 목적인 경우, 권한이 없어도 멤버에 한해 사용 가능하므로 아래 2번을 참고합니다.
2. 해당 친구가 앱의 멤버가 아닙니다.
   : 카카오톡 친구 목록 조회 API는 사용 권한이 없는 앱 또는 테스트 앱에서는 앱의 멤버에게만 사용 가능하도록 기능 동작이 제한됩니다. 멤버를 추가하지 않고 모든 사용자를 대상으로 카카오톡 친구 목록 조회 API를 사용하려면 사용 방법을 참고해 권한을 신청합니다.
3. 해당 친구가 앱에 카카오 로그인한 적이 없습니다.
   : 해당 친구가 카카오 로그인으로 앱과 연결되어야 합니다. 또한 "카카오 플랫폼 내 친구 목록" 동의항목에 동의해야 합니다. 아래 4번을 참고합니다.
4. 해당 친구가 앱에 카카오 로그인했으나, "카카오 플랫폼 내 친구 목록" 동의항목에 동의하지 않았습니다.
   : 해당 친구가 카카오 로그인으로 앱과 연결된 후, 카카오 로그인 또는 동의항목 추가 동의 요청으로 "카카오 플랫폼 내 친구 목록" 동의항목에 동의해야 합니다.
5. 사용자가 해당 친구를 숨김 친구로 설정하거나 차단했습니다.
   : 사용자가 숨김 또는 차단 설정한 친구는 카카오톡 친구 목록 조회 API 응답에 포함되지 않습니다. 이 경우, 사용자가 카카오톡에서 해당 친구의 상태를 변경해야 합니다.

카카오톡 친구 목록 조회 API는 응답 조건을 만족한 친구들의 정보만 제공할 수 있습니다. 친구 정보 제공 조건에 대해 자세히 확인하려면 이용 정책을 참고합니다.

Q. 카카오톡 친구 목록 조회 API 동작이 앱의 멤버를 대상으로 제한되어 있습니다.

카카오톡 친구 목록 조회 API를 사용 권한이 없는 앱 또는 테스트 앱에서 사용하는 경우, 앱의 멤버만 호출할 수 있고 응답 범위도 해당 멤버로 제한됩니다. 테스트 환경을 지원하기 위해, 사용 권한을 보유한 원본 앱의 테스트 앱에서도 기능이 제한됩니다.

Q. 피커로 제공받은 친구 정보의 수가 선택한 친구 수보다 적어요.

멀티 피커에서 사용자가 선택한 친구의 수가 서비스에 제공하는 친구 정보의 수와 다를 수 있습니다. 이 경우, 사용자의 사용성을 고려하여 사용자가 선택한 친구 수 보다 적은 수의 친구 정보가 전달되었다는 사실을 알려야 합니다.

아래는 선택한 친구 수와 응답의 친구가 다른 경우의 예시 상황입니다.

1. A가 친구 피커에서 B 선택
2. 친구 피커에서 정보 요청이 완료되기 전, B가 앱과 연결을 끊음
3. A가 친구 피커에서 [확인]을 눌러 친구 선택 완료
4. 친구 피커에서 선택된 B는 선택된 친구 수에는 포함되지만, 정보를 요청한 시점에는 앱과의 연결이 끊겨 선택된 친구 정보 목록에 포함되지 않음

Q. insufficient scopes.

{
    "msg": "insufficient scopes.",
    "code": -402,
    "api_type": "FRIENDS",
    "required_scopes": [
        "friends"
    ],
    "allowed_scopes": [
        "talk_message",
        "profile"
    ]
}

원인

사용자가 [카카오 서비스 내 친구목록(프로필사진, 닉네임, 즐겨찾기 포함)] 동의항목에 동의하지 않은 경우 -402 에러가 반환됩니다.

해결 방법

동의항목 추가 동의 요청을 호출하여 사용자로부터 필요한 동의항목에 대해 동의받아야 합니다.