Freshdesk
Freshdesk is an online cloud-based customer support software providing help desk support.
Freshdesk integration replicates data using the Freshdesk REST API.
See the
Schema section for a list of objects available for replication.
对这个连接器进行高级查看，包括有用的链接和支持的特性。
| 特性/功能 | 支持详情 |
|---|
| 支持的 Qlik Talend Data Integration 项目 | 仅 Replication 项目。不支持数据管道项目。 |
目标更新方法 | 复制任务： 在数据湖任务中登陆数据： |
管理元数据 | 无需手动生成元数据。 |
模式演变 | 只支持更改列数据类型操作。 |
| 复制 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.
信息注释请确保您使用的帐户对要获取的表具有读取权限。
Creating the connection
有关更多信息，请参阅连接到 SaaS 应用程序。
- 填写所需的连接属性。
在连接名称中提供连接的名称。
选择打开连接元数据以定义创建连接时的元数据。
单击创建。
Connection settings| Setting | Description |
|---|
| Data gateway | 如果您的用例需要，请选择一个 数据移动网关。 信息注释此字段不适用于 Qlik Talend Cloud Starter 订阅，因为它不支持 数据移动网关。如果您有另一个订阅层并且不想使用 数据移动网关，请选择无。 有关 数据移动网关 的优势和需要它的用例的信息，请参阅Qlik 数据网关 - 数据移动。 |
| Start Date | 按格式 MM/DD/YYYY 输入必须将数据从源复制到目标的日期。 |
| Subdomain | You can find your subdomain in the URL of your Freshdesk account. If the URL is your-org-name.freshdesk.com, the subdomain is your-org-name. |
| API Key | API key. |
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.
agents
The agents table contains info about the agents in your Freshdesk account.
| Join agents with | on |
|---|
| groups | agents.id = groups.agent_ids agents.group_ids.type = groups.id |
| satisfaction_ratings | agents.id = satisfaction_ratings.agent_id agents.group_ids.type = satisfaction_ratings.group_id |
| tickets | agents.id = tickets.responder_id agents.group_ids.type = tickets.group_id |
| time_entries | agents.id = time_entries.agent_id |
| roles | agents.role_ids.type = roles.id |
available
BOOLEAN
|
available_since
DATE-TIME
|
contact
OBJECT
This is a nested data structure: - active: BOOLEAN
- created_at: DATE-TIME
- email: STRING
- job_title: STRING
- language: STRING
- last_login_at: DATE-TIME
- mobile: STRING
- name: STRING
- phone: STRING
- time_zone: STRING
- updated_at: DATE-TIME
|
created_at
DATE-TIME
|
group_ids
ARRAY
This is a nested data structure. |
id
INTEGER
|
occasional
BOOLEAN
|
role_ids
ARRAY
This is a nested data structure. |
signature
STRING
|
ticket_scope
INTEGER
|
updated_at
DATE-TIME
|
companies
The companies table contains info about the companies your various customers and contacts belong to.
Custom Fields
If applicable, Stitch will replicate custom fields related to companies in Freshdesk.
| Join companies with | on |
|---|
| tickets | companies.id = tickets.company_id |
created_at
DATE-TIME
|
custom_fields
ARRAY
This is a nested data structure: - name: STRING
- value: STRING
|
description
STRING
|
domains
ARRAY
This is a nested data structure. |
id
INTEGER
|
name
STRING
|
note
STRING
|
updated_at
DATE-TIME
|
conversations
The conversations table contains info about replies and public/private notes added to the tickets in your Freshdesk account.
| Join conversations with | on |
|---|
| tickets | conversations.ticket_id = tickets.id |
| satisfaction_ratings | conversations.ticket_id = satisfaction_ratings.ticket_id |
bcc_emails
ARRAY
This is a nested data structure. |
body_text
STRING
|
cc_emails
ARRAY
This is a nested data structure. |
created_at
DATE-TIME
|
from_email
STRING
|
id
INTEGER
|
incoming
BOOLEAN
|
private
BOOLEAN
|
source
INTEGER
|
support_email
STRING
|
ticket_id
INTEGER
|
to_emails
ARRAY
This is a nested data structure. |
updated_at
DATE-TIME
|
user_id
INTEGER
|
groups
The groups table contains info about the groups your agents belong to.
| Join groups with | on |
|---|
| agents | groups.agent_ids = agents.id groups.id = agents.group_ids.type |
| satisfaction_ratings | groups.agent_ids = satisfaction_ratings.agent_id groups.id = satisfaction_ratings.group_id |
| tickets | groups.agent_ids = tickets.responder_id groups.id = tickets.group_id |
| time_entries | groups.agent_ids = time_entries.agent_id |
agent_ids
ARRAY
This is a nested data structure. |
auto_ticket_assign
INTEGER, BOOLEAN
|
business_hour_id
INTEGER
|
created_at
DATE-TIME
|
description
STRING
|
escalate_to
INTEGER
|
id
INTEGER
|
name
STRING
|
unassigned_for
STRING
|
updated_at
DATE-TIME
|
roles
The roles table contains info about the various roles that can be assigned to team members in your Freshdesk account.
| Join roles with | on |
|---|
| agents | roles.id = agents.role_ids.type |
created_at
DATE-TIME
|
default
BOOLEAN
|
description
STRING
|
id
INTEGER
|
name
STRING
|
updated_at
DATE-TIME
|
satisfaction_ratings
The satisfaction_ratings table contains info about customer satisfaction survey responses, or satisfaction ratings.
| Join satisfaction_ratings with | on |
|---|
| agents | satisfaction_ratings.agent_id = agents.id satisfaction_ratings.group_id = agents.group_ids.type |
| groups | satisfaction_ratings.agent_id = groups.agent_ids satisfaction_ratings.group_id = groups.id |
| tickets | satisfaction_ratings.agent_id = tickets.responder_id satisfaction_ratings.group_id = tickets.group_id satisfaction_ratings.ticket_id = tickets.id |
| time_entries | satisfaction_ratings.agent_id = time_entries.agent_id |
| conversations | satisfaction_ratings.ticket_id = conversations.ticket_id |
agent_id
INTEGER
|
created_at
DATE-TIME
|
feedback
STRING
|
group_id
INTEGER
|
id
INTEGER
|
ratings
ARRAY
This is a nested data structure: - question: STRING
- value: INTEGER
|
survey_id
INTEGER
|
ticket_id
INTEGER
|
updated_at
DATE-TIME
|
user_id
INTEGER
|
tickets
The tickets table contains info about the tickets in your Freshdesk account.
Custom Fields
If applicable, Stitch will replicate custom fields related to tickets in Freshdesk.
| Join tickets with | on |
|---|
| agents | tickets.responder_id = agents.id tickets.group_id = agents.group_ids.type |
| groups | tickets.responder_id = groups.agent_ids tickets.group_id = groups.id |
| satisfaction_ratings | tickets.responder_id = satisfaction_ratings.agent_id tickets.group_id = satisfaction_ratings.group_id tickets.id = satisfaction_ratings.ticket_id |
| time_entries | tickets.responder_id = time_entries.agent_id |
| companies | tickets.company_id = companies.id |
| conversations | tickets.id = conversations.ticket_id |
cc_emails
ARRAY
This is a nested data structure. |
company
OBJECT
This is a nested data structure: |
company_id
INTEGER
|
created_at
DATE-TIME
|
custom_fields
ARRAY
This is a nested data structure: - name: STRING
- value: STRING
|
deleted
BOOLEAN
|
description
STRING
|
description_text
STRING
|
due_by
DATE-TIME
|
email
STRING
|
email_config_id
INTEGER
|
facebook_id
STRING
|
fr_due_by
DATE-TIME
|
fr_escalated
BOOLEAN
|
fwd_emails
ARRAY
This is a nested data structure. |
group_id
INTEGER
|
id
INTEGER
|
is_escalated
BOOLEAN
|
name
STRING
|
phone
STRING
|
priority
NUMBER
|
product_id
INTEGER
|
reply_cc_emails
ARRAY
This is a nested data structure. |
requester
OBJECT
This is a nested data structure: - email: STRING
- id: INTEGER
- mobile: STRING
- name: STRING
- phone: STRING
|
requester_id
INTEGER
|
responder_id
INTEGER
|
source
NUMBER
|
spam
BOOLEAN
|
stats
OBJECT
This is a nested data structure: - closed_at: DATE-TIME
- first_responded_at: DATE-TIME
- resolved_at: DATE-TIME
|
status
NUMBER
|
subject
STRING
|
tags
ARRAY
This is a nested data structure. |
to_emails
ARRAY
This is a nested data structure. |
twitter_id
STRING
|
type
STRING
|
updated_at
DATE-TIME
|
time_entries
The time_entries table contains info about the time entries entered by agents working on tickets.
| Join time_entries with | on |
|---|
| agents | time_entries.agent_id = agents.id |
| groups | time_entries.agent_id = groups.agent_ids |
| satisfaction_ratings | time_entries.agent_id = satisfaction_ratings.agent_id |
| tickets | time_entries.agent_id = tickets.responder_id |
agent_id
INTEGER
|
billable
BOOLEAN
|
created_at
DATE-TIME
|
executed_at
DATE-TIME
|
id
INTEGER
|
note
STRING
|
start_time
DATE-TIME
|
ticket_id
INTEGER
|
time_spent
STRING
|
timer_running
BOOLEAN
|
updated_at
DATE-TIME
|
