Freshdesk

Freshdesk 是基于云的客户支持解决方案，可帮助你简化客户服务并确保客户获得他们应得的支持！ Freshdesk 连接器适用于 Freshdesk 代理来管理票证和联系人。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	标准	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 中国区域 - 美国国防部（DoD）
Power Apps	标准	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	标准	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	Microsoft
URL	Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持

连接器元数据
发布者	Microsoft
网站	https://freshdesk.com/
隐私策略	https://www.freshworks.com/privacy/

已知问题和限制

对于触发器“创建票证时”、“分配给代理的票证更新时”、“更新票证时”说明在响应中默认不返回票证的说明。可以通过将“Include description”参数设置为“是”来指定将其包含在触发器响应中。但是，请注意，这与 Freshdesk 端帐户的额外费用相关联，因为在这种情况下使用嵌入。如果需要票证的说明，建议将触发器与“获取票证”作结合使用，因为此作的响应默认包含说明。
目前不支持创建票证类型“服务任务”。

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
帐户 URL	字符串	例如： https://company.freshdesk.com	True
电子邮件或 API 密钥（https://aka.ms/ii9u75）	字符串	你的电子邮件地址	True
密码	securestring	密码（如果使用 API 密钥，则可以指定任何值）	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒
触发器轮询的频率	1	15 秒

操作

创建票证	创建票证。
向票证添加备注	向票证添加私人或公共备注。
更新票证	更新票证（只会更新指定的值）。
获取票证	按 ID 获取票证。

创建票证

操作 ID:: CreateTicket

创建票证。

参数

名称	密钥	必需	类型	说明
Subject	subject	True	string	票证的主题。
Description	description	True	string	票证的说明。
Email	email	True	string	请求者的电子邮件。
Priority	priority	True	string	票证的优先级。
状态	status	True	string	票证的状态。
类型	type		string	根据支持团队处理的各种问题帮助对票证进行分类。
Due By	due_by		date-time	表示票证何时要解析的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
第一个响应截止日期	fr_due_by		date-time	表示第一个响应到期时的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
代理人	responder_id		integer	票证的代理。
产品	product_id		integer	票证应属于的产品（仅供管理员使用）。

Body: CreateTicket200Response

向票证添加备注

操作 ID:: AddNote

向票证添加私人或公共备注。

参数

名称	密钥	必需	类型	说明
票证 ID	ticketId	True	integer	要向其添加注释的票证 ID。
Content	body	True	string	备注的内容。
专用	private		boolean	指示这是私人笔记（默认值为 true）。

Body: AddNote200Response

更新票证

操作 ID:: UpdateTicket

更新票证（只会更新指定的值）。

参数

名称	密钥	必需	类型	说明
票证 ID	ticketId	True	integer	要更新的票证 ID。
Description	description		string	票证说明。
Subject	subject		string	票证的主题。
Priority	priority		string	票证的优先级。
状态	status		string	票证的状态。
类型	type		string	根据支持团队处理的各种问题帮助对票证进行分类。
Due By	due_by		date-time	表示票证何时要解析的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
代理人	responder_id		integer	票证的代理。

Body: CreateTicket200Response

获取票证

操作 ID:: GetTicket

按 ID 获取票证。

参数

名称	密钥	必需	类型	说明
票证 ID	ticketId	True	string	票证 ID。

Body: CreateTicket200Response

触发器

创建票证时	创建任何票证时。
更新分配给代理的票证时	更新分配给所选代理的任何票证时。
更新票证时	更新票证时。
添加代理时	添加代理时（仅供管理员使用）。仅当 Freshdesk 帐户少于 100 个代理时，此触发器才有效。
添加联系人时	添加联系人时。仅当 Freshdesk 帐户少于 100 个联系人时，此触发器才有效。
票证状态更改时	票证的状态发生更改时。

创建票证时

操作 ID:: TriggerTicketCreated

创建任何票证时。

参数

名称	密钥	必需	类型	说明
包括说明	includeDescription		boolean	触发器的响应是否包括说明。

Body: CreateTicket200Response

更新分配给代理的票证时

操作 ID:: TriggerTicketAssignedToAgent

更新分配给所选代理的任何票证时。

参数

名称	密钥	必需	类型	说明
代理 ID	agentId	True	integer	代理 ID。
包括说明	includeDescription		boolean	触发器的响应是否包括说明。

Body: CreateTicket200Response

更新票证时

操作 ID:: TriggerTicketUpdated

更新票证时。

参数

名称	密钥	必需	类型	说明
票证 ID	ticketId		integer	票证 ID。
包括说明	includeDescription		boolean	触发器的响应是否包括说明。

Body: CreateTicket200Response

添加代理时

操作 ID:: TriggerAgentAdded

添加代理时（仅供管理员使用）。仅当 Freshdesk 帐户少于 100 个代理时，此触发器才有效。

名称	路径	类型	说明
id	id	integer	id
票证范围	ticket_scope	integer	代理的票证权限。
创建时间	created_at	date-time	代理创建时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
已更新时间	updated_at	date-time	代理更新了时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
活跃	contact.active	boolean	如果验证代理，则设置为 true。
Email	contact.email	string	代理的电子邮件地址。
职务	contact.job_title	string	代理的职务。
语言	contact.language	string	代理的语言。
上次登录时间	contact.last_login_at	date-time	代理上次成功登录的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
手机	contact.mobile	string	代理的移动电话号码。
Name	contact.name	string	代理的名称。
电话	contact.phone	string	代理的电话号码。
时区	contact.time_zone	string	代理的时区。
创建时间	contact.created_at	date-time	代理创建时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
已更新时间	contact.updated_at	date-time	上次更新代理的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。

添加联系人时

操作 ID:: TriggerContactAdded

添加联系人时。仅当 Freshdesk 帐户少于 100 个联系人时，此触发器才有效。

名称	路径	类型	说明
活跃	active	boolean	如果已验证联系人，则设置为 true。
地址	address	string	联系人的地址。
公司 ID	company_id	integer	此联系人所属的公司 ID。
Description	description	string	联系人的简短说明。
Email	email	string	联系人的主要电子邮件地址。
Id	id	integer	联系人的 ID。
职务	job_title	string	联系人的职务。
语言	language	string	联系人的语言。
手机	mobile	string	联系人的移动电话号码。
Name	name	string	联系人的名称。
电话	phone	string	联系人的电话号码。
时区	time_zone	string	联系人所在的时区。
Twitter Id	twitter_id	string	联系人的 Twitter 句柄。
创建时间	created_at	date-time	联系人创建时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
已更新时间	updated_at	date-time	联系人更新的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。

票证状态更改时

操作 ID:: TriggerTicketStatusChanged

票证的状态发生更改时。

参数

名称	密钥	必需	类型	说明
票证 ID	ticketId	True	integer	票证 ID。
新建状态	status		string	票证的新状态。

Body: CreateTicket200Response

定义

CreateTicket200Response

名称	路径	类型	说明
垃圾邮件	spam	boolean	如果票证标记为垃圾邮件，则设置为 true。
Priority	priority	string	票证的优先级。
请求者 ID	requester_id	integer	请求者的用户 ID。
代理 ID	responder_id	integer	已向其分配票证的代理的 ID。
来源	source	string	通过该通道创建票证。
状态	status	string	票证的状态。
Subject	subject	string	票证的主题。
票证 ID	id	integer	票证的唯一 ID。
类型	type	string	根据支持团队处理的各种问题帮助对票证进行分类。
Due By	due_by	date-time	表示票证何时要解析的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
已升级	is_escalated	boolean	如果票证因任何原因升级，则设置为 true。
Description	description	string	票证的 HTML 内容。
说明文本	description_text	string	纯文本票证的内容。
创建时间	created_at	date-time	票证创建时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
已更新时间	updated_at	date-time	票证更新时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
已删除	deleted	boolean	如果票证已删除，则设置为 true。

AddNote200Response

名称	路径	类型	说明
专用	private	boolean	如果笔记是私有的，则设置为 true。
Content	body	string	HTML 中备注的内容。
内容文本	body_text	string	以纯文本形式显示备注的内容。
票证 ID	ticket_id	integer	要向其添加此注释的票证的 ID。
创建时间	created_at	date-time	注意创建时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。
更新时间	updated_at	date-time	请注意更新的时间戳（格式为 yyyy-MM-ddTHH：mm：ssZ）。

通过