← HUZY Chat

네이버 로그인 오픈 API 사전 검수 제출 자료 · 2026년 9월 1일

HUZY Chat 서비스 소개

본 문서는 네이버 로그인을 적용할 서비스의 업종, 콘텐츠 형태, 메뉴별 기능과 접속 가능한 URL을 안내하기 위한 소개 자료입니다. 검수자는 아래 URL로 실제 서비스를 확인할 수 있습니다.

1. 서비스 개요

서비스명HUZY Chat
운영 주체HUZY
업종정보통신 / 소프트웨어(SaaS) / 커뮤니티·실시간 커뮤니케이션 도구
콘텐츠 형태웹 기반 임베드 공개 채팅 및 1:1 채팅 상담. 텍스트 메시지, 접속자·상담 배정 및 상담 이력. 상품 판매·예약·청약 없음
대상자신의 웹사이트에 공개 채팅 또는 고객 상담을 붙이려는 서비스 운영자·상담사와 해당 사이트를 방문하는 일반 이용자

HUZY Chat은 다른 웹사이트에 채팅창을 삽입하는 독립형 커뮤니케이션 플랫폼입니다. 운영자는 앱을 만들 때 모두가 함께 대화하는 공개 채팅 또는 방문자와 상담사가 1:1로 대화하는 상담원 모드를 선택합니다. 이메일 가입 후 서비스 ID와 사이트 도메인을 등록하고 App Key를 받아 같은 위젯 코드로 설치합니다.

구분공개 채팅상담원 모드
이용 형태접속자들이 한 채팅방에서 함께 대화방문자와 배정 상담사의 1:1 대화
위젯 표시● 실시간 채팅문의 아이콘 · 채팅 상담
운영 기능접속자 명단, 귓속말, 숨김·차단자동배정, 대기, 이관, 종료 메모, 상담 내역
설정허용 도메인과 회원 연동상담시간, 상담사별 최대 배정 수, 대기 제한 시간

운영 모드는 앱 생성 시에만 선택하며, 대화 구조와 개인정보 접근 범위를 보호하기 위해 생성 후에는 변경할 수 없습니다.

전자상거래가 아닙니다. 상품 매매, 예약, 청약, 결제 대행, 성인·도박·불법 콘텐츠를 다루지 않습니다. 현재 유료 결제 기능은 제공하지 않으며 Free 플랜만 운영합니다.

2. 접속 가능한 서비스 URL

서비스는 이미 오픈되어 있으며, 검수자가 로그인 없이 콘텐츠를 확인할 수 있습니다.

네이버 로그인 콜백 URL(마이페이지 계정 연결): https://chat.huzy.net/api/auth/oauth/naver/callback
로그인용 콜백 URL: https://chat.huzy.net/api/auth/callback/naver

3. 메뉴별 기능과 화면

3.1 랜딩(홈)

URL: https://chat.huzy.net

상단 메뉴: 체험, 요금제, 문서, 로그인. 공개 실시간 채팅과 1:1 채팅 상담 소개, npm install @huzydev/chat 설치 안내, 실시간 데모 채팅, Free/Pro 요금 안내가 있습니다.

3.2 로그인

URL: https://chat.huzy.net/auth

로그인 화면은 관리자 로그인과 상담사 로그인으로 구분됩니다. 관리자는 이메일로 먼저 가입하고 마이페이지에서 연결한 Google·네이버·카카오 계정만 이후 로그인에 사용할 수 있습니다. 상담사는 SNS 없이 소속 앱의 서비스 ID·아이디·비밀번호로 로그인합니다.

3.3 회원가입

로그인 화면의 회원가입은 슬라이드 업 대화상자입니다. 이름, 이메일, 비밀번호(8자 이상), 이용약관·개인정보처리방침 동의를 순서대로 입력합니다. 가입 후 로그인하면 마이페이지로 이동합니다.

3.4 마이페이지

URL: https://chat.huzy.net/mypage (로그인 필요)

로그인 후 운영자가 사용하는 화면입니다.

  • SNS 계정 연결 — Google / 네이버 / 카카오를 이메일 계정에 연결하거나 해제합니다. 네이버 로그인은 이 메뉴의 “네이버 연결”에서 최초 연결됩니다.
  • 애플리케이션 등록 — 서비스 ID, 서비스 이름, 허용 도메인과 공개/상담 모드를 선택하면 App Key와 Identity Secret이 발급됩니다.
  • 내 애플리케이션 — 등록한 앱의 키와 모드를 확인하고 앱 관리 화면으로 들어갑니다.
  • 상담 앱 관리 — 상담 가능 시간, 상담사별 최대 배정 수, 대기 제한 시간과 상담사 계정을 관리하며 모든 상담 내역과 종료 메모를 열람합니다.
  • 최근 메시지 관리 — 운영 중인 채팅의 메시지를 숨기거나 30일 차단할 수 있습니다.

3.5 임베드 채팅(방문자용)

고객 사이트(예: wowndde, star) 우측 하단의 “실시간 채팅” 버튼을 누르면 패널이 열립니다. 방문자는 닉네임을 정하고 메시지를 보냅니다. 사이트에 로그인한 회원은 회원 닉네임이 고정됩니다. 접속 인원이 표시되고, 명단에서 귓속말을 보낼 수 있습니다. 채팅 내용은 커뮤니티 대화이며 결제·상품 정보가 아닙니다.

3.6 상담원 모드(방문자·상담사용)

상담원 모드 앱에서는 고객 사이트의 문의 아이콘과 “채팅 상담” 버튼을 누르면 1:1 상담창이 열립니다. 상담시간 안에 방문자가 이름과 문의를 입력하면 접속 중이면서 배정 여유가 있는 상담사에게 자동으로 연결됩니다. 상담사가 없으면 설정된 제한 시간 동안 대기하며, 제한을 넘으면 자동 종료됩니다.

상담사는 /auth?type=agent에서 서비스 ID·아이디·비밀번호로 로그인합니다. 본인에게 자동 배정된 상담에 답변하고, 잠시 대기시키거나 다른 상담사에게 이관하거나 종료 메모를 남겨 상담을 완료할 수 있습니다. 관리자는 앱 관리에서 진행·종료된 전체 상담을 선택해 대화를 확인합니다.

3.7 개발자 문서

URL: https://chat.huzy.net/docs

위젯 설치, 사이트 회원 연동, REST·WebSocket API 설명입니다. 일반 이용자가 아니라 개발자가 보는 화면입니다.

4. 네이버 로그인 적용 형태

  1. 운영자가 이메일로 회원가입합니다. (네이버만으로 신규 가입하지 않습니다.)
  2. 마이페이지 → SNS 계정 연결 → 네이버 연결을 누릅니다.
  3. 네이버 로그인 동의 후 콜백 /api/auth/oauth/naver/callback에서 기존 HUZY Chat 계정과 네이버 계정 식별자를 연결합니다.
  4. 이후 로그인 화면의 “네이버 로그인”으로 같은 계정에 들어올 수 있습니다. 콜백은 /api/auth/callback/naver입니다.

네이버에서 받는 정보는 로그인 식별에 필요한 계정 ID와, 제공되는 경우 이메일입니다. 채팅 본문·방문자 대화에는 네이버 프로필을 노출하지 않습니다. 연결 해제는 마이페이지에서 가능합니다.

채팅을 하는 일반 방문자는 네이버 로그인을 하지 않아도 됩니다. 닉네임만으로 대화할 수 있습니다.

5. 콘텐츠·법령 관련 소명

  • 제공 콘텐츠: 공개 실시간 텍스트 채팅, 1:1 채팅 상담, 상담사·상담 이력 운영 도구, 개발자용 위젯/API 문서
  • 미제공: 상품 판매, 예약/청약, 결제, 다운로드 마켓, 성인물, 사행 행위
  • 개인정보: 회원 이메일·이름·비밀번호 해시, SNS 연결 식별자. 채팅은 닉네임과 메시지, IP·방문자 식별값의 일방향 해시를 보관하며 상담원 모드에서는 배정 상담사, 상담 상태와 종료 메모를 함께 처리합니다. 상세는 개인정보처리방침을 따릅니다.
  • 청소년 유해 매체물을 주 콘텐츠로 하지 않습니다. 운영자가 자신의 채팅방을 관리·숨김·차단할 수 있습니다.

6. 검수 확인 방법 안내

  1. https://chat.huzy.net에 접속하면 소개 문구와 실제 데모 채팅이 보입니다.
  2. https://chat.huzy.net/auth에서 네이버 로그인 버튼 위치를 확인할 수 있습니다. (연결 전 계정으로 누르면 연결 안내만 나옵니다.)
  3. 적용 예시는 wowndde.huzy.net 또는 star.huzy.net 우측 하단 채팅 버튼입니다.

문의: HUZY Chat 운영 채널 · 서비스 도메인 chat.huzy.net