Zendesk Chat
Zendesk Chat is a live chat software platform that allows businesses to provide real-time customer support directly on their website or app.
Zendesk Support integration replicates data using the Zendesk Support API.
See the
Schema section for a list of objects available for replication.
유용한 링크와 지원되는 기능을 포함하여 이 커넥터에 대한 전반적인 내용을 살펴보겠습니다.
| 특징/기능 | 지원 세부 정보 |
|---|
| 지원되는 Qlik Talend Data Integration 프로젝트 | 복제 프로젝트에만 해당됩니다. 데이터 파이프라인 프로젝트는 지원되지 않습니다. |
대상 업데이트 방법 | 복제 작업: 데이터 레이크 작업에 데이터 랜딩: |
메타데이터 관리 | 수동 메타데이터 생성이 필요하지 않습니다. |
스키마 진화 | 열 데이터 유형 변경 작업만 지원됩니다. |
| LOB 열(NCLOB, CLOB 및 BLOB) 복제 | 지원되지 않음. |
| 예정된 CDC | 필수. 이렇게 하면 소스의 변경 내용이 대상에 최신 상태로 유지됩니다. 복제 작업의 경우 작업 예약 을 참조하십시오. 레이크 랜딩 작업의 경우 레이크 랜딩 작업을 위한 CDC 일정을 참조하십시오. |
| 알림 | 부분적으로 지원됨 작업 변경 알림 설정 |
| 모니터링 중 | CDC에만 해당되며, 이 커넥터의 경우 전체 로드가 적용되지 않습니다. 개별 데이터 작업 모니터링 |
| JSON 열 페이로드의 자동 압축 해제 | 지원되지 않음. 소스 데이터 집합의 JSON 열 페이로드는 대상에서 자동으로 압축 해제되지 않습니다. |
Preparing for authentication
To access your data, you need to authenticate the connection with your account credentials.
정보 메모사용하는 계정에 가져오려는 테이블에 대한 읽기 액세스 권한이 있는지 확인합니다.
To generate your client ID and secret:
- Log into your Zendesk chat domain, for example: https://my-sub-domain.zendesk.com/chat.
- Expand the Settings menu on the left of the page and click Account.
- Select the API and SDKs tab at the top of the page.
- Select or add an API Client. Your client ID is displayed on the page.
Copy and save the client secret in a secured file. You will need it to connect to the application.
Creating the connection
For more information, see SaaS 응용 프로그램에 연결.
Click Authenticate when you have filled in the required connection settings.
You may be asked to log in to the source application.
A window is displayed with an authentication code.
Copy the code to the clipboard and return to the connection dialog.
Paste the code in Complete authentication with the code provided by the source and click Verify.
팁 메모You may need to scroll down to see this field.
When status is Verified, the authentication is verified.
Provide a name for the connection in Connection name.
Select Open connection metadata to define metadata for the connection when it has been created.
Connection settings| Setting | Description |
|---|
| Data gateway | 사용 사례에 필요한 경우 데이터 이동 게이트웨이를 선택합니다. 정보 메모이 필드는 데이터 이동 게이트웨이를 지원하지 않으므로 Qlik Talend Cloud 시작 구독에서는 사용할 수 없습니다. 다른 구독 계층이 있고 데이터 이동 게이트웨이를 사용하지 않으려면 없음을 선택합니다. 데이터 이동 게이트웨이의 이점과 이를 필요로 하는 사용 사례에 대한 자세한 내용은 Qlik 데이터 게이트웨이 - 데이터 이동를 참조하십시오. |
| Start Date | 데이터를 소스에서 대상으로 복제해야 하는 날짜를 MM/DD/YYYY 형식으로 입력합니다. |
| Zendesk Subdomain | The subdomain of your Zendesk site. For example, the subdomain of qlik.zendesk.com would be qlik. |
| Client ID | Client ID. |
| Client Secret | Client secret. |
Schema
정보 메모Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.
The schema and info displayed below is for version 1.
Depending on your destination, table and column names may not appear as they are outlined below.
account
The account table contains info about accounts within your Zendesk Chat account.
| Join account with | on |
|---|
| goals | account.plan.goals = goals.id |
| chats | account.plan.goals = chats.conversions.goal_id account.plan.goals = chats.history.conversion.goal_id |
account_key
STRING
|
billing
OBJECT
This is a nested data structure: - additional_info: STRING
- address1: STRING
- address2: STRING
- city: STRING
- company: STRING
- country_code: STRING
- email: STRING
- first_name: STRING
- last_name: STRING
- postal_code: STRING
- state: STRING
|
create_date
DATE-TIME
|
plan
OBJECT
This is a nested data structure: - agent_leaderboard: BOOLEAN
- agent_reports: BOOLEAN
- analytics: BOOLEAN
- chat_reports: BOOLEAN
- daily_reports: BOOLEAN
- email_reports: BOOLEAN
- file_upload: BOOLEAN
- goals: INTEGER
- high_load: BOOLEAN
- integrations: BOOLEAN
- ip_restriction: BOOLEAN
- long_desc: STRING
- max_advanced_triggers: STRING
- max_agents: INTEGER
- max_basic_triggers: STRING
- max_concurrent_chats: STRING
- max_departments: STRING
- max_history_search_days: STRING
- monitoring: BOOLEAN
- name: STRING
- operating_hours: BOOLEAN
- price: NUMBER
- rest_api: BOOLEAN
- short_desc: STRING
- sla: BOOLEAN
- support: BOOLEAN
- unbranding: BOOLEAN
- widget_customization: STRING
|
status
STRING
|
agents
The agents table contains info about agents within your Zendesk Chat account.
| Join agents with | on |
|---|
| chats | agents.id = chats.agent_ids agents.departments = chats.department_id agents.departments = chats.history.prev_department_id |
| departments | agents.departments = departments.id |
| shortcuts | agents.departments = shortcuts.departments |
create_date
DATE-TIME
|
departments
ARRAY
|
display_name
STRING
|
email
STRING
|
enabled
BOOLEAN
|
enabled_departments
ARRAY
|
first_name
STRING
|
id
INTEGER
|
last_login
DATE-TIME
|
last_name
STRING
|
login_count
INTEGER
|
role_id
INTEGER
|
roles
OBJECT
This is a nested data structure: - administrator: BOOLEAN
- owner: BOOLEAN
|
scope
STRING
|
skills
ARRAY
|
bans
The bans table contains info about bans created in your Zendesk Chat account.
created_at
DATE-TIME
|
id
INTEGER
|
ip_address
STRING
|
reason
STRING
|
type
STRING
|
visitor_id
STRING
|
visitor_name
STRING
|
chats
The chats table contains info about the chats within your Zendesk Chat account.
| Join chats with | on |
|---|
| agents | chats.agent_ids = agents.id chats.department_id = agents.departments chats.history.prev_department_id = agents.departments |
| departments | chats.department_id = departments.id chats.history.prev_department_id = departments.id |
| shortcuts | chats.department_id = shortcuts.departments chats.history.prev_department_id = shortcuts.departments |
| goals | chats.conversions.goal_id = goals.id chats.history.conversion.goal_id = goals.id |
| account | chats.conversions.goal_id = account.plan.goals chats.history.conversion.goal_id = account.plan.goals |
agent_ids
ARRAY
|
agent_names
ARRAY
|
comment
STRING
|
conversions
ARRAY
This is a nested data structure: - attribution: OBJECT, which is also a nested data structure.
- agent_id: INTEGER
- agent_name: STRING
- chat_timestamp: DATE-TIME
- department_id: INTEGER
- department_name: STRING
- goal_id: INTEGER
- goal_name: STRING
- id: STRING
- timestamp: DATE-TIME
|
count
OBJECT
This is a nested data structure: - agent: INTEGER
- total: INTEGER
- visitor: INTEGER
|
department_id
INTEGER
|
department_name
STRING
|
duration
INTEGER
|
end_timestamp
DATE-TIME
|
history
ARRAY
This is a nested data structure: - channel: STRING
- conversion: OBJECT, which is also a nested data structure.
- attribution: OBJECT, which is also a nested data structure.
- agent_id: INTEGER
- agent_name: STRING
- chat_timestamp: DATE-TIME
- department_id: INTEGER
- department_name: STRING
- goal_id: INTEGER
- goal_name: STRING
- id: STRING
- timestamp: DATE-TIME
- department_id: INTEGER, STRING
- department_name: STRING
- msg: STRING
- msg_id: STRING, INTEGER
- name: STRING
- new_rating: STRING
- new_tags: ARRAY
- nick: STRING
- options: STRING
- prev_department_id: INTEGER, STRING
- rating: STRING
- skills_name: ARRAY
- tags: ARRAY
- timestamp: DATE-TIME
- type: STRING
|
id
STRING
|
message
STRING
|
missed
BOOLEAN
|
rating
STRING
|
referrer_search_engine
STRING
|
referrer_search_terms
STRING
|
response_time
OBJECT
This is a nested data structure: - avg: NUMBER, INTEGER
- first: INTEGER
- max: INTEGER
|
session
OBJECT
|
started_by
STRING
|
tags
ARRAY
|
timestamp
DATE-TIME
|
triggered
BOOLEAN
|
triggered_response
BOOLEAN
|
type
STRING
|
unread
BOOLEAN, INTEGER
|
visitor
OBJECT
This is a nested data structure: - email: STRING
- id: STRING
- name: STRING
- notes: STRING
- phone: STRING
|
webpath
ARRAY
|
zendesk_ticket_id
INTEGER
|
departments
The departments table contains info about departments within your Zendesk Chat account.
| Join departments with | on |
|---|
| shortcuts | departments.id = shortcuts.departments |
| chats | departments.id = chats.department_id departments.id = chats.history.prev_department_id |
| agents | departments.id = agents.departments |
description
STRING
|
enabled
BOOLEAN
|
id
INTEGER
|
members
ARRAY
|
name
STRING
|
settings
OBJECT
|
goals
The goals table contains info about URL-based goals set within your Zendesk Chat account.
| Join goals with | on |
|---|
| chats | goals.id = chats.conversions.goal_id goals.id = chats.history.conversion.goal_id |
| account | goals.id = account.plan.goals |
attribution_model
STRING
|
attribution_period
INTEGER
|
description
STRING
|
enabled
BOOLEAN
|
id
INTEGER
|
name
STRING
|
settings
OBJECT
This is a nested data structure: - conditions: ARRAY, which is also a nested data structure.
- operator: STRING
- type: STRING
- value: STRING
|
shortcuts
The shortcuts table contains info about shortcuts within your Zendesk Chat account.
| Join shortcuts with | on |
|---|
| departments | shortcuts.departments = departments.id |
| chats | shortcuts.departments = chats.department_id shortcuts.departments = chats.history.prev_department_id |
| agents | shortcuts.departments = agents.departments |
agents
ARRAY
|
departments
ARRAY
|
id
STRING
|
message
STRING
|
name
STRING
|
options
STRING
|
scope
STRING
|
tags
ARRAY
|
triggers
The triggers table contains info about triggers within your Zendesk Chat account.
definition
OBJECT
This is a nested data structure: - actions: STRING
- condition: STRING
- event: STRING
- version: INTEGER
|
description
STRING
|
enabled
BOOLEAN
|
id
INTEGER
|
name
STRING
|
