웹사이트 페이지에 채팅 위젯이 표시되지 않는 문제 해결하기

실시간 채팅 또는 규칙 기반 챗봇을 설정할 때 채팅 위젯이 예상 웹사이트 페이지나 의도한 연락처에 표시되지 않을 수 있습니다. 이 문서에서는 일반적인 원인과 문제 해결에 도움이 되는 문제 해결 단계를 간략하게 설명합니다. 

추적 코드가 설치되어 있는지 확인

HubSpot에서 외부에서 호스팅되는 웹사이트에 채팅 플로우를 추가하는 경우에는 페이지에 HubSpot 추적 코드를 설치해야 합니다. 설정에서 추적 코드에 액세스할 수 있습니다:

참고: 웹사이트에 이미 HubSpot 추적 코드가 설치되어 있거나 웹사이트가 HubSpot에서 호스팅되는 경우 이 코드 조각을 별도로 설치할 필요가 없습니다 .

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 추적 & 애널리틱스 > 추적 코드로 이동합니다.
3. 코드를 복사하여 웹사이트에 추가하려면 복사를 클릭합니다. 또는 개발자에게 이메일을 클릭하고 이메일 주소를 입력하여 웹 개발자 또는 IT 리소스에게 코드를 전송합니다.

추적 코드를 수동으로 추가한 경우, 정확한 스니펫이 수정 없이 복사되어 페이지 헤더에 예상 위치에 설치되었는지 확인하세요. 태그 관리자를 사용하는 경우 테스트 중인 페이지에서 HubSpot 태그가 게시 및 실행되고 있는지 확인합니다.

스크립트 차단기 또는 쿠키 동의 제한 확인

그래도 채팅 위젯이 표시되지 않으면 쿠키 동의 배너, 스크립트 차단기 또는 기타 타사 또는 사용자 지정 JavaScript가 HubSpot의 추적 스크립트 로딩을 방해하고 있는지 확인하세요. 일부 동의 관리 플랫폼은 방문자가 쿠키를 수락할 때까지 HubSpot 스크립트를 차단하여 채팅 위젯이 표시되지 않을 수 있습니다.

개발자와 협력하여 적절한 경우 HubSpot 스크립트가 실행될 수 있도록 하고, 타사 도구 또는 브라우저 확장 프로그램이 HubSpot 스크립트 로드를 차단하지 않는지 확인하세요. 

HubSpot 추적 코드 및 채팅 위젯 스크립트가 올바르게 로드되고 있는지 확인합니다 

추적 코드가 설치되면 페이지에서 올바르게 로드되는지 확인합니다.

추적 코드는 페이지 소스 또는 DOM에 id 속성과 함께 표시되어야 합니다 hs-script-loader.

HubSpot은 특정 스크립트 id 속성을 사용하여 동일한 스크립트가 두 번 이상 로드되지 않도록 합니다. 웹사이트의 다른 곳에서 HubSpot 스크립트 ID를 사용하지 마세요. 다른 페이지 요소가 이미 동일한 ID를 사용하는 경우 HubSpot은 스크립트가 이미 있다고 판단하여 다시 로드하지 않을 수 있습니다.

채팅 위젯 스크립트가 로드되고 있는지 확인합니다:

1. 브라우저에서 웹사이트를 엽니다.
2. 개발자 도구를 연 다음 네트워크 탭을 확인합니다.
3. 검색 conversations-embed.js. 이 파일은 HubSpot 추적 코드에 의해 로드되며 다음을 포함하는 도메인에서 제공되어야 합니다 usemessages.
4. 스크립트에 id 속성 hubspot-messages-loader 속성이 있고 필수 데이터 속성이 포함되어 있는지 확인합니다:
• data-hsjs-portal
• data-hsjs-hublet
• data-hsjs-env
5. 검색 visitor.js. 이 스크립트는 채팅 위젯 UI를 로드하고 conversations-embed.js.

만약 conversations-embed.js 또는 visitor.js 가 로드되지 않으면 브라우저 콘솔에서 JavaScript 오류, 콘텐츠 보안 정책 오류 또는 HubSpot 스크립트 실행을 방해할 수 있는 기타 페이지 오류가 있는지 확인하세요.

참고: 계정에서 채팅 플로우가 켜져 있지 않은 경우 추적 코드에 conversations-embed.js를 로드하는 코드가 포함되지 않을 수 있습니다. 채팅 플로우를 켠 후 업데이트된 추적 코드가 채팅 위젯 스크립트로드를 시작하기 전에 캐싱이 있을 수 있습니다.

사이트에서 CSP(콘텐츠 보안 정책)를 적용하는 경우 HubSpot 스크립트 도메인이 허용되는지 확인하세요. CSP 관련 오류는 일반적으로 브라우저 콘솔에 표시되며 차단된 스크립트와 그 이유를 나타냅니다. HubSpot의 콘텐츠 보안 정책 설정에서 필수 도메인 및 지시문에 대해 자세히 알아보세요.

채팅 플로우 켜기

채팅 흐름이 켜져 있는지 확인합니다:

1. HubSpot 계정에서 서비스 > 채팅 플로로 이동합니다.
2. 비활성 채팅 플로우 옆의 상태 열을 클릭하여 상태 스위치를 켭니다.

브라우저 캐시 지우기

채팅 플로우를 켠 후 웹사이트에 채팅 플로우가 나타나지 않으면 올바른 라이브 도메인 또는 환경에서 테스트하고 있는지 확인하세요. 최근에 사이트를 변경한 경우 몇 분간 기다리거나 페이지를 새로고침하세요.

그런 다음 시크릿 브라우저 창에서 웹사이트를 로드해 보세요. 채팅 흐름이 시크릿 상태로 표시되는 경우, 브라우저 캐시와 쿠키를 삭제하여 시크릿이 아닌 브라우저 창에서 채팅 흐름을 볼 수 있도록 하세요.

타겟팅 및 제외 규칙 검토

채팅 플로우를 구축할 때 타겟팅 설정에서 채팅 위젯이 표시될 페이지를 지정할 수 있습니다. 방문자에 대해 알려진 정보를 기반으로 타겟팅할 수도 있습니다. 채팅플로우의 타겟 탭에서 타겟팅 규칙을 검토하여 웹사이트 페이지에 표시될 것으로 예상되는 기준과 일치하는지 확인하세요.

올바른 도메인 및 하위 도메인 지정

먼저 채팅 흐름이 표시될 것으로 예상되는 페이지가 타겟팅 규칙에 포함되어 있는지 확인합니다. 특정 도메인의 페이지에 채팅 플로우가 표시되도록 하려면 올바른 도메인을 입력해야 합니다. 예를 들어 타겟팅 규칙이 웹사이트 | 포함 | www.coffeeshop.com 인 경우 채팅 흐름은 www.coffeeshop.com, www.coffeshop.com/contact 및 www.coffeeshop.com/pricing 를 포함하여 www 하위 도메인에서 호스팅되는 모든 페이지에 표시됩니다.

그러나 타겟팅 규칙에 블로그 하위 도메인을 추가하지 않으면 블로그.coffeeshop.com에 채팅 흐름이 표시되지 않습니다 .

또는 타겟팅 규칙에서 루트 도메인을 지정할 수 있습니다. 이 예에서 타겟팅 규칙 Website | contains | coffeeshop.com을 사용하는 경우 이 루트 도메인이 있는 모든 페이지에 채팅 흐름이 표시됩니다.

타겟팅에 사용된 페이지 URL을 확인합니다

채팅 위젯이 로드되면 페이지 URL을 HubSpot으로 전송하여 타겟팅 규칙에 따라 채팅 흐름이 표시될지 여부를 결정합니다.

사용 중인 URL을 확인하려면 다음과 같이 하세요:

1. 브라우저에서 웹사이트를 엽니다.
2. 페이지의 아무 곳이나 마우스 오른쪽 버튼으로 클릭하고 검사를 선택하거나 Ctrl + Shift + I (Windows) 또는 Cmd + Option + I (Mac)를 눌러 개발자 도구를 엽니다.
3. 네트워크 탭을 클릭합니다.
4. 페이지를 새로 고칩니다.
5. 채팅 위젯과 관련된 요청을 찾습니다(예를 들어 conversations 또는 messages).
6. 요청을 클릭한 다음 헤더 탭을 확인합니다.
7. 헤더를 찾아 X-Hubspot-Messages-Uri 헤더를 찾아 그 값을 검토하세요.

이 헤더의 URL이 채팅 플로우 타겟팅 규칙과 일치하는지 확인합니다. 예를 들어, 다음을 포함하는 타겟팅 규칙은 https://hubspot.com 로 시작하는 URL과 일치하지 않습니다 https://www.hubspot.com 로 시작하는 URL과 일치하지 않습니다 www 하위 도메인으로 시작하는 URL과 일치하지 않습니다.

사이트에서 역방향 프록시를 사용하는 경우 프록시가 요청을 전달할 때 프록시가 X-Hubspot-Messages-Uri 헤더를 유지해야 합니다. 이 헤더가 없으면 채팅 위젯이 예상대로 로드되지 않을 수 있습니다.

제외 규칙 확인

채팅 흐름이 예상대로 표시되지 않는다면 페이지 URL이 제외 규칙에 포함되어 있지 않은지 확인하세요. 채팅 플로우로 이동한 다음 대상 탭에서 필요에 따라 제외 규칙을 검토하고 제거합니다.

방문자 정보 및 행동 확인

방문자 정보 및 행동을 기반으로 채팅 플로우를 타겟팅하는 경우에는 연락처가 타겟 기준을 충족하는지 확인하세요. 예를 들어 웹사이트에서 특정 CTA를 클릭한 연락처에게만 채팅 흐름이 표시되는 경우에는 연락처 레코드로 이동하여 해당 연락처의 CTA 활동을 필터링합니다. 연락처가 선택한 CTA를 클릭하지 않은 경우에는 채팅 흐름이 표시되지 않습니다.

고객이 CTA를 클릭했다면 이 가이드의 추가 문제 해결 단계를 검토하거나 추적 쿠키가 채팅 흐름 표시 여부에 어떤 영향을 미칠 수 있는지 자세히 알아보세요.

단일 페이지 애플리케이션(SPA) 확인

웹사이트가 단일 페이지 애플리케이션(SPA)인 경우, 사용자가 다른 페이지로 이동할 때 SPA의 웹사이트 콘텐츠가 다시 로드되지 않고 동적으로 업데이트되는 방식 때문에 타겟팅 규칙이 예상대로 작동하지 않을 수 있습니다. HubSpot이 새 페이지 URL을 감지할 수 없으므로 페이지에 잘못된 채팅 흐름이 표시되거나 아예 표시되지 않을 수 있습니다. 단일 페이지 앱에서 라이브 채팅 또는 봇을 사용하는 경우 개발자와 협력하여 채팅 위젯 SDK를 사용하여 페이지를 타겟팅하는 것이 좋습니다. .widget-refresh 메서드를 사용하여 페이지마다 다른 채팅 플로우를 지정할 수 있습니다. HubSpot의 개발자 문서에서 자세히 알아보세요.

채팅 가용성 설정 확인

여전히 채팅 흐름이 페이지에 표시되지 않는다면 채팅 채널의 사용 가능성 설정을 확인하세요. 사용 가능성 설정을 편집하여 팀원이 온라인 상태가 아니거나 업무 시간 외일 때를 포함하여 채팅 위젯을 숨길 시기를 제어할 수 있습니다:

1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
2. 왼쪽 사이드바 메뉴에서 받은 편지함 & 헬프데스크로 이동합니다 :
   • 대화 받은 쪽지함에 연결된 채팅 채널을 편집하려면 에서 받은 쪽지함을 선택합니다.
   • 헬프 데스크에 연결된 채팅 채널을 편집하려면 헬프 데스크를 선택합니다. 그런 다음 티켓 소스 및 라우팅에서 채널을 클릭합니다.
   • 채팅 채널 위로 마우스를 가져가서 편집을 클릭합니다.
3. 가용성 탭으로 이동합니다 . 옵션을 선택합니다:

• • 사용자 가용성 기준: 방문자는 배정 규칙에 지정된 팀원 중 한 명 이상이 사용 가능한 경우 팀과 채팅할 수 있습니다.
  • 채팅 운영 시간 기준: 팀이 채팅할 수 있는 시간을 설정하고 방문자에게 답장을 기대할 수 있는 시간을 알려주세요.
    
    • 드롭다운 메뉴를 사용하여 팀의 운영 시간을 설정할 수 있습니다. 요일 및 시간 범위를 추가하려면 + 시간 추가를 클릭합니다.
    • 24시간 연중무휴 채팅 가능: 팀이 항상 채팅할 수 있는 것처럼 보이려면 이 확인란을 선택합니다.

4. 사용 가능성 동작 섹션에서 팀의 사용 가능 여부에 따라 채팅 환경을 구성하고 방문자에게 언제 답장을 기대할 수 있는지 알려주세요. 옵션을 선택합니다:

• • 팀을 사용할 수 있을 때 방문자의 환경을 설정하려면 사용 가능 탭을 클릭합니다. 일반적인 회신 시간 표시 드롭다운 메뉴를 클릭하여 방문자가 언제 회신을 받을 수 있는지 알려줍니다.
  • 팀이 업무 시간 중에 자리를 비울 때 방문자의 환경을 설정하려면 자리 비움 탭을 클릭합니다. 부재중 메시지 표시 드롭다운 메뉴를 클릭하고 부재중 모드 위젯 동작을 선택합니다.
    
    

  구독 필요 팀이 최대 수용 인원에 도달했을 때 방문자 환경을 설정하려면 Service Hub Enterprise 구독( )이 필요합니다.

  • 팀이 최대 수용 인원에 도달했을 때 방문자의 환경을 설정하려면 모든 팀원이 최대 수용 인원에 도달 하면 드롭다운 메뉴를 클릭하고 대기 메시지 표시, 채팅 시작 관리자 숨기기 또는 아무 작업도 수행하지 않기를 선택합니다. 사용자에 대한 채팅 용량 제한을 설정하는 방법에 대해 자세히 알아보세요.

• • 팀의 근무 시간 외에 방문자의 환경을 설정하려면 근무 시간 외 탭 을 클릭하고 오프라인 동작 설정 드롭다운 메뉴를 클릭한 다음 방문자가 업무 시간 외에 사이트를 방문할 때 복귀 시간 표시, 부재중 메시지 표시 또는 채팅 시작 관리자 숨기기를 선택합니다.

5. 저장을 클릭합니다.

봇이 포함된 채팅 플로우를 사용하는 경우에는 봇의 사용 가능성 기본 설정을 사용자 지정하지 않은 경우에도 채팅 플로우가 계속 표시될 수 있습니다. 팀의 사용 가능 시간에 따라 채팅 흐름이 표시되어야 하는 시기를 편집하는 방법을 알아보세요.

채팅 흐름 우선순위 확인

페이지에 표시되는 채팅 흐름이 두 개 이상인 경우 방문자가 사이트를 방문할 때 HubSpot이 우선순위를 지정할 채팅 흐름을 결정할 수 있습니다. 예상한 채팅 흐름이 표시되지 않으면 페이지의 다른 채팅 흐름과 비교하여 해당 채팅 흐름의 우선순위를 확인하세요.

다른 채팅 흐름이 나타나는 이유 이해하기

방문자가 페이지 중 하나에서 스레드를 시작한 후 다른 채팅 흐름이 표시되어야 하는 다른 페이지로 이동하는 경우 원래 스레드에서 대화가 계속됩니다. 따라서 다른 채팅 흐름은 표시되지 않습니다. 예를 들어

• 채팅 플로우 A는 www.coffeeshop.com 에 표시되어야 합니다.
• 채팅 플로우 B는 blog.coffeeshop.com에 표시되어야 합니다.
• 방문자가 Chatflow A와 채팅을 시작한 후 blog.coffeeshop.com으로 이동했습니다.
• 채팅 플로우 B는 표시되지 않으며 방문자는 채팅 플로우 A에서 시작한 스레드를 계속 진행할 수 있습니다.

추적 쿠키에 대한 이해

위의 단계를 수행한 후에도 대상 기준을 충족하는 연락처에 대해 채팅 위젯이 표시되지 않는다면 이는 추적 쿠키 때문일 가능성이 높습니다. 방문자에게 채팅 위젯이 표시되려면 추적 쿠키가 연락처 데이터베이스에 있는 방문자의 연락처 기록과 연결되어 있어야 합니다. 연락처 레코드에 추적 쿠키가 없는 경우에는 연락처 레코드와 연결된 방문자에게 채팅 위젯이 표시되지 않습니다.

방문자는 어떻게 추적 쿠키를 받나요?

방문자는 연락처가 되기 전에 추적 쿠키를 통해 익명으로 추적됩니다. 그러면 HubSpot은 두 가지 방법으로 추적 쿠키의 웹사이트 활동을 연락처 기록과 연결할 수 있습니다:

• 방문자가 HubSpot 양식을 작성합니다.
• 방문자가 HubSpot 마케팅 이메일을 클릭하면 HubSpot 페이지로 연결되거나 HubSpot 추적 코드가 설치된 비허브스팟 페이지로 연결됩니다.

또한 추적 코드 API를 사용하여 사이트 방문자를 추적할 수 있습니다.

방문자가 위의 전환 중 하나를 수행하기 전까지는 HubSpot은 방문자가 누구인지 또는 방문자의 연락처 기록이 어떤 목록에 속해 있는지 알 수 없습니다. 따라서 아직 전환하지 않은 연락처가 있으면 데이터베이스에 있는 연락처이거나 타겟팅하는 목록의 회원이라 하더라도 채팅 위젯을 볼 수 없습니다.

참고: 방문자가 위의 두 가지 작업 중 하나를 수행하여 추적 쿠키를 얻었더라도 방문자가 이후 브라우저 쿠키를 삭제하거나 다른 브라우저, 시크릿 창 또는 모바일 디바이스에서 사이트를 방문한 경우에는 추적 쿠키를 감지할 수 없으며 채팅 위젯이 표시되지 않습니다.

추적 쿠키가 없는 연락처가 있는 이유는 무엇인가요?

다음은 양식을 변환하거나 마케팅 이메일 링크를 클릭하지 않고도 데이터베이스에 연락처가 존재할 수 있는 몇 가지 일반적인 방법입니다:

• 연락처를 가져왔습니다.
• 연락처가 수동으로 추가되었습니다.
• 연락처는 기록된 영업 이메일에서 생성되었습니다.

데이터베이스의 연락처가 추적 쿠키로 추적되면 HubSpot은 해당 연락처를 알려진 연락처로 간주합니다. 잠재 고객 기준을 충족하는 경우 사이트를 방문할 때 채팅 위젯이 표시됩니다.

참고: 경우에 따라 일부 브라우저 확장 프로그램(예: 팝업, 광고 또는 스크립트 차단기)으로 인해 채팅 위젯이 로드되지 않을 수 있습니다. 이러한 확장 프로그램을 비활성화한 후 위젯이 나타나면 해당 확장 프로그램 중 하나가 위젯을 차단하고 있을 가능성이 높습니다.