웹 애플리케이션에 참여 메신저 포함

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 3분

    • 고객이 웹 사이트에서 참여 메신저를 사용할 수 있도록 웹 사이트에 구성한 메신저 모듈의 소스 코드를 포함합니다.

    시작하기 전에

    이 태스크 정보

    활성화한 메신저 모듈의 소스 코드를 복사하여 메신저를 배포하려는 웹 사이트의 HTML 파일에 붙여넣습니다.

    그 다음, 구성된 메신저 모듈에 대해 선택한 인증 유형에 따라 함수에 대한 코드를 작성하여 ID 토큰을 가져오고 메신저에서 로그인한 사용자의 세션을 시작 및 중지할 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > 참여 메신저 > 모듈.
    2. 웹 사이트에 설치하려는 메신저 모듈의 모듈 편집 열에서 편집을 클릭합니다.
      구성 안내 뷰가 표시됩니다.
    3. 구현 탭을 클릭합니다.
    4. 보안 설정 섹션을 변경한 경우 저장을 클릭합니다.
      참여 메신저 모듈의 코드가 업데이트됩니다.
    5. 아래로 스크롤하여 코드 포함 섹션에서 코드 복사를 클릭합니다.
    6. 웹 사이트의 HTML 파일을 열고 복사한 코드를 닫는 본문 태그 앞에 붙여넣습니다.
    7. OIDC 기반 또는 SAMl 기반 인증을 사용하는 메신저 모듈의 경우 다음 구성을 완료합니다.
      인증 유형작업
      OIDC 기반
      1. getTokenCallBack() 함수의 코드를 작성합니다.
      2. 사용자가 웹 사이트에 로그인할 때마다 SN_CSM_EC.onLogin() 함수를 호출합니다.

        이 함수를 사용하면 인증 사용자가 웹 사이트에 로그인 시 참여 메신저에 원활하게 로그인할 수 있습니다.

      3. 사용자가 웹 사이트에서 로그아웃할 때마다 SN_CSM_EC.onLogout() 함수를 호출합니다.

        이 함수를 사용하면 인증 사용자가 참여 메신저 및 웹 사이트에서 원활하게 로그아웃할 수 있습니다.
      SAML 기반
      1. 사용자가 웹 사이트에 로그인할 때마다 SN_CSM_EC.onLogin() 함수를 호출합니다.

        이 함수를 사용하면 인증 사용자가 웹 사이트에 로그인 시 참여 메신저에 원활하게 로그인할 수 있습니다.

      2. 사용자가 웹 사이트에서 로그아웃할 때마다 SN_CSM_EC.onLogout() 함수를 호출합니다.

        이 함수를 사용하면 인증 사용자가 참여 메신저 및 웹 사이트에서 원활하게 로그아웃할 수 있습니다.
      주:
      OIDC 및 SAML 기반 인증 설정에 대한 자세한 내용은 Now Support 지식베이스의 참여 메신저 자동 로그인 및 로그아웃 설정 [KB1560205] 문서를 참조하십시오.
    8. 미인증 사용자에 대한 워크업 기능을 활성화한 경우, //guestWalkupBaseUrl 코드 라인의 주석을 제거하고 고객 지원 포털의 기본 URL을 입력하여 구성을 완료합니다.

      예를 들어, 고객 지원 포털이 https://www.example.com/support인 경우, 코드를 guestWalkupBaseUrl = https://www.example.com/support로 업데이트합니다.

      그림 1. 참여 메신저 코드 복사
      강조 표시된 단계를 따라 참여 메신저 모듈을 구성합니다. 구현의 경우 Embed 코드를 사용하여 미인증 사용자 문제를 해결합니다.
    9. 옵션: 참여 메신저에 표시되는 기본 설정 언어를 설정하기 위해 Embed 코드를 수정하려면 다음 중 하나를 수행합니다.
      옵션설명
      lang: {ISO-locale code} 참여 메신저를 고정 언어로 로드할 수 있습니다.
      setLang : getEMLanguage 참여 메신저에 표시되는 언어를 동적으로 전환할 수 있습니다. getEMLanguage 값은 메신저 언어에 사용할 수 있는 모든 ISO 로캘 코드를 반환할 수 있습니다.
      setLang : getEMLanguage 함수는 두 매개변수를 모두 사용할 수 있을 때 기본 설정을 사용합니다. 그러나 사용자가 [sys_user_preference] 테이블에서 기본 설정 언어를 설정한 경우 참여 메신저는 해당 언어로 표시됩니다.
      주:
      Zurich 릴리스부터, 업그레이드한 고객은 Embed 코드를 수정하여 언어를 전환할 수도 있습니다.
    10. 옵션: 참여 메신저 코드를 추가한 웹 사이트를 열고 시작 관리자 아이콘이 있는지 확인하고 아이콘을 클릭하여 참여 메신저가 실행되는지 확인합니다.
    11. 옵션: 웹 페이지에 사전 예방적 권장 사항을 통합하려면 참여 메신저의 Embed 코드를 수정합니다.
      참여 메신저를 사용하여 웹 페이지에 사전 예방적 권장 사항을 통합하는 방법에 대한 자세한 내용은 참여 메신저 Embed 코드를 사용하여 웹 페이지에 사전 예방적 권장 사항 통합을 참조하십시오.

    다음에 수행할 작업

    참여 메신저 코드를 추가한 웹 사이트를 열고 메신저 시작 관리자 아이콘이 있는지 확인합니다. 아이콘을 클릭하여 참여 메신저를 엽니다.

    Now Mobile SDK를 사용하여 네이티브 iOS 및 Android 애플리케이션에 참여 메신저를 포함할 수도 있습니다.