도움말 센터 · 접근 가이드
고객마다 알맞은 답변을 보여 주세요
안내가 필요한 사람에게만 보여 주세요. 방문자와 로그인한 고객에게는 기본 대상을 쓰고, 플랜이나 역할 같은 인증된 특성으로 그룹을 만들 수도 있어요.
1. 인증된 고객 로그인 연결
소유자나 관리자가 채널 → 내 채널 → 도움말 센터에서 접근 권한을 설정해요. 애플리케이션 개발자는 고객 신원을 한 번만 연결하면 돼요. 방문자 전용 콘텐츠라면 로그인 흐름을 만들지 않고 방문자를 선택하면 돼요.
- 채널의 실시간 채팅 탭을 여세요. 채널에 웹사이트가 없다면 연결한 뒤 보안 방문자 신원을 찾으세요.
- 선택적 인증 또는 신원 확인에 증명 필요를 고르고, 서명 시크릿 생성을 선택한 뒤 백엔드에만 보관하세요. 시크릿이 이미 설정돼 있다면 인증 모드에서 선택 — JWT가 있으면 인증 또는 신원 확인 및 속성에 필수를 고르세요. 신원 확인에 증명 필요를 선택해도 익명 채팅은 계속 가능하며, 콘텐츠 접근은 도움말 센터 대상 그룹이 관리해요.
- 앱이 고객을 인증한 뒤 서버가 user_id, email, iat, exp와 신뢰할 수 있는 특성을 담은 짧은 수명의 신원 토큰(JWT)에 서명해요. 플랜과 역할은 내 데이터베이스에서 읽으세요. 서명되지 않은 브라우저 속성과 연락처 필드로는 접근 권한을 얻을 수 없어요.
- JWT를 위젯에 전달하고, 호스팅된 페이지나 사용자 지정 도메인을 여는 사람을 위해 도움말 센터 로그인 동작을 연결하세요. 정확한 코드는 아래 링크의 개발자 안내를 참고하세요.
아래 예시에서 서명된 특성은 다음과 같아요.
{"plan":"pro","role":"admin"}2. Pro 고객 대상 그룹 만들기
- 도움말 센터로 돌아가세요. 대상 그룹에서 새 대상 그룹(더하기 버튼)을 선택하거나, 첫 그룹이라면 대상 그룹 만들기를 선택하세요.
- 이름에 Pro 고객을 입력하세요. 일치 조건은 모든 규칙으로 두세요.
- 특성에 plan을 입력하세요. 조건은 다음 중 하나, 값 유형은 텍스트로 설정하세요.
- 값 · 한 줄에 하나씩에 pro와 business를 각각 다른 줄에 입력하세요. 대상 그룹 저장을 선택하세요.
- 관리자 그룹을 만들려면 특성 role, 조건 같음, 값 유형 텍스트, 값 admin으로 반복하세요.
규칙 일치 방식: 모든 규칙은 이 대상 그룹의 모든 조건을, 하나 이상의 규칙은 최소 하나의 조건을 만족해야 해요. 규칙은 최대 10개까지 추가할 수 있어요. 특정 대상 그룹이 하나 이상의 규칙을 쓰더라도 상속된 모든 대상 그룹은 여전히 일치해야 해요.
텍스트는 대소문자를 구분해요. 숫자 5와 텍스트 “5”는 달라요. 이상 같은 비교에는 숫자를 고르세요. 없는 특성은 같지 않음을 포함해 어떤 비교도 만족하지 않아요. 값이 있음은 null을 제외하고, 값이 없음은 없거나 null인 경우에 일치해요. 특성 키는 문자로 시작하고 문자, 숫자, 밑줄만 쓰며 최대 64자예요. email 같은 예약된 신원 키는 특성이 아니에요.
3. 필요한 곳에 대상 그룹 적용하기
아티클 하나
아티클을 열고 누가 읽을 수 있나요?를 인증된 고객으로 설정한 뒤, 고객 대상 그룹에서 Pro 고객을 고르세요. 새 아티클은 게시를, 게시된 아티클은 변경 사항 저장을 선택하세요. 기본 접근 권한이 상속된 경우 읽기 전용이지만, 고객 대상 그룹은 추가로 고를 수 있어요.
카테고리 전체
카테고리 아래에서 해당 카테고리 옆의 연필 아이콘을 선택하세요. 인증된 고객과 고객 대상 그룹을 고른 뒤 저장하세요. 그 카테고리의 모든 아티클은 자체 제한과 함께 이 제한도 만족해야 해요.
비공개 도움말 센터
- 도움말 센터 접근 권한에서 인증된 고객을 고르세요. 고객 대상 그룹을 모든 인증된 고객으로 두거나, 센터 전체를 그 그룹으로 제한하려면 Pro 고객을 고르세요.
- 고객 로그인 URL에 내 애플리케이션의 로그인 페이지를 입력하세요(예: https://app.example.com/login). Sonny 직원용 로그인이 아니라 내 앱의 로그인 페이지예요.
- 로그인 후 앱이 새로 서명한 JWT와 함께 고객을 도움말 센터 인증 엔드포인트로 보내야 해요. 로그인 URL만으로는 연결이 완료되지 않아요.
- 접근 권한 저장을 선택하세요. 권한이 있는 고객이 열 수 있도록 센터를 게시됨 상태로 유지하세요.
제한은 서로 더해져요. 도움말 센터가 Pro 고객을 요구하고 카테고리가 관리자를 요구하면, 그 안의 아티클은 둘 다 요구해요. 아티클의 모든 사람 설정이 카테고리 설정보다 우선하지 않아요. 방문자와 인증된 고객은 서로 배타적인 기본 대상이에요.
4. 미리보기 후 실제 고객 세션 확인하기
- 도움말 센터 상단에서 다음으로 보기를 방문자, 인증된 고객, 특성이 있는 고객… 중 하나로 바꾸세요.
- 특성이 있는 고객…을 고르면 위의 샘플 JSON을 입력하세요. 흐리게 표시된 행은 그 독자에게 숨겨지며, 개수에는 게시 상태와 상속된 모든 제한이 반영돼요. 모든 아티클을 고르면 전체 작성 목록으로 돌아가요.
- 아래 표로 관리자 전용 카테고리가 있는 Pro 전용 도움말 센터를 테스트하세요. 샘플 plan과 role을 바꿔 가며 각 결과를 확인하세요.
- 실제로 로그아웃된 브라우저를 연 뒤 테스트 고객별로 로그인하세요. 둘러보기, 검색, 아티클 직접 URL, 위젯의 도움말 탭을 확인하세요. 특성 미리보기는 로그인되지 않으며 고객의 접근 권한도 바꾸지 않아요.
| 독자 | 도움말 센터 | 관리자 카테고리 아티클 |
|---|---|---|
| 로그아웃한 방문자 | 로그인 페이지 | 숨겨짐 |
| Pro 고객, 관리자 | 읽을 수 있음 | 읽을 수 있음 |
| Pro 고객, 일반 멤버 | 읽을 수 있음 | 숨겨짐 |
| Free 고객, 관리자 | 접근 안내 메시지 | 숨겨짐 |
접근이 거부된 아티클은 결과에서 빠지고 직접 URL은 찾을 수 없음을 반환해요. 비공개 도움말 센터는 콘텐츠 대신 브랜드에 맞춘 로그인 또는 접근 안내 메시지를 보여 줘요. 사이트맵은 비어 있고 색인이 허용되지 않아요. 방문자 전용 아티클도 공개 사이트맵에서 제외돼요. AI 답변과 Copilot 검색도 대화의 인증된 고객 신원에 같은 규칙을 적용해요.
업로드한 이미지 URL은 공개돼요. 아티클을 제한해도 이미 이미지 URL을 가진 사람으로부터 이미지를 보호하지는 않아요.
대상 그룹 변경 또는 제거
대상 그룹의 연필 버튼으로 편집하고 대상 그룹 저장을 선택하세요. 규칙 변경은 다음 요청부터 적용돼요. 고객 특성이 바뀌면 새 JWT나 도움말 센터 재로그인이 필요해요. 기존에 서명된 독자 세션은 만료될 때까지 특성을 유지해요.
한 곳에서 이름 붙은 제한을 빼려면 고객 대상 그룹에서 모든 인증된 고객(또는 상속된 대상 그룹의 모든 사람)을 고른 뒤 저장하세요. 그 콘텐츠를 공개하려면 누가 읽을 수 있나요?에서도 모든 사람을 고르고, 상위 항목이 공개 접근을 허용하는지 확인하세요.
대상 그룹의 삭제 버튼에는 그 그룹을 쓰는 아티클, 카테고리, 도움말 센터 수가 표시돼요. 삭제하면 그 그룹의 특성 규칙이 사라지고, 연결된 콘텐츠는 인증된 고객 전용으로 남으며 다른 상속된 제한도 유지돼요. 삭제된 규칙 때문에 접근하지 못했던 고객이 이제 접근할 수도 있어요. 확인하기 전에 적용 대상을 검토하세요.
접근 문제 해결
- 인증된 고객에게 로그인 페이지가 보여요
- 이 채널 실시간 채팅 탭의 인증 모드, JWT 만료 시간, 서명 시크릿, 도움말 센터 로그인 URL을 확인하세요. 직원용 대시보드 로그인은 고객 로그인과 별개예요.
- 고객이 로그인했는데 답변을 읽을 수 없어요
- 상속된 모든 대상 그룹과 서명된 특성의 정확한 이름, 유형, 값을 확인하세요. Pro 고객이라도 카테고리의 관리자 규칙은 통과하지 못할 수 있어요.
- 누가 읽을 수 있나요?가 비활성화돼 있어요
- 도움말 센터나 카테고리가 기본 대상을 정하고 있어요. 바꾸려면 그 상위 항목을 편집하세요. 인증 접근을 더 좁히려면 고객 대상 그룹을 쓰세요.
- 해당하는 독자 없음이 표시돼요
- 방문자 전용과 인증된 고객 전용 제한이 충돌해요. 제안되면 상속된 접근 권한을 쓰거나, 먼저 도움말 센터/카테고리 설정을 고치세요.
- 플랜이 바뀌었는데 접근 권한이 아직 그대로예요
- 바뀐 특성으로 새 JWT를 발급하고 위젯에서 다시 식별하세요. 호스팅 또는 사용자 지정 도메인 페이지는 도움말 센터 로그인을 다시 완료하세요. 기존 쿠키는 만료될 때까지 서명된 특성을 유지해요.
- 검색이나 위젯에서 아티클이 안 보여요
- 아티클이 게시됐는지, 센터가 게시됨 상태인지, 검색 결과를 위해 검색이 켜져 있는지, 독자가 모든 제한을 만족하는지 확인하세요. 빈 도움말 탭은 숨겨져요.