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

• 카카오톡 메시지 이해하기

모든 사용자에게 제공하는 메시지 발송 기능의 종류는 메시지 발송 기능 안내에서 확인할 수 있습니다. 인하우스 앱은 카카오톡 채널로 메시지를 발송하는 카카오톡 채널 메시지 기능을 추가로 사용할 수 있습니다.

• 기능 소개

인하우스 또는 공동체 서비스의 앱은 카카오톡 메시지 API 사용 시, 권한 목록의 추가 기능과 API를 권한 획득 후 사용할 수 있습니다. 인하우스 앱은 권한이 없어도 멤버가 아닌 사용자간 메시지 발송 기능을 사용할 수 있습니다.

인하우스 앱을 제외한 서비스에 카카오톡 메시지 API로 친구에게 메시지 발송 기능을 적용하려면 추가 기능을 신청해 사용 권한을 얻어야 합니다. 사용 권한이 없는 앱과 그 앱의 테스트 앱에서는 앱의 멤버에게만 메시지를 보낼 수 있습니다.

아래 절차에 따라 사용 권한을 신청할 수 있습니다.

1. 메시지 발송 기능의 종류에서 카카오 제공 메시지 발송 기능 중, 카카오톡 메시지 기능의 필요 여부를 확인합니다.
2. 앱 관리 페이지의 [카카오 로그인] > [동의항목]에서 아래 두 가지 동의항목을 설정합니다.
   • [개인정보] > [카카오 서비스 내 친구목록(프로필사진, 닉네임, 즐겨찾기 포함)]
   • [접근권한] > [카카오톡 메시지 전송]
3. 사용하려는 플랫폼별 개발 문서를 참고해 메시지 발송 기능을 구현합니다. 구현 시, 카카오톡 메시지 발송 흐름을 참고합니다.
4. 앱 멤버를 대상으로 기능 동작 여부를 확인합니다. 인하우스 앱은 권한이 없어도 멤버가 아닌 사용자간 메시지 발송 기능을 사용할 수 있습니다.
5. 인하우스 앱이 아닌 경우, 앱 멤버 이외의 사용자를 조회하고 메시지를 보내기 위해 필요한 사용 권한을 [앱] > [추가 기능 신청] > [카카오톡 친구/메시지] 항목에서 사용 권한을 신청해야 합니다. 추가 기능 신청 전 아래 작업을 완료해야 하며, 신청 시 추가 기능 신청 정보를 입력해야 합니다. 심사 결과는 앱 멤버들의 이메일로 발송됩니다.
   • 비즈 앱 전환
   • 신청 자격 확인
   • 비즈니스 정보 심사

• 카카오톡 메시지 발송 흐름

• 메시지 발송 기능 안내

• 카카오톡 공유와 카카오톡 메시지의 기능 차이

• 메시지 템플릿

인하우스 또는 공동체 서비스의 앱은 메시지 템플릿 도구에서 일반 앱보다 많은 설정을 제공합니다. 자세한 내용은 메시지 템플릿 도구를 참고합니다.

• 이용 정책
  • 스크랩 허용을 위한 방화벽 설정

• 쿼터

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

• 프로필 공개 설정

초대 프로필 공개 상태 조회 API 또는 프로필 공개 상태 조회 API로 수신자의 프로필 공개 설정을 미리 확인할 수 있습니다. 프로필을 비공개로 설정한 수신자에게 카카오톡 메시지 API로 메시지 발송 시, -530 에러 코드가 반환되고 메시지가 전송되지 않습니다.

서비스 설정 메뉴에서 프로필 공개 설정을 할 수 있도록, 프로필 공개 설정 페이지를 호출하는 기능을 제공합니다. 해당 기능을 사용하려면 [서비스] API플랫폼 아지트로 문의합니다. 구현 예시는 아래 이미지를 참고합니다.

해당 기능 사용 시, 프로필 공개 상태 조회 API를 함께 사용하면 사용자의 현재 프로필 공개 설정 상태를 확인해 서비스 UI에 반영할 수 있습니다.

메시지 템플릿 도구로 생성한 사용자 정의 템플릿의 경우, 아래 조건을 모두 만족하는 경우에만 프로필 공개 설정 버튼이 노출됩니다.

• [사용 목적]이 [가입여부 무관]으로 설정되지 않은 경우
• 수신 설정 화면에서 [이 서비스의 친구 목록에 나를 보여주기]가 선택된 경우

각 API의 Kakao SDK 지원 여부는 지원 범위에서 확인할 수 있습니다.