실제 사용 기준

채널 등록 → 키오스크 연결 →
손님 QR

카카오 로그인 앱·열쇠(키)·Redirect URI는 플랫폼이 이미 준비합니다. 기업은 채널 정보만, 키오스크는 회사 번호(Tenant ID)만 넣으면 됩니다.

기업 설정 열기 홈

한 줄로

  1. 기업: 이 사이트에서 채널 이름·채널 번호 저장 → 회사 번호 복사
  2. 키오스크: FollowKakaoInstagram 실행 → 회사 번호 설정에 붙여 넣고 저장
  3. 손님: 키오스크 QR → 카카오 로그인·친구추가 → 키오스크 언락

누가 뭘 하나

기업 담당자
회원가입 → 채널 정보 저장 → 회사 번호를 키오스크 담당자에게 전달
키오스크 담당자 (운영)
python run_kakao.py 실행 후 홈 → 회사 번호 설정에 Tenant ID 저장
손님
QR 스캔 후 카카오 로그인·채널 친구추가 (폰에서)
플랫폼 (우리)
공용 카카오 앱, REST 키, Redirect URI, Cloudflare 시크릿 — 기업이 안 함

기업이 안 해도 되는 일

위는 전부 플랫폼 또는 키오스크 TENANT_ID 연결로 처리됩니다.

1. 기업 · 채널 담당자에게 받을 것

요청 예시: “키오스크 연동용으로 카카오톡 채널 이름하고 Public ID 좀 알려주세요.”

2. 기업 · 이 사이트에서 등록

  1. 기업 설정에서 이메일·회사명·비밀번호로 회원가입 (이후엔 로그인)
  2. 손님에게 보일 채널 이름, 채널 번호 입력 후 저장
  3. 화면에 나온 회사 번호(Tenant ID)를 복사해 키오스크 담당자에게 전달

상단에 “카카오 로그인(플랫폼): 준비됨”이 보이면 플랫폼 쪽은 OK입니다.

3. 키오스크 · 회사 번호 연결

키오스크 PC의 FollowKakaoInstagram에서:

  1. python run_kakao.py로 프로그램을 실행합니다.
  2. 홈 화면의 회사 번호 설정을 엽니다.
  3. 기업이 준 회사 번호(Tenant ID)를 붙여 넣고 저장합니다.
  4. 카카오톡 화면으로 가서 QR이 뜨는지 확인합니다.

저장 값은 로컬 .env의 TENANT_ID에 기록됩니다. (직접 수정해도 동일) 카카오 REST 키·Redirect·채널 ID는 키오스크에 넣지 않습니다.

4. 손님 · 실제 사용

  1. 키오스크 화면에 QR이 뜹니다.
  2. 손님이 폰으로 QR을 스캔합니다.
  3. 카카오 로그인 → 채널 친구추가(동의) → 완료 화면
  4. 키오스크가 세션을 확인하고 언락됩니다.

폰은 인터넷만 되면 됩니다. 키오스크랑 같은 Wi-Fi일 필요는 없습니다. (콜백은 클라우드)

끝났는지 확인

단어가 어려울 때

Tenant ID (회사 번호)
기업 계정 번호. 가입 후 대시보드에 나옵니다. 키오스크 「회사 번호 설정」에 그대로 넣습니다.
채널 Public ID (채널 번호)
카카오톡 채널 고유 번호. 친구추가 확인에 씁니다.
AGENT_BASE_URL
이 클라우드 주소. 보통 배포본 기본값을 그대로 씁니다.
플랫폼 공용 앱
여러 회사가 같이 쓰는 카카오 로그인 앱. 열쇠·Redirect는 운영사가 관리합니다.

막혔을 때

기업 설정 가기 홈으로