페이지 이동경로
  • 문서>
  • 앱 설정>

앱 설정

이 문서는 카카오디벨로퍼스 앱 사용 시 필요한 설정에 대해 안내합니다.

앱은 서비스 정보가 등록된 카카오디벨로퍼스 프로젝트입니다. 서비스는 앱을 설정해서 카카오디벨로퍼스가 제공하는 다양한 기능을 사용할 수 있고, 앱 키로 카카오 API를 호출할 수 있습니다.

일반

앱 기본 정보

앱 관리 페이지의 [앱] > [일반] > [앱 기본 정보]에서, 앱 생성 시 등록한 카카오 API를 사용하려는 서비스의 기본 정보를 확인하고 수정할 수 있습니다.

앱 기본 정보

🅐 앱 아이콘: 서비스 로고 또는 앱 아이콘, 250KB 미만인 파일만 등록 가능, 128*128 이하 크기 권장 🅑 앱 이름(필수): 서비스 이름 🅒 회사명(필수): 서비스의 상호, 법인 또는 단체명 🅓 카테고리(필수): 서비스의 카테고리

기본 정보의 활용

앱에 등록한 기본 정보는 사용자에게 노출되므로, 실제 서비스와 동일하게 입력해야 합니다. 아래 이미지와 같이 카카오 로그인 동의 화면, 연결된 서비스 관리, 카카오톡 메시지 하단의 출처 등에 표시됩니다.

앱 기본 정보 노출 위치
앱 분류

카카오디벨로퍼스 앱은 가진 권한에 따라 아래와 같이 구분됩니다. 동시에 여러 권한을 가질 수 있습니다. 권한별 획득 방법은 각 항목의 내용을 참고합니다.

앱 관리

앱은 서비스별로 한 개여야 합니다. 기존에 카카오 로그인, 카카오톡 공유 등을 이용하고 있어 앱이 이미 등록돼 있는 경우, 새로운 앱을 등록하지 않고 기존 앱을 사용합니다. 관리자 계정을 분실해 기존 앱을 사용할 수 없는 경우, 데브톡에서 앱 소유자 변경을 요청합니다.

참고

카카오 로그인을 사용 중인 서비스가 새로운 앱을 만들어 사용하면 사용자들이 모두 새로 가입해야 합니다. 이 경우 동일 사용자에 대해 두 개 이상의 서비스 회원 정보가 등록되어 문제가 발생할 수 있습니다.

앱 ID

앱 생성 시, 앱을 식별할 수 있는 고유한 ID가 부여됩니다. 앱 ID는 앱 관리 페이지 또는 도구 페이지 상단의 앱 정보 영역에서 확인할 수 있습니다. 데브톡 문의 시 앱 ID를 함께 기재하면 더 빠르게 확인할 수 있습니다.

앱 ID

비즈니스 정보

앱 관리 페이지의 [앱] > [일반] > [비즈니스 정보]에 서비스의 비즈니스 정보를 등록해 비즈 앱으로 전환할 수 있습니다.

비즈 앱

비즈 앱은 비즈니스 정보를 등록한 앱으로, 아래의 추가 기능을 제공합니다.

비즈 앱 전환

[앱] > [일반] > [비즈니스 정보]에서 [사업자 정보 등록]을 선택해 사업자등록번호를 입력합니다. 앱의 Owner만 비즈 앱 전환이 가능합니다. 사업자등록번호가 없는 개인 개발자는 개인 개발자 비즈 앱 전환을 참고합니다.

앱 비즈니스 정보 화면의 사업자 정보 등록 버튼
개인 개발자 비즈 앱 전환

사업자등록번호가 없는 개인이나 단체가 제공하는 서비스의 앱도 아래 조건 만족 시 [앱] > [일반] > [비즈니스 정보] > [개인 개발자 비즈 앱]에서 비즈 앱 전환이 가능합니다.

개인 개발자 비즈 앱은 사업자 정보가 없어 비즈니스 채널을 연결할 수 없습니다. 개인 개발자 비즈 앱에서 비즈채널을 연결하려면 [앱] > [비즈니스 정보]에서 사업자 정보를 등록해 먼저 비즈 앱으로 전환해야 합니다.

해외 사업자 비즈 앱 전환

비즈 앱은 사업자등록번호를 등록하거나 전화번호 본인인증을 완료한 경우에만 전환이 가능합니다.

만약 국내 사업자등록번호가 없거나, 해외에서 전화번호 인증이 불가능하다면 데브톡 메시지로 아래 정보를 담당자에게 전달합니다. 담당자가 내용 확인 후 비즈 앱으로 전환 예정입니다.

  • 해외 사업자를 인증할 수 있는 라이센스
  • 신청자 카카오계정
  • 앱 아이디
  • 앱 이름
  • 사용하려는 카카오 API 혹은 카카오디벨로퍼스 기능

앱 키

앱 키(App key)는 카카오 API를 사용하기 위해 플랫폼별로 발급되는 고유한 식별 키입니다. 앱 관리 페이지의 [앱] > [일반] > [앱 키]에서 확인할 수 있습니다.

앱 키 조회 화면

앱 키는 플랫폼별로 각각 발급됩니다. 플랫폼에 맞지 않는 앱 키를 사용하면 에러 응답을 반환합니다.

  • 네이티브 앱 키: Kakao SDK for Android 초기화, Kakao SDK for iOS 초기화 시 사용
  • REST API 키: REST API 요청 시 HTTP 헤더(Header)에 전달
  • JavaScript 키: Kakao SDK for JavaScript 초기화 시 사용
  • 어드민 키: 일부 관리자 기능에 사용, 모든 권한을 갖고 있는 키이므로 유출되지 않도록 주의
재발급

앱 키가 노출되었을 경우, 앱 Owner가 앱 키를 재발급할 수 있습니다. 한 번 키가 재발급되면 이전으로 되돌릴 수 없음에 주의합니다. 앱 키 재발급 시, 서비스 앱이나 웹사이트에 적용된 앱 키를 재발급된 값으로 변경해야 합니다.

참고: 어드민 키

어드민 키(Admin Key)는 고정된 키 값을 사용해 API 접근을 허용하는 방식으로 절대로 유출되어서는 안 되는 중요 정보입니다. 정보 보안을 위해 어드민 키는 서버에서 호출할 때만 사용하고, 소스 코드에 포함하지 않도록 주의합니다.

플랫폼

카카오 API는 카카오디벨로퍼스에 플랫폼 정보를 등록한 서비스만 사용 가능합니다. 앱 관리 페이지의 [앱] > [일반] > [플랫폼]에서 서비스의 각 플랫폼 정보를 등록할 수 있습니다.

참고: 잘못된 플랫폼 정보로 인한 에러

앱에 등록된 플랫폼 정보가 실제 서비스와 다르면 invalid android_key_hash or ios_bundle_id or web_site_url 에러가 발생합니다. 아래는 해당 에러 발생 시 플랫폼별로 확인해야 할 사항입니다.

  • Android: 등록한 패키지명이 AndroidManifest.xml 파일의 package 속성 값과 동일한지, 키 해시 값이 등록되어 있는지 확인
  • iOS: 등록한 번들 ID가 Xcode 프로젝트 파일에 설정된 Bundle Identifier ID 값와 동일한지 확인, 번들 ID는 Xcode의 [TARGETS] > [General] > [Identify]에서 확인 가능
  • Web: 카카오 API 호출 시 사용한 사이트 도메인을 등록했는지 확인
참고: 마켓 URL

[플랫폼]에 등록된 오픈마켓 URL입니다. 카카오톡 공유나 카카오톡 메시지 API로 전송된 메시지는 서비스 앱 실행이 가능한 링크를 제공합니다. 서비스 앱 실행 시 사용자 기기에 해당 앱이 설치되어 있지 않을 경우, 등록된 마켓 URL로 이동합니다.

Android

🅐 패키지명(Package Name)

  • Android 앱의 고유한 이름
  • AndroidManifest.xml 파일의 package 속성 값 입력

🅑 마켓 URL(Market URL)

  • [구글 플레이] 선택 시 패키지명 기반으로 마켓 URL 자동 입력
  • [직접 입력] 선택 시 전체 마켓 URL 값 입력, 구글 플레이 스토어 외에 원스토어 등의 마켓 URL도 입력 가능

🅒 키 해시(Key hash)

  • 개발 및 서비스 릴리즈 빌드를 위해 필요한 키 해시 값, 카카오 API 요청 시 유효성 검증에 사용
  • 키 해시를 참고해 개발 환경별로 등록

iOS

Android 플랫폼 등록 화면

🅐 번들 ID(Bundle ID)

  • iOS 앱별 고유 값
  • Xcode의 프로젝트 정보에 설정된 [Bundle Identifier] 값 입력

🅑 앱스토어 ID(Appstore ID) 및 마켓 URL(Market URL)

  • 앱스토어 등록 시 발급받은 앱 ID를 등록
  • 마켓 URL은 앱 ID에 따라 자동 입력

Web

도메인 등록 화면

🅐 사이트 도메인

  • Kakao SDK for JavaScript, 카카오톡 공유, 카카오톡 메시지 API 사용 시 필요
  • http://, https://, file:// 형식의 도메인 등록
  • httphttps 도메인은 둘 중 한 가지만 등록해도 사용 가능
  • 최대 10개의 도메인 등록 가능

🅑 기본 도메인

  • 하나 이상의 도메인 등록 시, 맨 윗줄에 등록된 도메인을 기본 도메인으로 설정
  • 기본 도메인은 카카오톡 공유, 카카오톡 메시지 API로 발송하는 메시지의 링크 중 [Web] 기본값으로 사용
참고: 와일드카드 서브 도메인

비즈 앱은 서브 도메인과 리다이렉트 URI(카카오 로그인, 비즈니스 인증)에 와일드카드 문자를 포함한 URI를 등록할 수 있습니다. 와일드카드 문자를 포함한 서브 도메인 사용 시, 아래 규칙을 준수해야 합니다.

  • 와일드카드 문자를 포함한 도메인은 기본 도메인이 될 수 없음
  • 와일드카드 문자를 포함한 도메인만 등록돼 있을 경우, 일부 기능이 정상 동작하지 않을 수 있음
  • 각 서브 도메인은 반드시 고유한 도메인명(Domain name) 또는 호스트명(Host name)을 포함해야 함
    • https://*.sample.com (O)
    • https://*.com (X)
  • 서브 도메인은 중간에 와일드카드 문자를 포함할 수 없음
    • https://*.sample.com (O)
    • https://sub.*.sample.com (X)
  • 서브 도메인은 두 개 이상의 와일드카드 문자를 포함할 수 없음
    • https://*.sample.com (O)
    • https://*.*.sample.com (X)

테스트 앱

테스트 앱은 실제 서비스에 사용 중인 앱에 영향을 미치지 않고 신규 기능이나 업데이트를 개발할 때 사용합니다. 원본 앱이 가진 권한과 테스트 앱용으로 기본 제공하는 권한을 검수 신청 전에 함께 활용할 수 있습니다. 실제 서비스 적용 시에는 테스트 앱이 아닌 원본 앱의 앱 키를 사용해야 합니다. 아래는 테스트 앱이 제공하는 주요 기능입니다.

  • 테스트 앱에 기본으로 부여되는 테스트 앱용 추가 기능을 제공받아, 원본 앱의 권한 검수 신청 전 기능 체험 가능
  • 원본 앱 설정과 다른 독립된 테스트 앱 설정값 사용 가능
  • 원본 앱에 추가 또는 삭제된 권한 자동 반영(예: 카카오 비즈니스 개인정보 검수 또는 카카오톡 소셜, 메시지와 같이 별도 권한이 필요한 API에 대한 검수 후 권한 부여 시)
제한 사항

아래는 테스트 앱 사용 시 고려해야 할 제한 사항입니다.

  • 생성 및 삭제
    • 앱에 비즈니스 정보를 등록한 비즈 앱만 생성 가능
    • 앱의 오너와 에디터만 생성 가능
    • 한 원본 앱당 최대 5개까지 생성 가능
    • 테스트 앱이 존재하는 원본 앱 삭제 불가능
  • 멤버 관리
    • 최초 생성 시 테스트 앱의 오너(Owner)멤버는 원본 앱과 동일
      • 원본 앱의 오너(Owner) 변경 시 테스트 앱도 함께 변경되며, 테스트 앱의 오너만 별도 변경 불가능
      • 오너를 제외한 테스트 앱의 멤버는 원본 앱과 상관없이 추가 또는 삭제 가능
    • 별도 최대 멤버 수 제한 적용
  • 기능 사용
주의

테스트 앱이 실제 서비스에 적용되지 않도록 주의합니다. 테스트 앱은 테스트 목적으로만 제공하는 기능으로 제한된 쿼터가 적용되며, 테스트 이외의 목적으로 사용 시 제재됩니다.

테스트 앱용 추가 기능

테스트 앱에 기본 제공하는 추가 기능 목록입니다. 테스트 앱용으로 제공하는 추가 기능을 원본 앱에서 사용하려면, 별도 검수 신청 후 권한을 획득해야 합니다.

  • 앱의 기본 기능 및 권한

  • 비즈 앱용 추가 기능 및 권한

  • 개인정보 동의항목의 사용자 정보 제공 동의 단계(필수 또는 선택 동의 권한 추가 제공)

    • 카카오계정(이메일) (account_email): 필수 동의
    • 이름 (name): 선택 동의, 필수 동의
    • 성별 (gender): 필수 동의
    • 연령대 (age_range) 필수 동의
    • 생일 (birthday): 필수 동의
    • 출생년도 (birthyear): 선택 동의, 필수 동의
    • 카카오계정(전화번호) (phone_number): 선택 동의, 필수 동의
    • 배송지정보(수령인명, 배송지 주소, 전화번호) (shipping_address): 선택 동의, 필수 동의
  • 카카오 로그인: 간편가입

  • 카카오 로그인: 배송지 조회

생성 방법

[앱] > [일반] > [테스트 앱]에서 🅐 [테스트 앱 생성]을 선택해 테스트 앱을 생성할 수 있습니다.

테스트 앱을 생성하면 원본 앱과 다른 별도의 앱 키, 독립된 설정값, 테스트 앱용 권한을 사용할 수 있습니다. 원본 앱의 오너가 아니더라도, 테스트 앱을 생성한 계정이 테스트 앱의 오너가 됩니다. 테스트 앱의 오너는 [테스트 앱] 항목에서 생성한 🅑 테스트 앱의 이름을 선택해 테스트 앱 설정 화면으로 이동할 수 있습니다.

생성한 테스트 앱 선택

앱 삭제

앱이 더 이상 필요하지 않거나 다른 플랫폼에서 카카오디벨로퍼스 앱 삭제를 안내받은 경우, 아래와 같이 앱을 삭제할 수 있습니다.

  1. [앱]에서 삭제하려는 앱을 선택합니다.
  2. [앱] > [일반] > [앱 삭제] 항목에서 [앱 영구 삭제]를 선택합니다.
  3. 삭제할 앱 이름을 입력한 후 [삭제]를 선택합니다.
주의

앱 삭제 시 앱 사용자는 연동한 기능(카카오 로그인, 카카오톡 공유 등)을 더 이상 이용할 수 없으며, 삭제한 앱은 복구할 수 없습니다.

참고: 앱 삭제 불가능 조건

아래의 경우 앱을 삭제할 수 없습니다. Q. 왜 앱을 삭제할 수 없나요?를 함께 참고합니다.

  • 앱의 오너(Owner)가 아닌 경우
  • 앱과 연결된 카카오톡 채널이 있는 경우
  • 테스트 앱을 사용 중인 경우
  • 연결된 비즈월렛이 있는 경우
  • 전자상거래 플랫폼에서 카카오싱크를 연동해 사용 중인 경우

카카오톡 채널

앱 관리 페이지의 [앱] > [카카오톡 채널]에서 카카오디벨로퍼스 앱에 서비스의 카카오톡 채널을 연결해 마케팅에 활용할 수 있습니다. 앱과 카카오톡 채널의 연결 방법은 앱에 카카오톡 채널 연결을 참고합니다.

카카오톡 채널 연결 관리 화면

🅐 연결된 카카오톡 채널 🅑 대표 채널 🅒 고객 관리 API 정책 동의

연결된 카카오톡 채널

앱에 연결된 카카오톡 채널 목록을 확인하고 관리할 수 있습니다.

[카카오톡 채널 관리]를 누르면 추가 기능 신청 페이지로 이동합니다. 앱과 카카오톡 채널을 연결하려면 [카카오톡 채널 연결] 열의 [신청]을 눌러 연결을 요청할 수 있습니다. 연결을 해제하려면 [연결 관리] 항목에서 [연결 해제]를 선택합니다.

참고: 쇼핑몰 카카오톡 채널 연결 해제

쇼핑몰 호스팅 서비스(Hosting Service)로 카카오싱크를 이용 중인 경우, 이 기능으로 채널 연결을 해제할 수 없습니다. 카카오싱크 간편설정 팝업을 지원하는 호스팅사를 참고해 호스팅사의 관리자 설정을 변경해야 합니다.

대표 채널

대표 채널은 서비스를 대표하는 카카오톡 채널입니다. 대표 채널을 설정하면 카카오 로그인 동의 화면에 채널 추가를 위한 동의항목이 노출됩니다. 설정 방법은 대표 채널에서 확인할 수 있습니다.

고객 관리 API 정책 동의

카카오톡 채널 고객 관리 API를 사용하기 위해 필요한 정책에 동의할 수 있습니다. 아래 단계별 안내를 참고합니다.

  1. 앱에 카카오톡 채널 연결을 완료합니다.
  2. 앱 관리 페이지의 [앱] > [카카오톡 채널] > [고객 관리 API 정책 동의]에서 [동의]를 선택하면 안내 창이 열립니다. 정책 동의는 앱의 오너(Owner) 계정만 할 수 있습니다.
  3. 안내 창의 사용자 개인정보 보호 및 관리 책임에 대해 확인 후, 내용에 동의하는 경우 [저장]을 선택합니다.
  4. 개발 문서를 참고해 API를 호출합니다. 카카오톡 채널 고객 관리 API에 대한 자세한 내용은 카카오톡 채널 고객 관리에서 확인할 수 있습니다.

추가 기능 신청

앱의 추가 기능을 사용하기 위한 심사를 요청합니다. 신청 가능한 추가 기능 목록은 추가 기능 신청 대상에서 확인할 수 있습니다.

앱 관리 페이지의 [앱] > [추가 기능 신청]에서 심사를 요청합니다. 추가 기능 신청 전 신청 자격 확인을 완료해야 합니다. 아래 항목별 안내를 참고합니다.

카카오톡 채널 목록 확인 및 연결 해제 관련 내용은 카카오톡 채널을 참고합니다.

추가 기능 신청 화면

🅐 신청 자격 확인 🅑 비즈니스 정보 🅒 추가 기능

신청 자격 확인

앱과 계정의 추가 기능 신청 자격을 확인합니다.

신청 자격 확인 화면
  1. 신청 자격 확인 조건만족하지 못한 경우, 🅐 신청 자격 확인에 관련 안내가 표시됩니다. 해당 안내에 따라 앱 또는 계정을 설정해야 합니다.
  2. 신청 자격 확인 조건을 만족한 경우, 🅐 신청 자격 확인에 [신청 자격 확인] 버튼이 표시됩니다. 해당 버튼을 선택하면 신청 자격 확인 및 동의 요청 창이 열립니다.
  3. 세부 내용을 확인하고 동의하면 신청 자격 확인이 완료됩니다.
신청 자격 확인 조건
  • 앱의 오너(Owner) 또는 에디터(Editor) 권한 보유 계정: 접속 계정에 앱의 오너 또는 에디터 권한 부여 필요
  • 본인 인증 완료: 미완료 상태인 경우 안내에 따라 본인 인증 필요
  • 비즈 앱 전환 완료: 신청 앱이 비즈 앱이 아닌 경우 안내에 따라 비즈 앱으로 전환 필요

신청 가능 대상

비즈니스 정보

앱의 비즈니스 정보 심사를 신청합니다.

  1. 비즈니스 정보 심사는 신청 자격 확인 완료 후 신청 가능합니다. 그 전엔 [신청]이 비활성화됩니다.
  2. 🅑 비즈니스 정보의 [신청]을 선택하면 [비즈니스 정보] 입력창이 열립니다.
  3. 항목별 안내와 주의 사항을 참고해 입력 정보를 채우고 제출합니다.
신청 자격 확인 화면

추가 기능

앱의 추가 기능을 사용하기 위한 심사를 요청합니다. 신청 가능한 추가 기능 목록은 추가 기능 신청 대상에서 확인할 수 있습니다.

  1. 추가 기능 심사는 신청 자격 확인 완료 후 신청할 수 있습니다. 그 전엔 🅒 추가 기능의 [신청]이 비활성화됩니다.
  2. 🅒 추가 기능의 [신청]을 선택하면 심사 요청 창이 열립니다. 만약 비즈니스 정보가 필요한 추가 기능을 미심사 상태에서 신청한 경우, 비즈니스 정보 심사 창이 먼저 열립니다. 비즈니스 정보 심사 요청 후, 추가 기능 심사를 이어서 요청할 수 있습니다.
  3. 항목별 안내와 주의 사항을 참고해 입력 항목을 채우고 제출합니다. [심사 상태] 열에서 심사 상태를 확인할 수 있으며, 요청한 심사의 승인 또는 반려 여부는 신청 계정에 등록한 이메일로도 전송됩니다.
심사 상태

추가 기능 심사 상태를 아래 문구로 표시합니다.

  • 심사 중: 심사 신청이 완료되어 담당자가 심사 중인 상태
  • 심사 승인: 요청이 승인되어 추가 기능이 부여된 상태
  • 부분 승인: 요청이 부분 승인 되어 일부 추가 기능만 사용 가능한 상태
  • 심사 반려: 요청이 승인되지 않아 추가 기능을 사용할 수 없는 상태, 미비 사항을 보완하여 재신청 필요
  • 신청 불필요: 이미 해당 추가 기능을 사용할 수 있는 권한을 보유한 상태
문의

추가 기능 신청과 관련해 궁금한 점이 있는 경우, 데브톡의 [추가 기능 신청] 게시판 또는 메시지로 문의합니다. 빠른 응답을 위해 문의 시 앱 ID를 함께 기재해 주시기 바랍니다.

웹훅

서비스 외부에서 발생한 사용자 활동이나 계정 상태 변화를 전달받기 위한 웹훅 관련 설정을 등록합니다. 관련된 자세한 내용은 웹훅에서 확인할 수 있습니다.

웹훅 테스트가 필요한 경우 [웹훅 테스트]를 선택해 간편하게 테스트할 수 있습니다. 자세한 내용은 웹훅 테스트를 확인합니다.

계정 상태 변경 웹훅

앱 관리 페이지의 [앱] > [웹훅] > [계정 상태 변경 웹훅]에서 [웹훅 등록]을 선택해 계정 상태 변경 웹훅을 설정할 수 있습니다. 아래 설명을 참고해 상세 정보를 입력합니다.

계정 상태 변경 웹훅 설정 화면

🅐 활성화 상태: 계정 상태 변경 웹훅 사용 여부 선택 🅑 웹훅 URL: 변경 이벤트 정보를 전달받을 서비스의 웹훅 URL 입력, HTTPS만 지원 🅒 변경 이벤트: 변경 이벤트 카테고리 및 타입 선택 ⓐ 카테고리: 변경 이벤트 카테고리 선택, [카카오계정 상태 변경 내역] 동의항목 설정 권한이 있는 경우에만 RISC, CAEP 노출 (참고: 동의항목 설정) ⓑ 타입: 변경 이벤트 타입 선택

상세 정보 입력 후 [저장]을 선택하면 등록한 웹훅 상세 정보가 표시됩니다. [수정]을 선택해 등록한 정보를 수정하거나, [삭제]를 선택해 삭제할 수 있습니다.

위의 설정만으로 웹훅이 동작하지 않습니다. 웹훅 요청을 처리할 수 있는 수신 서버를 함께 구현해야 합니다. 자세한 내용은 구현 절차를 참고합니다.

연결 해제 웹훅

앱 관리 페이지의 [앱] > [웹훅] > [연결 해제 웹훅]에서 [웹훅 등록]을 선택해 연결 해제 웹훅을 설정할 수 있습니다. 아래 설명을 참고해 상세 정보를 입력합니다.

연결 해제 설정 화면

[웹훅 URL]에 웹훅을 받아 처리할 사이트 도메인 주소, 메서드 및 요청 주소(Path)를 입력합니다. 웹훅 URL은 사용자 정보 보호를 위해 HTTPS만 지원하며, 443 포트(Port)만 등록 가능합니다.

상세 정보 입력 후 [저장]을 선택하면 등록한 웹훅 상세 정보가 표시됩니다. [수정]을 선택해 등록한 정보를 수정하거나, [삭제]를 선택해 삭제할 수 있습니다.

위의 설정만으로 웹훅이 동작하지 않습니다. 웹훅 요청을 처리할 수 있는 수신 서버를 함께 구현해야 합니다. 자세한 내용은 구현 절차를 참고합니다.

주의

장기간 웹훅 수신 응답이 없거나 오류 발생 빈도가 높은 경우, 카카오 API 플랫폼은 더 이상 웹훅을 전달하지 않고 연결 해제 설정의 [활성화 상태]를 [일시 중지]로 변경합니다. 앱 멤버의 메일로 발송된 안내를 참고하여 웹훅 처리가 올바르게 이뤄지는지 확인 및 조치 후, [활성화 상태]를 [사용함]으로 변경해야 다시 웹훅을 전달받을 수 있습니다.

카카오톡 공유 웹훅

앱 관리 페이지의 [앱] > [웹훅] > [카카오톡 공유 웹훅]에서 [웹훅 등록]을 선택해 카카오톡 공유 웹훅을 설정할 수 있습니다. 아래 설명을 참고해 상세 정보를 입력합니다.

카카오톡 공유 웹훅 설정 화면

[메서드]와 [웹훅 URL]에 웹훅을 받아 처리할 사이트 도메인 주소, 메서드 및 요청 주소(Path)를 입력합니다. 웹훅 URL은 사용자 정보 보호를 위해 HTTPS만 지원하며, 443 포트(Port)만 등록 가능합니다.

상세 정보 입력 후 [저장]을 선택하면 등록한 웹훅 상세 정보가 표시됩니다. [수정]을 선택해 등록한 정보를 수정하거나, [삭제]를 선택해 삭제할 수 있습니다.

위의 설정만으로 웹훅 기능이 동작하지 않습니다. 웹훅 요청을 처리할 수 있는 수신 서버를 함께 구현해야 합니다. 자세한 내용은 구현 절차를 참고합니다. 또한, 카카오톡 공유 웹훅은 사용자 정의 파라미터 설정을 완료해야 수신할 수 있습니다.

카카오톡 메시지 API 웹훅

카카오톡 메시지 API는 메시지 전송 결과를 응답으로 확인할 수 있어 별도의 웹훅 기능이 필요하지 않습니다.

카카오톡 채널 웹훅

앱 관리 페이지의 [앱] > [웹훅] > [카카오톡 채널 웹훅]에서 [웹훅 등록]을 선택해 카카오톡 채널 웹훅을 설정할 수 있습니다. 카카오톡 채널 웹훅은 앱에 카카오톡 채널 연결을 완료한 후 설정할 수 있습니다.

카카오톡 채널 웹훅 설정 화면

[웹훅 URL] 등록만으로는 웹훅 기능이 동작하지 않습니다. 웹훅 요청을 처리할 수 있는 수신 서버를 함께 구현해야 합니다. 자세한 내용은 구현 절차를 참고합니다.

웹훅을 구현하면 앱에 연결된 모든 비즈니스 카카오톡 채널을 대상으로 웹훅이 발송됩니다. 앱 관리 페이지의 [앱] > [카카오톡 채널] > [연결된 카카오톡 채널]에서 대상 카카오톡 채널을 확인할 수 있습니다.

멤버

멤버는 앱을 관리하는 구성원으로, 앱 관리 페이지의 [앱] > [멤버]에서 멤버를 관리할 수 있습니다. 멤버로 등록된 개발자 계정만 앱 정보를 조회 또는 수정할 수 있으며, 테스트 앱의 경우 멤버만 카카오 API를 호출할 수 있습니다.

멤버 역할

  • 오너(Owner)
    • 앱 소유자
    • 앱 정보 조회 및 수정, 앱 키 재발급, 앱 삭제, 추가 기능 신청 등 앱에 대한 모든 권한 보유
  • 에디터(Editor)
    • 앱 정보 조회, 수정 및 추가 기능 신청 가능
    • 앱 삭제, 멤버 초대, 앱 키 재발급 불가능
  • 메시지 에디터(Message Editor)
    • 앱 정보 조회, 메시지 템플릿 등록 및 수정 가능
  • 뷰어(Viewer)
    • 앱 정보 조회만 가능

관리 방법

팀 관리 화면

🅐 멤버 추가

  • [카카오계정(이메일)]: 초대할 개발자 계정의 이메일을 입력하고 부여할 권한 선택
    • 카카오계정 로그인 시 사용되는 이메일로만 멤버 초대 가능, 초대 시 해당 주소로 이메일 발송
    • 카카오계정은 카카오계정 페이지에서 가입 가능
  • [역할]: 초대할 개발자 계정에 부여할 멤버 역할 선택

🅑 멤버 정보 및 관리

  • 카카오계정: 멤버의 카카오계정 이메일
  • 역할: 멤버에게 부여된 역할
  • 상태: 멤버의 상태
    • 활성: 정상적으로 카카오디벨로퍼스 가입 및 멤버 등록이 완료된 사용자
    • 초대 메일 발송됨: 아직 카카오디벨로퍼스에 가입하지 않은 사용자, 초대 이메일 수신 및 가입 후 멤버으로 합류 가능
    • 휴면: 카카오계정이 휴면 상태인 사용자, 오너를 포함한 모든 멤버에게 해당 사용자의 카카오계정 이메일이 노출되지 않음, 휴면 상태인 멤버는 수정이 불가능하며 내보내기만 가능
  • 관리
    • 멤버 권한 수정 및 제외 기능 제공
    • 오너는 각 멤버에 대해 [수정]으로 역할을 수정(다른 멤버에게 오너 권한 이전 가능)하거나, [삭제]로 제외 가능
    • 멤버는 [나가기]로 자신을 멤버에서 제외 가능

앱 소유자 변경

  1. 앱 소유자인 개발자 계정으로 로그인
  2. 계정 관리 페이지의 [앱] > [멤버] > [멤버 추가]에서 새로운 앱 소유자가 될 개발자 계정을 멤버으로 추가
    • 새로운 카카오계정을 사용하려면 카카오계정 신규 가입 후 카카오디벨로퍼스 로그인 및 개발자 등록
  3. 멤버 목록에서 [수정]을 선택해 권한을 Owner로 변경

앱 소유자인 개발자 계정을 알 수 없다면 FAQ를 참고합니다.

고급

허용 IP 주소

주의

운영 중인 서비스의 경우, 카카오 API를 사용하는 기능의 동작에 영향을 미칠 수 있는 설정입니다. 아래 내용을 충분히 이해한 후 사용해야 합니다.

앱 키 유출과 같은 보안 사고에 대비해 카카오 API 서버가 등록된 IP 주소의 요청만 허용하도록 설정하는 기능입니다. 앱 관리 페이지의 [앱] > [고급] > [허용 IP 주소]에서, [IP 주소 등록]을 선택해 서비스 서버의 IP 주소를 등록할 수 있습니다. CIDR(IP/CIDR), Subnet Mask(IP/Mask) 정보로 설정하기를 권장하며, 개별 IP(IPv4, IPv6)도 등록할 수 있습니다. 줄바꿈으로 여러 개의 IP를 추가할 수 있습니다.

허용 IP 주소 설정 화면

허용 IP 주소 설정은 REST API 키 혹은 어드민 키를 사용하는 모든 카카오 API 호출에 적용됩니다. 설정 후에는 등록된 IP 주소에서만 REST API로 카카오 API를 호출할 수 있습니다. 등록되지 않은 IP 주소에서 카카오 API 요청 시 아래와 같이 에러 응답을 받습니다. 문제를 해결하려면 요청을 보낸 서비스 서버의 IP 주소를 추가 등록하거나, 허용 IP 등록 기능을 비활성화해야 합니다.

"msg": "ip mismatched! callerIp=XXX.XXX.XXX.XXX. check out registered ips.",
"code": -401

허용 IP 등록 기능을 비활성화하려면 [삭제]를 눌러 등록된 모든 IP 주소를 삭제합니다.