개발자 가이드

카카오 디벨로퍼스 연동

약 15분 — 따라 하면 채널 친구 여부 실시간 조회와 카카오 싱크(동의 정보 연동)가 실연동으로 켜져요. 카카오 계정만 있으면 되고 비용은 없습니다.

이 가이드로 켜지지 않는 것: 알림톡·브랜드 메시지 실발송은 카카오 정책상 공식 딜러사(비즈엠, NHN Cloud 등) 계약과 발신프로필 키 발급이 따로 필요해요 (진행 중 — 미결 #2). 그 전까지 발송은 mock으로 동작합니다.

1카카오 디벨로퍼스에서 앱 만들기

위치: developers.kakao.com → 내 애플리케이션

  1. developers.kakao.com 에 카카오 계정으로 로그인 후 우측 상단 내 애플리케이션 클릭
  2. 애플리케이션 추가하기 클릭
  3. 앱 이름 펫코팜 CRM, 회사명 펫코팜 입력 → 저장

앱은 무료이고, 만들어도 카카오 쪽에 아무것도 발송되지 않아요 — 키 발급용 껍데기입니다.

✓확인: 내 애플리케이션 목록에 '펫코팜 CRM'이 보이면 완료

2REST API 키 복사

위치: 내 애플리케이션 → 앱 설정 → 앱 키

  1. 방금 만든 앱 클릭 → 좌측 앱 설정 → 앱 키
  2. REST API 키 값을 복사해 두세요 (5단계에서 씁니다)

네이티브/JavaScript 키가 아니라 REST API 키입니다. 키가 노출되면 같은 화면에서 재발급할 수 있어요.

✓확인: REST API 키(32자 영숫자)를 복사함

3카카오 로그인 + 싱크 활성화

위치: 앱 → 제품 설정 → 카카오 로그인

  1. 좌측 제품 설정 → 카카오 로그인 → 활성화 ON
  2. Redirect URI에 다음을 추가:
    https://crmforall-console.vercel.app/api/sync/callback
  3. 동의항목에서 닉네임·전화번호 등 필요한 항목을 설정하고, 카카오싱크(간편가입)를 신청하세요 — 전화번호 등 민감 항목은 카카오 검수(비즈 앱 전환)가 필요합니다

싱크가 켜지면 고객이 카카오 동의 한 번으로 마케팅 수신 동의·채널 추가까지 끝나요 — 콘솔의 ‘동의 회원’이 여기서 늘어납니다.

✓확인: 카카오 로그인 ON + Redirect URI 등록

4비즈니스 채널 연결

위치: 앱 → 제품 설정 → 카카오톡 채널

  1. 카카오톡 채널 관리자센터에서 펫코팜 채널을 만들고(이미 있으면 생략) 비즈니스 채널로 전환
  2. 디벨로퍼스 앱의 제품 설정 → 카카오톡 채널에서 펫코팜 채널을 연결
  3. 채널 관리자센터 → 관리 → 상세설정에서 채널 공개 ID(예: _xaBcDe)를 복사
✓확인: 채널 공개 ID(_로 시작)를 복사함

5플랫폼에 키 등록 (Vercel 환경변수)

위치: Vercel → crmforall-console → Settings → Environment Variables

  1. KAKAO_REST_API_KEY = 2단계의 REST API 키
  2. KAKAO_CHANNEL_PUBLIC_ID = 4단계의 채널 공개 ID
  3. 둘 다 Production 환경에 추가 후 Redeploy

키 값은 화면 어디에도 다시 노출되지 않아요 — 콘솔은 ‘등록됨/대기’ 여부만 보여줍니다.

✓확인: 재배포 후 운영 → 카카오 채널에서 두 기능이 '실연동'으로 표시되면 완료

문제가 생기면

증상원인 · 해결
재배포 후에도 mock으로 표시환경변수 이름 오타 또는 Production 환경 미선택 — Vercel에서 이름·환경 확인 후 다시 Redeploy
싱크 동의 화면에서 전화번호 항목이 안 보임비즈 앱 전환·검수 전 — 디벨로퍼스 앱 설정에서 비즈니스 정보 등록 후 동의항목 심사 신청
채널 관계 API가 unknown만 반환채널 공개 ID 형식 확인 (_로 시작) · 앱과 채널이 연결됐는지 확인