Kakao 앱 등록 (운영자)

## 이 등록으로 얻는 것 - **카카오 소셜 로그인** - **카카오톡 알림 발송** (비즈 채널 필요) - 카카오톡 AI 비서 연동 ## 사전 준비물 - [ ] 카카오 계정 - [ ] **비즈니스 계정 전환** — [business.kakao.com](https://business.kakao.com) (알림톡·카카오싱크를 쓰려면) - [ ] **사업자등록증** (비즈 채널 등록 시) - [ ] 서비스 도메인 ## 등록 절차 ### 1. 애플리케이션 추가 1. [Kakao Developers](https://developers.kakao.com) → **내 애플리케이션** → **애플리케이션 추가하기** 2. 앱 이름: `Morning Insight` 3. 사업자명 입력, 카테고리: **비즈니스** ### 2. 플랫폼 등록 **앱 설정 → 플랫폼 → Web 플랫폼 등록** ``` 사이트 도메인: https://<서비스 도메인> ``` ### 3. 카카오 로그인 활성화 1. **카카오 로그인** 을 **ON** 2. **Redirect URI** 등록 ``` https://<서비스 도메인>/auth/kakao/callback ``` 3. **동의 항목** 설정 | 항목 | 설정 | |---|---| | 닉네임 | 필수 동의 | | 이메일 | 선택 동의 (계정 식별에 사용) | > 이메일을 선택 동의로 두면 사용자가 거부할 수 있어 계정 식별이 어려워집니다. > 서비스 정책에 따라 필수 동의로 신청할 수 있으나, 그 경우 별도 검수가 필요합니다. ### 4. 앱 키 확인 **앱 키** 페이지에서 **REST API 키** 를 복사합니다. Client Secret 이 필요하면 **카카오 로그인 → 보안** 탭에서 별도로 발급·활성화합니다. ### 5. (알림톡을 쓰려면) 비즈 채널 등록 1. [카카오 비즈니스](https://business.kakao.com) 에서 **채널 등록** 2. **메시지 템플릿**을 사전 등록해 승인받습니다 > 알림톡은 승인된 템플릿만 발송할 수 있습니다. 자유 문구는 불가합니다. ## 모닝인사이트에 입력 `/admin` 운영자 콘솔 → Kakao 섹션 | 항목 | |---| | REST API 키 | | (활성화했다면) Client Secret | ## 심사 | 대상 | 기간 | |---|---| | 카카오 로그인 기본 | 즉시 | | 비즈 알림톡 (채널 + 템플릿) | **1~3일** | | 톡 푸시 | 비즈 채널 + 가입자 수 조건 충족 필요 | ## 자주 나는 오류 | 오류 | 원인 | 해결 | |---|---|---| | `redirect_uri_mismatch` | Redirect URI 불일치 | 앱 설정에서 정확히 등록 | | 도메인 오류 | Web 플랫폼 미등록 | 플랫폼에 사이트 도메인 등록 | | 이메일이 안 넘어온다 | 사용자가 선택 동의 거부 | 동의 항목 정책 재검토 | | 알림톡 발송 실패 | 템플릿 미승인 | 승인된 템플릿으로 발송 | | 알림톡 발송 실패 | 비즈 채널 미등록 | 카카오 비즈니스에서 채널 등록 | ## 관련 문서 - [Cafe24 앱 등록](/news/guide/operator-cafe24) - 고객용: [KakaoTalk 알림 연동](/news/guide/kakao)