이 문서는 카카오 또는 공동체 서비스용 카카오 소셜 API를 소개합니다. 공통 설명은 오픈 문서를 참고합니다.

• 카카오톡 소셜 이해하기

인하우스 또는 공동체 서비스의 앱은 카카오 소셜 API 사용 시, 권한을 획득한 카카오 소셜 목록의 추가 기능을 사용할 수 있습니다.

인하우스와 공동체 서비스의 앱은 확장된 피커 기능을 사용할 수 있습니다. 공동체 앱은 일부 기능을 사용하려면 권한이 필요합니다. 자세한 내용은 공동체 앱 추가 권한 신청을 참고합니다.

피커 사용 방법은 아래 과정을 참고합니다.

1. 앱 관리 페이지의 [카카오 로그인] > [동의항목]에서 아래 동의항목을 설정합니다. (참고: 동의항목)
   • 친구 피커: [카카오 서비스내 친구목록(즐겨찾기, 프로필사진, 닉네임 포함)]
   • 채팅방 피커: [카카오톡 챗방 목록]
2. 개발 문서를 참고해 소셜 기능 구현합니다.
3. 앱의 멤버를 대상으로 테스트합니다.

공동체 앱에서 아래의 기능이 필요한 경우, [서비스] API플랫폼 아지트에서 추가 권한 신청이 필요합니다. 인하우스 앱은 해당 권한을 보유하고 있어 권한 신청이 불필요합니다.

• 채팅방 피커를 사용하고 싶은 경우
• 선택 가능한 대상 제한이 필요한 경우
• 카카오 정책 및 관련 규제에 따라 [카카오 서비스내 친구목록(즐겨찾기, 프로필사진, 닉네임 포함)]에 동의하지 않은 사용자의 정보를 제공받는 경우, 아래 표 참조

• 카카오톡 친구 정보 요청 방식

피커는 사용자가 선택한 카카오톡 소셜 정보를 사용할 수 있는 사용자 인터페이스입니다.

피커를 사용해 한 번의 Kakao SDK 함수 또는 메서드 호출만으로도 서비스에 필요한 친구 및 채팅방 목록 UI를 표시하고 사용자가 선택한 친구, 채팅방, 채팅방 멤버의 정보를 제공받아 간편하게 활용할 수 있습니다.

피커는 친구 피커 또는 채팅방 피커를 단독으로 사용하거나, 하나의 화면에서 탭 형태로 전환하는 탭 피커로 사용할 수 있습니다. 아래 종류별 특징을 참고합니다.

* 사용자 정보의 경우, 각 사용자의 필요한 동의항목 동의 여부에 따라 응답 데이터 구성이 다를 수 있음

친구 피커는 사용자의 친구 목록 UI를 출력하고, 사용자가 선택한 친구의 정보를 제공합니다. 한 명의 친구만 선택 가능한 싱글 피커, 여러 명의 친구를 선택 가능한 멀티 피커 두 종류로 나뉩니다.

채팅방 피커는 사용자의 카카오톡 채팅 목록을 출력하고, 선택한 채팅방의 정보를 제공합니다. 채팅방 피커 호출 시 파라미터를 지정해 사용자가 선택한 채팅방 멤버의 정보를 제공하는 채팅방 멤버 피커도 사용할 수 있습니다.

탭 피커는 탭 구조로 친구 피커와 채팅방 피커를 함께 제공합니다. [친구] 탭에서는 친구 피커를, [채팅] 탭에서는 채팅방 피커를 각각 제공합니다.

피커는 서비스에 맞게 다양한 형태로 구현할 수 있습니다. 친구 피커 커스텀 요소를 참고합니다.

이 외에 카카오와 공동체는 피커에 필터링 기능을 적용할 수 있습니다. 선택 가능한 대상을 제한을 참고합니다.

피커 호출 시 파라미터 설정에 따라 친구 목록이나 채팅방 목록에서 선택 가능한 대상을 제한할 수 있습니다.

아래 필터링 파라미터 설정에 따라 친구 목록과 채팅방 목록에서 보여지는 대상이 다릅니다. 친구나 채팅방 목록에 노출되어도 disableSelectOptions 설정에 따라 사용자가 선택할 수 없도록 할 수 있습니다.

• 친구 피커 필터링 파라미터: friendFilter, countryCodeFilters, usingOsFilter
• 채팅방 피커 필터링 파라미터: chatFilters

피커에서 필요한 동의항목에 동의하지 않은 친구나 앱과 연결되지 않는 친구의 프로필 닉네임은 마스킹 처리되어 제한된 정보로 제공됩니다. 이들의 원본 닉네임을 얻으려면 아래 조건을 만족해야 합니다.

• [미동의 사용자 프로필] 권한 필요 (참고: 피커: 추가 권한 신청)
  • 해당 권한이 없으면 profileNickname은 마스킹된 닉네임으로 제공
• displayAllProfile을 true로 설정

프로필에 적용되는 마스킹 규칙은 아래와 같습니다.

• 이용 정책
  • 프로필 공개 설정
  • 멀티프로필 노출 우선순위
  • 프로필 변경 시 기존 프로필 이미지 URL 삭제 처리

• 쿼터

카카오 소셜 API는 더 나은 사용자 경험을 위해 쿼터(Quota, 제공량 제한)가 적용됩니다. 인하우스 또는 공동체 앱의 쿼터는 쿼터에서 확인할 수 있습니다.

일부 기능은 앱에 아래 동의항목을 설정하고, 사용자에게 동의를 받아야 사용할 수 있습니다. 조회 대상 또한 응답 제공에 필요한 동의항목에 동의해야 합니다.

* 공동체 앱은 동의항목 설정 권한 필요

피커나 API로 정보를 제공받으려면 조회 대상이 아래 동의항목에 동의해야 합니다.

* 기본 정보: 회원번호, UUID, 즐겨찾기 여부

피커의 친구 목록, 카카오톡 친구 정보 조회와 친구 정보 조회 응답은 아래 조건을 만족하는 친구 정보만 포함합니다.

* 카카오계정 없이 카카오톡을 사용하거나, 카카오계정이 제재 또는 휴면 상태인 친구의 정보는 제공하지 않음

친구 피커에 사용자의 친구가 노출되는 조건은 아래와 같습니다. 자세한 내용은 친구 정보 제공 조건을 참고합니다.

• 친구가 서비스에 가입 (앱과 연결)
• 친구가 자신의 프로필을 공개 설정 (참고: 프로필 공개 설정)
• 친구가 앱 연결 시, [카카오 서비스 내 친구 목록 제공]에 동의
  • 미동의한 친구도 제공받으려면 [미동의 친구 목록] 응답 권한 필요
• 친구가 미동의 시, 제한된 정보 제공
  • 마스킹 없는 원본 정보를 받으려면 [미동의 사용자 프로필] 응답 권한 필요

카카오 정책 및 관련 규제에 따라, 친구의 동의 여부에 따라 정보 제공 범위가 다릅니다. 사용자의 친구가 [카카오 서비스 내 친구 목록 제공]에 동의하지 않으면 아래와 같이 제한된 정보를 제공합니다. 마스킹 없이 원본 닉네임을 얻으려면 피커: 추가 권한 신청을 참고합니다.

카카오톡 친구 목록 조회, 인하우스 앱: 카카오톡 친구 목록 조회 요청 시 친구 정렬 순서는 즐겨찾기순, 닉네임순으로 지정할 수 있습니다. 기본값은 즐겨찾기순입니다.

• 즐겨찾기순
  • 오름차순일 때 즐겨찾기 친구를 상위 정렬
  • 내림차순일 때 즐겨찾기 친구를 하위 정렬
• 닉네임순
  • 사용자 기기의 언어(Language)에 따라 상세 정렬 순서 적용
  • 국문: 오름차순일 때 한글, 특수문자, 숫자, 영어, 일본어, 이모지 순서로 정렬
  • 영문: 오름차순일 때 특수문자, 숫자, 영어, 일본어, 한글, 이모지 순서로 정렬

카카오 리치보드게임 앱의 경우, 아래와 같은 나이 기준 정렬이 적용됩니다.

• 오름차순일 때 성인인 친구를 상위 정렬
• 내림차순일 때 성인인 친구를 하위 정렬
• 미성년자는 대상에서 제외

카카오톡 친구 목록 조회, 인하우스 앱: 카카오톡 친구 목록 조회는 응답 캐시를 적용합니다. 캐시 시간 동안에는 친구 정보가 변경되더라도 이전 요청과 동일한 친구 목록으로 구성된 응답을 받습니다. 캐시 시간이 경과한 후 다시 요청해야 변경된 친구 목록을 받을 수 있습니다. 페이즈별 캐시 시간은 아래와 같습니다.

* 친구의 서비스 가입 여부에 따라 값이 없을 수 있음

사용자의 앱 연결 상태에 따른 호출 제한, SDK 지원 여부, 권한 요구 사항은 지원 범위를 참고합니다.