Freshservice (預覽)

Freshservice 是一種基於雲的 IT 服務台和服務管理解決方案，易於設置和使用，可改變整個組織的員工體驗。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	Freshworks 應用程序支持
URL	https://www.freshworks.com
Email	appsupport-ex@freshworks.com

連接器中繼資料
Publisher	Microsoft
網站	https://www.freshworks.com/freshservice/lp/home/
隱私策略	https://www.freshworks.com/privacy
類別	資訊科技營運

Authentication

這很重要

FreshService 不再支援以使用者名稱和密碼為基礎的鑑別。連接器現在僅支援一種驗證類型 - API 金鑰。 FreshService API 遷移文檔

正在建立連線

連接器支援下列驗證類型：


API 金鑰	API 金鑰驗證類型	所有區域	不可共享
預設值 [已棄用]	此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。	所有區域	不可共享

API 金鑰

驗證 ID：基本

適用：所有地區

API 金鑰驗證類型

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	字串	此 API 的 API 金鑰	對
網站網址	字串	根網站網址（範例： https://sample.freshservice.com ）	對

預設值 [已棄用]

適用：所有地區

此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
用戶名稱	字串	此 API 的使用者名稱	對
密碼	securestring	此 API 的密碼	對
網站網址	字串	根網站網址（範例： https://sample.freshservice.com ）	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒
觸發輪詢的頻率	1	120 秒

動作

在票證中新增備註（V2）	將私人或公開附註新增至票證。
在票證中新增附註 [已棄用]	將私人或公開附註新增至票證。
建立票證 [已棄用]	建立票證。
建立票證（V2）	建立票證。
更新票證 [已棄用]	更新票證（僅更新指定的值）。
更新票證（V2）	更新票證（僅更新指定的值）。

在票證中新增備註（V2）

作業識別碼：: AddNoteV2

將私人或公開附註新增至票證。

參數

名稱	機碼	必要	類型	Description
票證 ID	ticketId	True	integer	要更新的票證 ID。
備註	body	True	string	要添加到票據的註釋。
是私人	private		boolean	如果訊息是私人的，則設為 true。

傳回

身體: AddNote_ResponseV2

在票證中新增附註 [已棄用]

作業識別碼：: AddNote

將私人或公開附註新增至票證。

參數

名稱	機碼	必要	類型	Description
票證 ID	ticketId	True	integer	要更新的票證 ID。
備註	body	True	string	要添加到票據的註釋。
是私人	private		boolean	如果訊息是私人的，則設為 true。

傳回

身體: AddNote_Response

建立票證 [已棄用]

作業識別碼：: CreateTicket

建立票證。

參數

名稱	機碼	必要	類型	Description
要求者識別碼	requester_id	True	integer	要求者的使用者識別碼。對於現有聯絡人，可以傳遞requester_id而不是電子郵件。
主旨	subject	True	string	票證的主題。
地位	status	True	string	票證的狀態。
Priority	priority	True	string	票證的優先順序（例如低、中或高）。
Description	description	True	string	票證的說明。
急迫性	urgency		string	問題的緊急性（例如低、中或高）。
Impact	impact		string	問題的影響（例如低、中或高）。
來源	source		string	建立票證的管道。

傳回

名稱	路徑	類型	Description
helpdesk_ticket	item.helpdesk_ticket	Ticket_Response

建立票證（V2）

作業識別碼：: CreateTicketV2

建立票證。

參數

名稱	機碼	必要	類型	Description
要求者識別碼	requester_id		integer	要求者的使用者識別碼。需要請求者 ID、請求者電子郵件和請求者電話之一
請求者電子郵件	email		string	請求者的電子郵件。需要請求者 ID、請求者電子郵件和請求者電話之一
請求者電話	phone		string	請求者的電話號碼。需要請求者 ID、請求者電子郵件和請求者電話之一
請求者名稱	name		string	要求者的名稱。只有在提供請求者電話值時，這是必填欄位
主旨	subject	True	string	票證的主題。
地位	status	True	string	票證的狀態。
Priority	priority	True	string	票證的優先順序（例如低、中或高）。
Description	description	True	string	票證的說明。
急迫性	urgency		string	問題的緊急性（例如低、中或高）。
Impact	impact		string	問題的影響（例如低、中或高）。
來源	source		string	建立票證的管道。

傳回

身體: CreateUpdateTicket_ResponseV2

更新票證 [已棄用]

作業識別碼：: UpdateTicket

更新票證（僅更新指定的值）。

參數

名稱	機碼	必要	類型	Description
票證 ID	ticketId	True	integer	要更新的票證 ID。
要求者識別碼	requester_id		integer	要求者的使用者識別碼。對於現有聯絡人，可以傳遞requester_id而不是電子郵件。
主旨	subject		string	票證的主題。
地位	status		string	票證的狀態。
Priority	priority		string	票證的優先順序（例如低、中或高）。
急迫性	urgency		string	問題的緊急性（例如低、中或高）。
Impact	impact		string	問題的影響（例如低、中或高）。
來源	source		string	建立票證的管道。

傳回

身體: UpdateTicket_Response

更新票證（V2）

作業識別碼：: UpdateTicketV2

更新票證（僅更新指定的值）。

參數

名稱	機碼	必要	類型	Description
票證 ID	ticketId	True	integer	要更新的票證 ID。
要求者識別碼	requester_id		integer	要求者的使用者識別碼。對於現有聯絡人，可以傳遞requester_id而不是電子郵件。
主旨	subject		string	票證的主題。
地位	status		string	票證的狀態。
Priority	priority		string	票證的優先順序（例如低、中或高）。
急迫性	urgency		string	問題的緊急性（例如低、中或高）。
Impact	impact		string	問題的影響（例如低、中或高）。
來源	source		string	建立票證的管道。

傳回

身體: CreateUpdateTicket_ResponseV2

觸發程序

建立票證時 [已棄用]	建立新票證時觸發。
建立票證時（V2）	建立新票證時觸發。

建立票證時 [已棄用]

作業識別碼：: OnTicketCreated

建立新票證時觸發。

傳回

身體: Ticket_Response

建立票證時（V2）

作業識別碼：: OnTicketCreatedV2

建立新票證時觸發。

傳回

身體: ListTicket_ResponseV2

定義

Ticket_Response

名稱	路徑	類型	Description
創建於 Date-Time	created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
已刪除	deleted	boolean	如果票證被刪除/丟棄，則設定為 true。除「已刪除」篩選器外，任何檢視都不會考慮已刪除的票證。
部門識別碼	department_id_value	integer
票證 ID	display_id	integer	您帳戶專屬的票證 ID。
到期日期 Date-Time	due_by	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
群組識別碼	group_id	integer	指派票證的群組 ID。
Id	id	integer	票證的唯一 ID。
Impact	impact	integer	代表問題影響的數字。
已升級	isescalated	boolean	如果已傳送呈報，則設為 true。
擁有者識別碼	owner_id	string	指派問題之代理程式的 ID。
Priority	priority	integer	代表票證優先順序的數字。
要求者識別碼	requester_id	integer	要求者的使用者識別碼。對於現有聯絡人，可以傳遞requester_id而不是電子郵件。
回應者識別碼	responder_id	integer	指派票證的客服專員的 ID。
來源	source	integer	代表建立票證的管道的數字。
垃圾郵件	spam	boolean	如果票證標示為垃圾郵件，則設定為 true。
地位	status	integer	代表票證狀態的數字。
主旨	subject	string	票證主題。
門票類型	ticket_type	string	輸入票證欄位中定義的屬性欄位。
發送電子郵件	to_email	string	傳送傳入票證電子郵件的電子郵件地址。
更新於 Date-Time	updated_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
急迫性	urgency	integer	代表問題緊急性的數字。
Description	description	string	問題描述。
說明 HTML	description_html	string	票證的 HTML 內容。描述和description_html不應一起傳遞。
狀態名稱	status_name	string	票證的狀態。
優先順序名稱	priority_name	string	票證的優先順序。
來源名稱	source_name	string	建立票證的管道。
回應者名稱	responder_name	string	指派票證的客服專員名稱。
前往電子郵件	to_emails	array of string	傳送傳入票證電子郵件的電子郵件地址。
部門名稱	department_name	string	部門名稱。
相關聯的問題標識碼	assoc_problem_id	integer	與摘記卷相關聯的問題的 ID。
相關聯的變更識別碼	assoc_change_id	integer	問題相關聯變更的 ID。
相關聯的變更原因識別碼	assoc_change_cause_id	integer	造成票證之變更的標識碼。
相關聯的資產識別碼	assoc_asset_id	integer	與票證相關聯的資產 ID。
緊急性名稱	urgency_name	string	問題的緊迫性。
影響名稱	impact_name	string	問題的影響。

CreateUpdateTicket_ResponseV2

名稱	路徑	類型	Description
創建於 Date-Time	ticket.created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
部門識別碼	ticket.department_id	integer
到期日期 Date-Time	ticket.due_by	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
群組識別碼	ticket.group_id	integer	指派票證的群組 ID。
Id	ticket.id	integer	票證的唯一 ID。
已升級	ticket.is_escalated	boolean	如果已傳送呈報，則設為 true。
Priority	ticket.priority	integer	代表票證優先順序的數字。
要求者識別碼	ticket.requester_id	integer	要求者的使用者識別碼。對於現有聯絡人，可以傳遞requester_id而不是電子郵件。
回應者識別碼	ticket.responder_id	integer	指派票證的客服專員的 ID。
來源	ticket.source	integer	代表建立票證的管道的數字。
垃圾郵件	ticket.spam	boolean	如果票證標示為垃圾郵件，則設定為 true。
地位	ticket.status	integer	代表票證狀態的數字。
主旨	ticket.subject	string	票證主題。
門票類型	ticket.type	string	輸入票證欄位中定義的屬性欄位。
更新於 Date-Time	ticket.updated_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
Description	ticket.description_text	string	問題描述。
說明 HTML	ticket.description	string	票證的 HTML 內容。描述和description_html不應一起傳遞。
前往電子郵件	ticket.to_emails	array of string	傳送傳入票證電子郵件的電子郵件地址。

ListTicket_ResponseV2

名稱	路徑	類型	Description
創建於 Date-Time	created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
部門識別碼	department_id	integer
到期日期 Date-Time	due_by	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
群組識別碼	group_id	integer	指派票證的群組 ID。
Id	id	integer	票證的唯一 ID。
已升級	is_escalated	boolean	如果已傳送呈報，則設為 true。
Priority	priority	integer	代表票證優先順序的數字。
要求者識別碼	requester_id	integer	要求者的使用者識別碼。對於現有聯絡人，可以傳遞requester_id而不是電子郵件。
回應者識別碼	responder_id	integer	指派票證的客服專員的 ID。
來源	source	integer	代表建立票證的管道的數字。
垃圾郵件	spam	boolean	如果票證標示為垃圾郵件，則設定為 true。
地位	status	integer	代表票證狀態的數字。
主旨	subject	string	票證主題。
門票類型	type	string	輸入票證欄位中定義的屬性欄位。
更新於 Date-Time	updated_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
Description	description_text	string	問題描述。
說明 HTML	description	string	票證的 HTML 內容。描述和description_html不應一起傳遞。
前往電子郵件	to_emails	array of string	傳送傳入票證電子郵件的電子郵件地址。

UpdateTicket_Response

名稱	路徑	類型	Description
已刪除	ticket.deleted	boolean	如果票證被刪除/丟棄，則設定為 true。除「已刪除」篩選器外，任何檢視都不會考慮已刪除的票證。
票證 ID	ticket.display_id	integer	您帳戶專屬的票證 ID。
主旨	ticket.subject	string	票證主題。
Description	ticket.description	string	票證說明。
說明 HTML	ticket.description_html	string	票證的 HTML 內容。描述和description_html不應一起傳遞。
狀態名稱	ticket.status_name	string	票證的狀態。
優先順序名稱	ticket.priority_name	string	票證的優先順序。
來源名稱	ticket.source_name	string	建立票證的管道。
回應者名稱	ticket.responder_name	string	指派票證的客服專員名稱。
前往電子郵件	ticket.to_emails	array of string	傳送傳入票證電子郵件的電子郵件地址。
部門名稱	ticket.department_name	string	部門名稱。
相關聯的問題標識碼	ticket.assoc_problem_id	integer	與摘記卷相關聯的問題的 ID。
相關聯的變更識別碼	ticket.assoc_change_id	integer	問題相關聯變更的 ID。
相關聯的變更原因識別碼	ticket.assoc_change_cause_id	integer	造成票證之變更的標識碼。
相關聯的資產識別碼	ticket.assoc_asset_id	integer	與票證相關聯的資產 ID。
緊急性名稱	ticket.urgency_name	string	問題的緊迫性。
影響名稱	ticket.impact_name	string	問題的影響。

AddNote_Response

名稱	路徑	類型	Description
創建於 Date-Time	note.created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
已刪除	note.deleted	boolean	如果票證被刪除/丟棄，則設定為 true。除「已刪除」篩選器外，任何檢視都不會考慮已刪除的票證。
Id	note.id	integer	附註的唯一 ID。
私人	note.private	boolean	如果筆記是私人的，則設定為 true。
來源	note.source	integer	代表建立票證的管道的數字。
更新於 Date-Time	note.updated_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
使用者識別碼	note.user_id	integer	新增附註的客服專員的User_id。
身體	note.body	string	純文字的註釋內容。
正文HTML	note.body_html	string	HTML 格式的筆記內容。必須通過身體或body_html。
attachments	note.attachments	array of string

AddNote_ResponseV2

名稱	路徑	類型	Description
創建於 Date-Time	conversation.created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
Id	conversation.id	integer	附註的唯一 ID。
私人	conversation.private	boolean	如果筆記是私人的，則設定為 true。
更新於 Date-Time	conversation.updated_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
使用者識別碼	conversation.user_id	integer	新增附註的客服專員的User_id。
身體	conversation.body_text	string	純文字的註釋內容。
正文HTML	conversation.body	string	HTML 格式的筆記內容。必須通過身體或body_html。
attachments	conversation.attachments	array of string
票證 ID	conversation.ticket_id	integer	票證的唯一 ID。

共用方式為