FAQ

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

공통

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

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

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

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

Q. 카카오톡 친구 목록 가져오기 API 동작이 앱의 팀원을 대상으로 제한되어 있습니다.

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