카테고리
Introduction
Welcome to Channel
채널톡 개발자 문서에 오신 것을 환영합니다. 채널톡이 처음이라면 웹사이트에서 더 많은 정보를 얻어보세요. 개발자 문서에는 채널톡을 유용하게 사용하기 위한 정보가 모여있습니다. - Open API와 SDK의 사용법을 알 수 있습니다. - 각 플랫폼(웹, iOS, 안드로이드)에 대한 설치 가이드를 볼 수 있습니다. - Open API와 SDK의 명세를 확인할 수 있습니다. 채널톡과 관련한 질문이 있다면 새로운 채널톡 상담을 열어주세요 ✌️
채널톡 이해하기
채널톡은 웹사이트나 모바일 앱에 설치할 수 있는 SDK를 통하여 고객과 소통할 수 있는 많은 경험을 제공합니다. 주목할 만한 기능은 다음과 같습니다: - 실시간 채팅 상담 - 고객이 원하는 것을 찾을 수 있도록 돕는 마케팅 기능 - 고객이 무엇을 원하는지 분석할 수 있도록 돕는 이벤트 트래킹 채널톡에 아직 가입하지 않으셨다면 바로 홈페이지 혹은 채널톡 앱에서 가입해보세요! 플랫폼 별 SDK - JavaScript SDK 시작하기 - 안드로이드 SDK 시작하기 - iOS SDK 시작하기 플러그인 키 얻기 플러그인 키는 채널톡 SDK를 특정 채널과 연결시키는 문자열로, 채널톡 SDK을 사용하기 위해서는 플러그인 키가 필요합니다. 플러그인 키를 얻을 수 있는 방법은 다음과 같습니다: 1. 채널톡 홈페이지 혹은 채널톡 데스크를 통해 가입합니다. 2. 채널을 생성합니다. 3. 웹 데스크 기준 좌측 하단의 채널 설정 > 일반 설정 > 버튼 설치 및 설정 > 채널톡 버튼 설치에서 플러그인 키를
이벤트 이해하기
이 문서에서는 채널톡 SDK (이하 SDK)의 이벤트에 대해 설명합니다. Event는 무엇인가요? 이벤트(Event)는 웹사이트나 애플리케이션 내에서 발생하는 유저의 행동을 뜻하며, 비즈니스와 관련된 모든 이벤트를 정의할 수 있습니다. 이벤트 값 알아보기 SDK에서는 아래 이벤트를 기본적으로 제공합니다. - PageView : 고객이 특정 페이지를 조회했을 때의 이벤트 - UserChatOpen : 고객이 유저챗을 새로 열었을 때의 이벤트 - MarketingView : 고객이 마케팅 메시지를 조회했을 때의 이벤트 - MarketingClick : 고객이 마케팅 메시지 안에 포함된 url 링크를 눌렀을 때 발생하는 이벤트 - MarketingGoal : 마케팅 메시지에서 목표로 설정한 이벤트 값이 발생했을 때의 이벤트 프로퍼티는 무엇인가요? 프로퍼티(Property)는 이벤트를 설명해주는 하위 정보들입니다. 프로퍼티 데이터를 바탕으로 이벤트를 좀 더 자세하게 파악할 수 있고, 적합한
Member Hash 이해하기
이 문서는 Member Hash (이하 멤버 해시)에 대해서 설명합니다. 멤버 해시 기능(보안화 설정)이란? 멤버 해시(Member Hash)는 고객의 memberId를 HMAC-SHA256를 이용해 암호화하여 적합한 유저의 부트 요청만 허용할 수 있도록 하는 기능입니다. 보안 강화를 위해서 멤버 해시 기능을 사용하는 것을 강력하게 권장합니다. 부트에 사용하는 memberId는 각 고객을 구분할 수 있고 고유한 값이어야 하므로, 많은 고객사에서 서비스의 아이디나 이메일과 같은 정보를 사용하고 있습니다. 하지만, 이와 같이 예상하기 쉬운 정보를 memberId로 사용할 경우 제3자 역시 쉽게 다른 고객의 memberId를 유추할 수 있게 됩니다. 이 경우 제3자가 다른 고객의 정보를 이용해 부트할 수 있고, 고객의 전화번호나 채팅 기록 같은 민감한 정보를 탈취할 수 있습니다. 멤버 해시 기능은 SDK를 직접 설치한 자체 개발 사이트와, 일부의 빌더사(Cafe24, 메이크샵, 워드프레스
Page 이해하기
이 문서에서는 페이지(Page)에 대해 설명합니다. 페이지가 무엇인가요? 페이지는 현재 보고 있는 화면에 대한 정보를 나타내는 값입니다. 페이지는 특정 이벤트를 전송하거나, 특정 워크플로우를 보여주기 위해 활용될 수 있습니다. URL 대신 페이지를 사용하는 이유는 무엇인가요? URL에는 두 가지 한계점이 존재합니다. 1. SPA(Single Page Application) 환경에서 URL은 변경되지 않습니다. 2. 모바일 어플리케이션은 URL을 가지지 않습니다. URL 대신 페이지를 사용함으로써, 현재 보고 있는 화면에 대한 정보를 원활하게 활용할 수 있습니다. 페이지는 기본값으로 어떤 정보를 가지고 있나요? 플랫폼에 따라 상이합니다. - 웹: canonical URL - iOS: 뷰 컨트롤러 클래스 이름 - 안드로이드: 액티비티 클래스 이름 페이지 값을 바꿀 수 있나요? setPage와 resetPage 메서드를 사용할 수 있습니다. 더 자세한 정보는 아래 링크를 참고합니다. -
canonical URL 이해하기
이 문서에서는 표준 URL(canonical URL)에 대해 설명합니다. 표준 URL이 무엇인가요? 표준 URL은 중복되거나 유사한 여러 페이지 중 가장 대표적이라고 간주되는 페이지의 URL을 말합니다. 예를 들어, 동일한 페이지의 URL이 여러 개 있는 경우(예: https://channel.io/en/pricing, https://channel.io/en/pricing?show=true), 그 중 하나의 URL이 표준 URL이 될 수 있습니다. 채널톡 SDK는 아래의 과정을 통해 표준 URL을 조회합니다. 1. rel 프로퍼티의 값이 “canonical”인 link 태그의 href 프로퍼티의 값을 조회합니다. <link rel="canonical" href="{canonicalUrl}" /> 2. 위 조건에 해당하는 link 태그가 없을 경우, URL을 조회합니다. SDK가 표준 URL을 정상적으로 조회하는지 테스트 해볼 수 있습니다. 더 자세한 내용은 표준 URL을 참고합니다.
용어 설명집
채널 프론트 채널톡 SDK를 통해 제공되는 채팅 버튼, 팝업, 메신저등 사용자 인터페이스를 모두 포함하는 개념입니다. 채널 버튼 메신저를 여는 버튼입니다. 메신저 메신저는 홈, 대화, 설정 등의 기능을 사용자에게 제공하는 종합적인 인터페이스 요소입니다. 채널 데스크 채널톡에서 제공하는 올인원 툴을 지칭합니다. 매니저는 채널 프론트의 모든 기능들을 채널 데스크로 관리합니다. 푸시 알림 채널톡에서 웹 또는 애플리케이션으로 보내는 푸시 알림입니다. 푸시 알림의 종류는 다음과 같습니다. 인앱 푸시 알림 모바일 환경에서, 앱 또는 모바일 웹을 사용하고 있을 때 유효합니다. 두가지 종류의 화면을 표시합니다. - 매니저가 유저에게 보낸 메시지 알림일 때 - 버블 타입의 마케팅 메시지를 수신할 때 원격 푸시 알림 모바일 환경에서, 앱 또는 모바일 웹을 사용중이지 않을 때 유효합니다. 아래와 같은 화면을 표시합니다. - 매니저가 유저에게 보낸 메시지 알림일 때 - 마케팅 메시지를 수신할 때 부트 S