도움말 위젯에 사용자 인증하기

Freshdesk 도움말 위젯을 사용하면 솔루션 문서와 연락처 양식을 웹사이트나 제품 내에 삽입할 수 있습니다. 고객이 도움이 필요할 때 위젯을 열어 솔루션 문서를 검색하거나 티켓을 제출할 수 있습니다. 도움말 위젯 생성에 대한 정보는 도움말 위젯 설정을 참조하세요.

Freshdesk는 포털에 로그인한 사용자나 특정 회사의 연락처에게만 지식 베이스의 특정 폴더 가시성을 제한할 수 있습니다. 이를 통해 다음을 수행할 수 있습니다:

민감한 정보가 포함된 솔루션 문서가 공개되지 않도록 방지
특정 회사에 대한 정보를 포함한 솔루션 문서를 해당 회사의 연락처에게만 표시
프리미엄 고객에게만 특정 솔루션 문서에 접근 허용

도움말 위젯을 생성할 때 해당 위젯과 연관된 솔루션 문서 카테고리를 선택할 수 있습니다. 이러한 카테고리에 가시성이 제한된 폴더가 있는 경우, 사용자는 해당 솔루션 문서를 보기 위해 위젯에 인증해야 합니다.

1. 특정 연락처에 대한 폴더 가시성 제한:

이 설정은 폴더(및 해당 솔루션 문서)의 속성을 편집하여 적용할 수 있습니다. 폴더(및 해당 솔루션 문서)를 다음 사용자에게 가시적으로 만들 수 있습니다:

모든 사용자
로그인한 사용자
에이전트
회사
봇

폴더의 속성을 편집하려면 솔루션 화면으로 이동하여 폴더를 선택하고 폴더 편집 아이콘을 클릭하세요.

2. 도움말 위젯 설정:

도움말 위젯이 없는 경우 support@freshdesk.com에 문의하세요. 도움말 위젯 생성에 대한 정보는 도움말 위젯 설정을 참조하세요. 위젯을 설정하는 동안 솔루션 문서를 표시하도록 선택할 수 있습니다.

활성화되면 표시할 솔루션 문서의 카테고리를 선택할 수 있습니다.

3. 공유 비밀 키로 사용자 인증:

고객을 위젯에 인증하려면 먼저 공유 비밀 키가 필요합니다. 공유 비밀 키는 Freshdesk 계정의 관리자 > 계정 > 보안 > 위젯 설정에서 찾을 수 있습니다. 예:

참고: Freshdesk Omni를 사용하는 경우 관리자 > 데이터 및 보안 > 티켓 보안으로 이동하세요.

인증 API를 사용하려면 서버 측에서 고객의 이름, 이메일, 만료 시간을 페이로드에 포함하여 JWT 토큰을 생성해야 합니다. 만료 시간은 Unix 타임스탬프 형식으로 지정해야 하며 2시간을 초과해서는 안 됩니다. 이 페이로드는 HS256 알고리즘을 사용하여 계정의 공유 비밀 키로 서명해야 합니다.

JWT 토큰 생성에 대한 자세한 내용은 API 문서를 참조하세요.

4. 인증 API 사용

서버 측에서 JWT 토큰을 생성한 후, 이를 위젯의 JavaScript 인증 API에 매개변수로 전달해야 합니다. 이렇게 하면 고객이 위젯에 인증되어 제한된 솔루션 문서나 연락처 양식을 볼 수 있습니다(로그인한 사용자에게도 제한된 경우). 그러나 이 인증은 설정한 시간에 따라 만료됩니다. 고객에게 원활한 경험을 제공하기 위해 콜백 함수를 전달하여 토큰 갱신을 자동화하세요. 콜백 함수는 토큰 만료 전에 자동으로 호출됩니다. 콜백 함수는 다음을 수행해야 합니다:

고객의 이름과 이메일을 페이로드에 포함하여 JWT 토큰을 재생성하고 만료 시간을 지정합니다. 계정의 공유 비밀 키로 서명해야 합니다.
재생성된 토큰으로 인증 API를 호출합니다.

서버 측에서 JWT 토큰을 생성하기 위해 https://your-server.tld/your-auth-url로 API 호출을 하고 다음 데이터를 반환하는 경우:

{ 
  freshworks_widget_auth_token: “eyJh.GUuY29tIiwibmF.RIjow” 
}

이 경우 인증 API 구현 예시는 다음과 같습니다:

FreshworksWidget('authenticate', { 
  token: 'YOUR_JWT_TOKEN_HERE', 
  callback: authenticateCallback 
});

authenticateCallback = function() { 
  fetch('https://your-server.tld/your-auth-url').then(
    function(data) { 
      FreshworksWidget('authenticate', { 
        token: data.freshworks_widget_auth_token 
      }); 
    }
  ) 
}

이 예에서는 JWT 토큰이 만료될 때마다 인증 API가 authenticateCallback() 함수를 호출합니다.

5. 위젯 코드를 삽입하고 고객을 인증한 후

연락처 양식은 고객의 세부 정보(이름 및 이메일 주소)로 미리 채워집니다.
로그인한 고객은 자신이 접근할 수 있는 문서만 보고 검색할 수 있습니다.
도움말 위젯은 고객의 선호 언어로 연락처 양식과 솔루션 문서를 로드합니다. 고객은 Freshdesk 포털에 로그인하여 프로필 편집으로 이동하여 선호 언어를 설정할 수 있습니다.

사용자를 헬프 위젯에 인증하기

언어. locale 매개변수를 사용하여 이를 재정의할 수 있습니다. 에이전트 포털에서 고객이 헬프 위젯에서 기사를 유용함/유용하지 않음으로 표시했는지 확인할 수 있습니다.

6. 사용자의 로그아웃

고객이 귀하의 웹사이트에서 로그아웃할 때, 위젯에서도 로그아웃해야 합니다. 이를 위해 로그아웃 API를 사용할 수 있습니다:

FreshworksWidget('logout')

다음은 로그아웃 버튼 클릭 시 로그아웃 API가 사용되는 예시입니다:

function logoutWidget() {
    FreshworksWidget('logout')
}

로그아웃

7. 공유 비밀 키 재설정

관리자 > 계정 > 보안 > 위젯 설정에서 공유 비밀 키를 재설정할 수 있습니다. 공유 비밀 키를 재설정하면 모든 세션이 무효화되며, 위젯에 로그인한 모든 고객이 로그아웃됩니다.

재설정 후에는 서버 측에서 JWT 토큰을 생성하기 위해 새로운 공유 비밀 키를 사용해야 합니다.

도움 위젯에 사용자 인증하기