페이지 이동경로
  • 문서>
  • 카카오톡 소셜>
  • 이해하기

카카오톡 소셜

이해하기

이 문서는 카카오톡 소셜 API를 소개합니다.

기능 소개

카카오톡 소셜 API는 서비스에서 카카오톡 소셜 기능을 구현할 수 있도록 카카오톡 친구 데이터를 제공합니다. 이 API는 서비스에서 다양하게 활용할 수 있도록 카카오톡 친구의 기본 정보와 프로필을 담은 데이터를 목록 형태로 제공합니다.

사용자의 카카오톡 프로필 정보를 제공하는 카카오톡 프로필 API도 제공합니다. 서비스에서 카카오톡 프로필을 지정하여 요청하고 싶은 경우 카카오톡 프로필 가져오기 API를 사용할 수 있습니다. 카카오 로그인의 사용자 정보 가져오기 API를 사용하면 카카오계정의 프로필 정보를 받을 수 있으나, 카카오계정 프로필은 카카오톡 프로필과 일치하지 않을 수 있습니다. 사용자가 카카오톡 또는 카카오계정 관리 페이지의 [설정] > [개인/보안] > [카카오계정] > [내정보 관리] > [프로필 업데이트 설정] 메뉴에서 '프로필 정보를 항상 최신으로 유지합니다' 옵션을 켠 경우, 카카오계정 프로필 정보는 카카오톡 프로필 정보와 동일하게 유지됩니다.

이 API는 서비스의 소셜 기능 강화를 위해 활용할 수 있습니다. 사용자 프로필과 친구 데이터를 서비스 UI에 맞게 출력하여 기본적인 카카오톡 친구 목록을 보여줄 수도 있고, 서비스 회원 정보와 결합하여 사용자 활동을 친구끼리 공유하는 등 더욱 강력한 소셜 기능을 구현할 수도 있습니다.

카카오톡 소셜 API는 카카오톡 메시지 API와 함께 사용하여 카카오톡 친구에게 메시지를 보내는 기능을 구현할 때도 필요한 기능입니다. 친구 목록 가져오기 API로 받은 친구 정보를 토대로 메시지 API를 사용하여 카카오톡 메시지를 보낼 수 있습니다.

카카오톡 친구 정보를 활용한 서비스 UI 예시

이용 정책

친구 정보 제공 조건

친구 목록 가져오기 API는 사용자의 모든 카카오톡 친구 정보를 제공하지 않을 수도 있습니다. 실제 카카오톡 친구 수와 API 응답의 친구 수는 다를 수 있습니다.

먼저, 친구 목록 가져오기 API는 사용 권한이 주어진 앱에서만 사용할 수 있습니다. 사용 권한 신청을 참고해 권한을 신청합니다. 권한을 받기 전에는 팀원에 한해 사용 가능합니다.

친구 정보 제공 조건은 ➊친구인 사용자가 앱과 연결된 상태일 것, ➋사용자와 친구 모두 앱 연결 시 '카카오 서비스 내 친구 목록 제공' 동의 항목에 동의한 상태일 것, ➌숨김 또는 차단 친구가 아닐 것 세 가지입니다. 조건을 모두 만족하는 친구만 친구 목록 가져오기 API 응답에 포함됩니다. 특정 친구가 응답에 포함되지 않을 경우, 자세한 유형은 FAQ를 참고합니다.

이러한 조건과 관계없이 사용자의 모든 카카오톡 친구 정보를 요청하는 오픈 API는 제공되지 않습니다. 카카오톡 친구 정보 또한 사용자 정보로써, 사용자 본인과 각 친구의 제3자 정보 제공 동의가 필요하기 때문입니다. 이로 인해 친구 목록 가져오기 API는 모든 카카오톡 친구 정보가 아닌 앱 사용자인 카카오톡 친구만으로 정보 제공 대상이 제한됩니다.

또한, 친구 목록 가져오기 API는 10분의 응답 캐시가 있습니다. 한 번 친구 목록 가져오기 API를 요청하면, 캐시 시간인 10분 동안에는 친구 정보가 변경되더라도 이전 요청과 동일한 친구 목록으로 구성된 응답을 받습니다. 10분이 경과한 후 다시 친구 목록 가져오기 API를 요청해야 변경된 친구 목록을 받을 수 있습니다.

주의

친구 목록 가져오기 API를 제공 취지와 다른 용도로 사용하는 것은 허용되지 않습니다. 대표적으로 다음과 같은 예를 들 수 있습니다: - 사용자들의 친구 관계를 다른 사용자에게 제공할 수 없습니다. - 친구 정보를 따로 저장할 수 없습니다. - 친구들의 관계 정보를 분석/조합해 제공할 수 없습니다.

프로필 정보 제공 기준

친구 목록 가져오기 API의 응답은 멀티프로필의 영향을 받습니다. 멀티프로필은 카카오톡 사용자가 친구마다 다른 프로필을 보여주도록 설정하는 기능입니다.

카카오톡 프로필 정보는 닉네임(nickName), 프로필 이미지 URL(profileImageUrl), 카카오톡 프로필 썸네일 이미지 URL(thumbnailUrl)로 구성되어 있으며, 이 중 닉네임과 프로필 이미지는 다음과 같은 우선순위에 따라 친구 목록 가져오기 응답에 제공됩니다:

  • 닉네임: 사용자가 설정한 친구 이름 > 사용자 주소록의 친구 이름 > 친구가 사용자에게 보이도록 설정한 멀티프로필 닉네임 > 친구가 설정한 기본 프로필 닉네임
  • 프로필 이미지 URL: 친구가 사용자에게 보이도록 설정한 멀티프로필 이미지의 URL > 친구가 설정한 기본 프로필 이미지의 URL

사용자 자신의 프로필 정보를 요청하는 프로필 가져오기 API는 항상 사용자가 설정한 기본 프로필 정보를 사용하므로, 멀티프로필의 영향을 받지 않습니다.

카카오톡 메시지 보내기

친구 목록 가져오기 API를 통해 받은 카카오톡 친구 정보를 토대로 카카오톡 메시지를 보낼 수 있습니다. 자세한 내용은 메시지 가이드를 참고합니다.

지원 범위

Service API Android SDK iOS SDK JavaScript SDK REST API
카카오톡 프로필 가져오기
카카오톡 친구 목록 가져오기