Kakao Friends API 호출 시 total_count가 1명만 반환됩니다

문의 시, 사용하시는 개발환경과 디벨로퍼스 앱ID를 알려주세요.

1435217

개발환경:

  • Backend: Spring Boot
  • API 테스트: Postman
  • 호출 방식: REST API
  • 실행 환경: local
  • OS: macOS

안녕하세요.

Kakao Friends API를 이용해 카카오톡 친구 목록을 조회하고 있는데,
실제 카카오톡 친구 및 앱 테스트 팀원은 여러 명인데 API 응답에서는 1명만 반환됩니다.

호출 API:
GET https://kapi.kakao.com/v1/api/talk/friends?limit=100

Header:
Authorization: Bearer {access_token}

응답 예시:
{
“elements”: [
{
“profile_nickname”: “…”,
“profile_thumbnail_image”: “…”,
“allowed_msg”: true,
“id”: 5046903183,
“uuid”: “…”,
“favorite”: false
}
],
“total_count”: 1,
“after_url”: null,
“favorite_count”: 0
}

확인한 사항:

  1. Access Token은 authorization code로 발급받은 실제 사용자 access_token입니다.
  2. REST API Key나 Admin Key를 사용하지 않았습니다.
  3. Kakao Developers 콘솔에서 카카오 로그인 동의항목 중 친구 목록 관련 항목을 확인했습니다.
  4. 조회되지 않는 사용자들은 실제 카카오톡 친구입니다.
  5. 조회되지 않는 사용자들도 같은 앱으로 카카오 로그인을 진행했습니다.
  6. 테스트 대상 사용자들은 앱 팀원으로 등록/초대 수락한 상태인지 확인 중입니다.
  7. Backend에서도 별도 필터링 없이 Kakao API 응답 elements를 그대로 반환하고 있습니다.
  8. limit=100으로 호출했지만 total_count가 1이고 after_url도 null입니다.

질문:

  1. 테스트/개발 단계에서 Friends API가 반환하는 친구는 “앱 팀원 + 카카오톡 친구 + 동일 앱 로그인 + 친구목록 동의” 조건을 모두 만족해야 하나요?
  2. 앱 팀원으로 등록된 사용자라도 Kakao Developers 초대 수락 또는 동의항목 동의가 누락되면 total_count에서 제외되나요?
  3. Friends API에서 조회 가능한 친구 수가 1명으로 제한되어 보일 수 있는 콘솔 설정이나 권한 상태가 따로 있나요?
  4. 비즈앱 전환 또는 별도 권한 심사가 완료되지 않은 상태에서는 친구 목록 조회 대상에 제한이 있나요?
  5. allowed_msg가 true인 친구만 반환되는 것인지, 아니면 친구 목록 조회 대상과 메시지 발송 가능 대상은 별도 조건인지 궁금합니다.

확인 부탁드립니다.

친구 정보 제공 조건
1. 친구가 앱과 연결된 상태일 것
2. 친구가 앱 연결 시 [카카오 서비스 내 친구 목록 제공] 동의 항목에 동의한 상태일 것
3. 친구가 숨김 또는 차단 친구가 아닐 것
4. 친구의 프로필 공개 설정이 공개 상태일 것
5. (친구 API 사용 권한이 없는 경우) 앱의 팀원일 것
메시지 발송자는 아래 조건 추가 필요
1. 발송자는 [카카오톡 메시지 전송] 동의 항목 동의한 상태일 것

안녕하세요.
친구 목록은 위 조건을 모두 만족해야만 제공됩니다.
앱과 연결된 이용자가 친구 목록에 표시되려면 추가 권한 신청을 통해 권한을 획득 해야만 하기에
현재 회원님을 제외한 앱의 팀원은 1명인 상태에서 1명만 표시되는 것이 정상적인 상황인점 참고 부탁드립니다.