DeskDirector

DeskDirector 自動化並加速用戶和技術人員工作 IT 服務之間基於票證的工作流程。 DeskDirector 連接器是我們豐富的票務平台的深入而強大的整合。票證生命週期的所有階段都可以自動化和增強，以獲得卓越的服務體驗。

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

服務	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）

連絡人
名稱	DeskDirector 支援
URL	https://support.deskdirector.com
Email	support@deskdirector.com

連接器中繼資料
Publisher	DeskDirector
網站	https://www.deskdirector.com
隱私策略	https://www.deskdirector.com/privacy-policy
類別	IT運營;生產力

DeskDirector 是一個以用戶為中心、基於雲的票務系統，用於 IT 支持和一般服務管理。 DeskDirector 開箱即用，非常可配置。但是，當您需要更多服務選項時，您可以使用這個功能廣泛的連接器擴展 DeskDirector 出色的服務功能和服務範圍。

先決條件

您需要具有流程連接器功能的作用中 DeskDirector 訂閱才能使用 DeskDirector 連接器，您可以在此處閱讀我們的定價。

如何取得認證

設定新連線時，系統會要求您提供 API 金鑰，金鑰可以從您的管理入口網站產生或擷取，請參閱此處的檔。

開始使用連接器

請在此處閱讀我們有關開始使用 DeskDirector 連接器的分步指南。

FAQ

閱讀我們知識庫中的常見問題解答請點擊這裡.

正在建立連線

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


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

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

名稱	類型	Description	為必填項目
網站主機	字串	根網站網址（範例：support.deskdirector.com）	對
API 金鑰	securestring	DeskDirector API 金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

傳送通知給成員	此作業會傳送通知給技術入口網站中的成員。
傳送通知給連絡人	此操作會向客戶端入口網站中的聯絡人傳送通知。
取得會員	此作業會傳回成員的詳細資料。
取得票證任務	此作業會傳回所有摘記卷工作清單。
取得聊天會話	此作業會傳回聊天會話的詳細資料。
取得聯絡方式	此操作會傳回聯絡人的詳細資料。
取得表單結果	此作業會依表單結果識別碼傳回表單專案。
取得表單結果（已淘汰） [已淘汰]	此動作已被取代。請改用取得表單結果。 ~~此作業會依表單結果識別碼傳回表單專案（已棄用）。~~
取得門票	此作業會傳回票證的詳細資料。
回應進階事件	回應進階事件。
在聊天室中傳送系統訊息	此作業會在聊天會話中傳送系統訊息。
執行進階動作	進階動作可讓您自動執行不太常用但提供有價值的功能來簡化任務的專用操作。
尋找使用者群組	按關鍵字或過濾器查找用戶組。
尋找公司	通過關鍵字或過濾器查找公司。
尋找成員	通過關鍵字或過濾器查找成員。
尋找票證	通過關鍵字或過濾器查找票證。
尋找票證工作範本	按關鍵字或過濾器查找票證任務模板。
尋找聯絡人	通過關鍵字或過濾器查找聯繫人。
建立票證	此作業會建立票證。
建立票證工作	此作業會從範本或從頭開始建立票證工作。
建立聯絡人	此作業會建立連絡人。
從範本建立電子郵件	此作業會從動態電子郵件範本產生HTML檔案。動態電子郵件範本可以在您的管理入口網站中進行管理。
找一家公司	此作業會傳回公司的詳細資料。
更新票證	此作業會更新票證。
邀請使用者聊天	此作業會邀請使用者加入聊天會話。

傳送通知給成員

作業識別碼：: CreateMemberNotification

此作業會傳送通知給技術入口網站中的成員。

參數

名稱	機碼	必要	類型	Description
會員編號	memberId	True	integer	指定成員的 ID
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

傳送通知給連絡人

作業識別碼：: CreateContactNotification

此操作會向客戶端入口網站中的聯絡人傳送通知。

參數

名稱	機碼	必要	類型	Description
連絡人識別碼	contactId	True	integer	指定聯絡人的 ID
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

取得會員

作業識別碼：: GetMember

此作業會傳回成員的詳細資料。

參數

名稱	機碼	必要	類型	Description
會員編號	memberId	True	integer	指定成員的 ID。

傳回

此作業會輸出隨機的結果。

取得票證任務

作業識別碼：: GetTicketTasks

此作業會傳回所有摘記卷工作清單。

參數

名稱	機碼	必要	類型	Description
券	ticketId	True	integer	指定票證的 ID。

傳回

此作業會輸出隨機的結果。

取得聊天會話

作業識別碼：: GetChatSession

此作業會傳回聊天會話的詳細資料。

參數

名稱	機碼	必要	類型	Description
Session	sessionId	True	string	指定聊天工作階段 ID。

傳回

此作業會輸出隨機的結果。

取得聯絡方式

作業識別碼：: GetContact

此操作會傳回聯絡人的詳細資料。

參數

名稱	機碼	必要	類型	Description
連絡人識別碼	contactId	True	integer	指定聯絡人的 ID。

傳回

此作業會輸出隨機的結果。

取得表單結果

作業識別碼：: GetFormResult_V2

此作業會依表單結果識別碼傳回表單專案。

參數

名稱	機碼	必要	類型	Description
Form	formId	True	integer	指定表單。
Result	resultId	True	integer	指定結果 ID。

傳回

此作業會輸出隨機的結果。

取得表單結果（已淘汰） [已淘汰]

作業識別碼：: GetFormResult

此動作已被取代。請改用取得表單結果。

~~此作業會依表單結果識別碼傳回表單專案（已棄用）。~~

參數

名稱	機碼	必要	類型	Description
Form	formId	True	integer	指定表單。
Result	resultId	True	integer	指定結果 ID。

傳回

此作業會輸出隨機的結果。

取得門票

作業識別碼：: GetTicket

此作業會傳回票證的詳細資料。

參數

名稱	機碼	必要	類型	Description
券	ticketId	True	integer	指定票證的 ID。

傳回

此作業會輸出隨機的結果。

回應進階事件

作業識別碼：: AdvancedEventResponseHandle

回應進階事件。

參數

名稱	機碼	必要	類型	Description
類別	category	True	string	從清單中選取事件類別。
Event	eventType	True	string	從清單中選取事件。
事件識別碼	eventId	True	string	指定事件 ID。
要求	req	True	dynamic

傳回

response: object

在聊天室中傳送系統訊息

作業識別碼：: AddChatSystemMessage

此作業會在聊天會話中傳送系統訊息。

參數

名稱	機碼	必要	類型	Description
Session	sessionId	True	string	指定聊天工作階段 ID。
要求	req	True	dynamic

傳回

response: object

執行進階動作

作業識別碼：: CallAdvancedAction

進階動作可讓您自動執行不太常用但提供有價值的功能來簡化任務的專用操作。

參數

名稱	機碼	必要	類型	Description
類別	category	True	string	從清單中選取動作類別。
行動	function	True	string	從清單中選取動作。
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

尋找使用者群組

作業識別碼：: FindUserGroups

按關鍵字或過濾器查找用戶組。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

尋找公司

作業識別碼：: FindCompanies

通過關鍵字或過濾器查找公司。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

尋找成員

作業識別碼：: FindMembers

通過關鍵字或過濾器查找成員。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

尋找票證

作業識別碼：: FindTickets

通過關鍵字或過濾器查找票證。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

尋找票證工作範本

作業識別碼：: FindTicketTaskTemplates

按關鍵字或過濾器查找票證任務模板。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

尋找聯絡人

作業識別碼：: FindContacts

通過關鍵字或過濾器查找聯繫人。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

建立票證

作業識別碼：: CreateTicket

此作業會建立票證。

參數

名稱	機碼	必要	類型	Description
請求類型	requestTypeId	True	integer	指定要求類型。
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

建立票證工作

作業識別碼：: CreateTicketTasks

此作業會從範本或從頭開始建立票證工作。

參數

名稱	機碼	必要	類型	Description
券	ticketId	True	integer	指定票證的 ID。
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

建立聯絡人

作業識別碼：: CreateContact

此作業會建立連絡人。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

從範本建立電子郵件

作業識別碼：: GenerateEmailFromTemplate

此作業會從動態電子郵件範本產生HTML檔案。動態電子郵件範本可以在您的管理入口網站中進行管理。

參數

名稱	機碼	必要	類型	Description
Template	emailTemplateId	True	string	指定電子郵件範本。
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

找一家公司

作業識別碼：: GetCompany

此作業會傳回公司的詳細資料。

參數

名稱	機碼	必要	類型	Description
公司編號	companyId	True	integer	指定公司的 ID。

傳回

此作業會輸出隨機的結果。

更新票證

作業識別碼：: UpdateTicket

此作業會更新票證。

參數

名稱	機碼	必要	類型	Description
要求	req	True	dynamic
券	ticketId	True	integer	指定票證的 ID。

傳回

此作業會輸出隨機的結果。

邀請使用者聊天

作業識別碼：: InviteUsersToChat

此作業會邀請使用者加入聊天會話。

參數

名稱	機碼	必要	類型	Description
Session	sessionId	True	string	指定聊天工作階段 ID。
要求	req	True	dynamic

傳回

response: object

觸發程序

建立或更新票證時	此作業會在建立或更新票證時觸發。
建立或更新聊天會話時	此操作會在建立或更新聊天時觸發。
當進階事件發生時	進階事件是專門的觸發器，發生頻率較低，但提供有價值的功能來自動啟動工作流程以回應特定條件。
觸發工作流程時	觸發指定工作流程時，會觸發此作業。工作流程可以在您的管理入口網站中進行管理。

建立或更新票證時

作業識別碼：: CreateTicketWorkflow

此作業會在建立或更新票證時觸發。

參數

名稱	機碼	必要	類型	Description
Event	type	True	string	指定要訂閱的事件類型。
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

建立或更新聊天會話時

作業識別碼：: CreateChatWebhook

此操作會在建立或更新聊天時觸發。

參數

名稱	機碼	必要	類型	Description
Event	type	True	string	指定要訂閱的事件類型。
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

當進階事件發生時

作業識別碼：: AdvancedEventSubscribe

進階事件是專門的觸發器，發生頻率較低，但提供有價值的功能來自動啟動工作流程以回應特定條件。

參數

名稱	機碼	必要	類型	Description
類別	category	True	string	從清單中選取事件類別。
Event	eventType	True	string	從清單中選取事件。
要求	req	True	dynamic

傳回

此作業會輸出隨機的結果。

觸發工作流程時

作業識別碼：: SubscribeToWorkflow

觸發指定工作流程時，會觸發此作業。工作流程可以在您的管理入口網站中進行管理。

參數

名稱	機碼	必要	類型	Description
類型	type	True	string	指定工作流程的類型
Workflow	workflowId	True	string	指定工作流程
要求	req	True	dynamic

共用方式為

DeskDirector

先決條件

如何取得認證

開始使用連接器

FAQ

正在建立連線

預設

節流限制

動作

傳送通知給成員

參數

傳回

傳送通知給連絡人

參數

傳回

取得會員

參數

傳回

取得票證任務

參數

傳回

取得聊天會話

參數

傳回

取得聯絡方式

參數

傳回

取得表單結果

參數

傳回

取得表單結果 （已淘汰） [已淘汰]

參數

傳回

取得門票

參數

傳回

回應進階事件

參數

傳回

在聊天室中傳送系統訊息

參數

傳回

執行進階動作

參數

傳回

尋找使用者群組

參數

傳回

尋找公司

參數

傳回

尋找成員

參數

傳回

尋找票證

參數

傳回

尋找票證工作範本

參數

傳回

尋找聯絡人

參數

傳回

建立票證

參數

傳回

建立票證工作

參數

傳回

建立聯絡人

參數

傳回

從範本建立電子郵件

參數

傳回

找一家公司

參數

傳回

更新票證

取得表單結果（已淘汰） [已淘汰]