PowerBI Connector App for Freshchat
개요
PowerBI Connector App은 Freshchat/CSS와 통합되어 관리자가 보고 데이터를 PowerBI의 스트리밍 데이터셋으로 내보낼 수 있는 기능을 제공합니다. 이 앱은 다음과 같은 세 가지 옵션을 포함합니다:
- 일일 빈도로 데이터 내보내기 기능
- 주간 빈도로 데이터 내보내기 기능
- 월간 빈도로 데이터 내보내기 기능
앱은 또한 어떤 분석 내보내기가 추출되어야 하는지를 제어할 수 있는 유연성을 제공합니다.
사전 준비 사항
스트리밍 데이터셋 생성
PowerBI 커넥터를 설치하기 전에 필요한 사전 준비 사항 중 하나는 PowerBI 내에서 스트리밍 데이터셋을 생성하는 것입니다. 스트리밍 데이터셋은 API 푸시를 통해 데이터를 수신할 수 있는 데이터셋으로, 보고서 추출에서 데이터를 지속적으로 푸시하기 위해 필요합니다.
다음은 그 과정입니다:
- 왼쪽 메뉴에서 'Create'를 클릭하고 'Streaming Dataset'을 옵션으로 선택합니다.
- 스트리밍 데이터셋 내에서 'API'를 옵션으로 선택합니다.
- 스트리밍 데이터셋에 이름을 지정하고 PowerBI로 가져오고자 하는 모든 필드를 생성합니다. 'Historical Data Analysis' 탭을 켜는 것을 잊지 마세요.
- PowerBI로 내보내고자 하는 모든 보고서에 대해 이 작업을 수행해야 합니다.
PowerBI 임베드 앱 생성
앱을 설치하기 전에 필요한 두 번째 사항은 Freshchat/CSS와 PowerBI를 연결하기 위한 자격 증명을 얻기 위해 PowerBI 임베드 앱을 생성하는 것입니다.
환경을 설정하려면 Power BI 임베드 분석 설정 도구로 이동합니다. 옵션으로 'Embed for your organization'을 선택합니다.
다음 단계에서는 PowerBI로 인증하고 로그인합니다. 다음 단계에서는 앱에 이름을 지정하고 다른 세부 정보를 입력합니다. 리디렉션 URL로 'custom URL' 옵션을 선택하고 이 URL을 입력하세요 - https://www.workato.com/oauth/callback. EU 데이터센터에 있는 경우 이 URL을 사용하세요 - https://app.eu.workato.com/oauth/callback. API 액세스에 대해 'Select All'을 선택하세요.
그런 다음 'Register'를 클릭하여 앱 등록을 완료합니다.
다음 단계에서는 필요에 따라 새 작업 공간을 생성하거나 기존 작업 공간을 계속 사용하려면 'skip'을 클릭할 수 있습니다.
마지막 단계에서는 'Skip'을 클릭하여 앱 생성을 완료할 수 있습니다.
화면에 'Application ID'와 'Application Secret'이 표시됩니다. 설치 과정에서 필요하므로 이를 기록해 두세요.
데이터 내보내기 API 생성
마지막 사전 준비 사항은 데이터 내보내기 일정을 생성하고 API를 얻는 것입니다. 이를 수행하려면 다음 단계를 따르세요:
- 'Analytics'로 이동하여 'Settings'를 클릭합니다.
- 설정 페이지에서 'Data Export' 탭을 선택합니다.
- 'Create Report'를 클릭합니다.
- 내보내기에 이름을 지정하고 데이터를 내보내고자 하는 모듈을 선택합니다. 또한 내보내기를 트리거하고자 하는 일정과 시간을 선택합니다. 시간과 시간대가 기대에 맞는지 확인하세요.
- 다음 섹션에서 내보내고자 하는 필드를 선택하고 'API'로 수신하도록 선택합니다. URL을 복사하여 나중에 사용할 수 있도록 준비해 두세요.
- 'Schedule'을 클릭하여 내보내기 일정을 생성합니다.
설치
Freshchat에 PowerBI 앱 설치
Freshchat/CSS에 PowerBI Connector App을 설치하려면 Admin -> Apps로 이동하여 Freshchat/CSS 마켓플레이스로 이동하고 'PowerBI Connector App'을 검색합니다.
설치를 클릭하면 Freshchat/CSS 자격 증명을 입력하라는 메시지가 표시됩니다.
Freshchat 계정 연결
아래 나열된 세부 정보는 'Admin Settings -> API settings -> API Details for Chat'에서 찾을 수 있습니다.
- Freshchat 도메인을 입력합니다. URL 형식은 'yourcompany.freshchat.com'입니다.
- Freshchat API 키를 입력합니다.
- CRM 도메인을 입력합니다. URL 형식은 'yourcompany.myfreshworks.com'입니다.
- CRM API 키를 입력합니다.
'install'을 클릭합니다. 앱 설치가 완료되면 왼쪽 탐색 모음에서 전체 페이지 앱으로 이동합니다.
데이터 동기화 구성
PowerBI와 Freshchat/CSS 간의 데이터를 동기화하려면 전체 페이지 앱의 'Data sync' 탭으로 이동합니다. 이 기능은 'Connector apps add-on'에 의해 제공됩니다. 가격 정보는 아래 섹션을 참조하세요.
동기화하려는 PowerBI 계정을 연결합니다. PowerBI 계정에 연결하려면 Application ID와 Application Secret을 입력해야 합니다. 인증 유형을 'Oauth2 Authorization code'로 선택하고 ID와 비밀을 Client Id와 Client secret 필드에 입력합니다.
API 버전을 'Version 1.0'으로 선택하고 PowerBI 계정 유형에 따라 계정 유형을 선택합니다. 대부분의 경우 'Multitenant'일 것입니다.
'Connect'를 클릭하여 설정을 완료합니다.
연결이 설정되면 PowerBI로 보고 데이터를 푸시하는 레시피를 볼 수 있습니다. 레시피는 데이터를 동기화하는 세 가지 옵션을 제공하며, 각각 다른 빈도로 데이터를 동기화합니다. 데이터를 일일, 주간 또는 월간으로 동기화할 수 있습니다.
레시피 목록에서 내보내고자 하는 빈도와 모듈을 선택합니다.
Freshchat/CSS에서 PowerBI로
내보내고자 하는 모듈과 빈도의 레시피를 열면 아래와 같은 화면이 표시됩니다.
레시피 화면에서 1단계로 이동하여 일정 빈도와 시간이 API 내보내기 일정과 일치하는지 확인합니다. 레시피의 트리거 시간은 API 내보내기 일정보다 5-10분 후여야 합니다.
그런 다음 레시피 내부의 두 번째 블록을 클릭하고 연결 탭을 클릭합니다.
'Switch Connections'를 클릭한 다음 'new connection'을 클릭합니다.
새 연결 탭에서 'Authentication Type'을 Header auth로 선택합니다. 헤더 섹션에 Freshchat API 키를 입력하고 아래에 표시된 형식으로 설정합니다. 연결의 기본 URL을 'https://domain.myfreshworks.com' 형식의 데스크 URL로 설정합니다.
'Use Custom TLS/SSLcertificate settings' 옵션을 'No'로 설정합니다.
이 작업이 완료되면 설정 탭으로 이동하여 요청 URL 옵션에 데이터 내보내기의 API URL을 입력합니다. (민감한 데이터 경고는 무시할 수 있습니다)
레시피의 4단계로 이동하여 내보내기 파일의 샘플 CSV를 업로드하여 내보내기의 스키마가 캡처되도록 합니다.
설정을 완료하려면 레시피의 5단계로 이동하여 데이터를 로드할 PowerBI의 데이터셋을 선택합니다. 그런 다음 내보내기에서 데이터셋의 필드로 필드를 매핑합니다.
레시피를 저장하고 레시피 화면에서 켜면 선택한 일정에 따라 데이터가 PowerBI로 내보내지기 시작합니다.