盧瓦爾雨雲

Nimbus 聯絡中心和企業路由授權服務的連接器，可快速將 Nimbus 與第三方系統連接。透過監聽觸發事件並做出反應，連接器可以跟進流程動作，例如從外部系統擷取資料並將其儲存到 Nimbus 參數中，以便稍後在 Nimbus 工作流程中使用。

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

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

連絡人
名稱	Luware 服務台
URL	https://helpdesk.luware.cloud/
Email	nimbus.support@luware.com

連接器中繼資料
Publisher	盧瓦爾
網站	https://luware.com/
隱私權原則	https://luware.com/en/privacy-policy/
類別	傳達;通敵

Luware Nimbus 連接器允許在 Nimbus 和第 3 方軟體（例如 CRM 或票務系統）之間進行整合。它可讓您監聽 Luware Nimbus 中發生的任務和排程器條目事件。您可以建立任務、使用呼叫者資訊資料豐富現有任務、新增路由參數或在第三方系統中觸發事件。此外，您還可以管理通訊錄、安排外撥電話或添加外部任務。

一些用例包括：

在 Nimbus 中顯示來電的聯絡方式。
堅持選擇從 Nimbus 中的 IVR 到 CRM。
在 CRM 中呼叫之後建立呼叫後工作專案。
在 CRM 中為未接來電建立回撥任務。
根據CRM中的行銷活動建立Nimbus傳出呼叫。
根據客戶偏好路由呼叫。
顯示來電通話的來電者偏好設定。
在第三方系統中建立票證。
在第三方系統中創建未接來電列表。
當客服專員接聽電話時，開啟客戶的記錄。

請在 Luware 的知識庫中找到更多信息和大量幫助： https://help.luware.com/nimbus-power-automate-connector

先決條件

具有「進階」層的 Microsoft PowerApps 或 PowerAutomate 方案
Azure 租用戶
至少佈建一個 Luware Nimbus 服務
Luware Nimbus 中允許使用 Luware Nimbus 連接器（https://help.luware.com/power-automate-roles）的角色

如何建立安全連線

Nimbus API 會使用委派的許可權，透過 Azure Active Directory （AAD） / Microsoft Entra ID 來保護。身為租用戶管理員，您需要授予「Luware Nimbus 登入」應用程式的這些權限，以便連接器可以安全地存取 Luware Nimbus。在大多數情況下，這些權限已在 Nimbus 上線期間授予，無需重新確認。

完成此步驟之後，您可以藉由建立與 Nimbus 叢集的連線來使用連接器。請務必挑選與 Nimbus 安裝相同的叢集位置。如果您不確定這一點，請登入 Nimbus 管理以檢查您將被重新導向到哪個叢集。

開始使用連接器

在 Luware Nimbus 觸發程序上選取 [當工作變更狀態時] 觸發程序。
配置您要收聽來電的 Nimbus 服務。
選取事件「系統已接受」（當到達工作流程中的「接受交談」活動時觸發）。
根據來電者電話號碼實作來電者資訊的查找，例如在您的 CRM 中或用於 SharePoint 上託管的 Excel 工作表中的測試目的。
使用「更新任務」動作在任務上設定客戶資訊，如名字/姓氏、地址、城市、國家/地區等。

請參閱知識庫上的使用案例區段： https://help.luware.com/power-automate-use-cases

已知問題與限制

在 Luware Nimbus 中失去許可權（RBAC）會停用 Power Automate 中的觸發程式，而沒有為使用者提供透明資訊。流將不再被觸發。
Luware 對流程的執行時間沒有影響，因此結果可能會延遲返回 Nimbus。根據流程的完成情況來構建工作流程，應牢記此限制。

常見錯誤和補救措施

HTTP錯誤碼：

400：您傳送至 Luware Nimbus API 的要求包含無效的參數，或無法套用這些參數。範例：所有傳遞的偏好使用者都無效，因此未設定偏好使用者，或當您嘗試刪除已指派給使用者的外部工作時。
401：無法剖解析提供的驗證權杖或無效。檢查 Azure AD/Entra ID 應用程式註冊的正確設定，以及您已為 O365 帳戶提供正確的認證。
403：您的帳戶在 Nimbus 中缺少必要的權限，無法執行流程中設定的動作。請參閱知識庫，並在您需要其他角色/權限時聯絡您的管理員。
404：傳遞的識別碼無法與後端中的任何實體相符。

正在建立連線

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


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

預設

適用：所有地區

建立連線的參數。

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

名稱	類型	Description	為必填項目
地點	字串	租戶所在的位置。	對

節流限制

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

動作

使用工作流程排程器項目更新出站通話	使用工作流程排程器項目變更已建立的出站通話的設定。
使用工作流程排程新的外撥通話	使用工作流程（排程器條目）安排新的出站通話。
取得所有排程器項目	傳回指定服務的所有排程器項目。
取得虛擬使用者助理資料	傳回所選服務階段作業的虛擬使用者助理資料。
將連絡人新增至通訊錄	將新連絡人新增至特定通訊錄。 ExternalId 會作為進一步要求中的參考。
從通訊錄中移除連絡人	從通訊錄中移除一或多個連絡人。
從通訊錄取得連絡人	從通訊錄傳回連絡人。
排程新的撥出通話	排程新的撥出呼叫（排程器條目）。
新增外部工作	新增外部工作
更新工作	更新進行中任務的客戶資訊、內容參數和/或偏好的使用者設定。
更新排程器項目	變更已建立的排程器項目的設定。
更新通訊錄中的連絡人	更新指定通訊錄中的單一連絡人。
清空通訊錄	刪除指定通訊錄中的所有聯繫人。
獲取開放時間	取得服務開放時間：它會在指定時間傳回服務的狀態（開啟、關閉、假日等）。
移除外部工作	移除外部工作
移除排程器項目	從系統中移除排程器項目。只有在排程器項目尚未進行時才可能。

使用工作流程排程器項目更新出站通話

作業識別碼：: UpdateOutboundCallWithWorkflowSchedulerEntry

使用工作流程排程器項目變更已建立的出站通話的設定。

參數

名稱	機碼	必要	類型	Description
排程器項目ID	SchedulerEntryID	True	string	要更新的排程器項目的 ID。
參考標識碼	ReferenceId		string	第三方系統傳遞的參考ID。
目的地	destination	True	string	具有工作流程的出站通話目的地。
截止日期時間（UTC）	dueDateTimeUtc	True	date-time	UTC 的到期日期和時間：範例：「2020-03-23T11：00：00Z」。
服務 UPN	serviceUpn	True	string	服務的 UPN。
最大嘗試次數	maxAttempts		integer	到達目的地的最大嘗試次數。
嘗試逾時（以秒為單位）	attemptTimeoutInSeconds		integer	定義 Nimbus 在嘗試停止之前嘗試到達目的地的時間長度。
名稱	name	True	string	自訂內容參數的名稱。
價值觀	value		string	自訂內容參數的值。
客戶名字	firstName		string	客戶的名字。
客戶姓氏	lastName		string	客戶的姓氏。
客戶顯示名稱	displayName		string	客戶的顯示名稱。
客戶公司	company		string	客戶的公司。
客戶職稱	jobTitle		string	客戶的職稱。
客戶部	department		string	客戶部門。
客戶街道地址	streetAddress		string	客戶的街道地址。
客戶郵遞區號	postCode		string	客戶的郵遞區號。
客戶的市/鎮	city		string	客戶的城市。
客戶狀態	state		string	客戶的狀態。
客戶的國家/地區	country		string	客戶所在的國家/地區。
客戶主要電話號碼	primaryTelNumber		string	客戶的主要電話號碼。
名稱	name	True	string	電話號碼的指定。
價值觀	value		string	電話號碼的值。
客戶 UPN	UPN		string	客戶的UPN。
客戶 IM 位址	imAddress		string	客戶的 IM 位址。
客戶電子郵件	email		string	客戶的電子郵件。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。

傳回

身體: OutboundCallWithWorkflowSchedulerEntryEventData

使用工作流程排程新的外撥通話

作業識別碼：: CreateOutboundCallWithWorkflowSchedulerEntry

使用工作流程（排程器條目）安排新的出站通話。

參數

名稱	機碼	必要	類型	Description
參考標識碼	ReferenceId		string	第三方系統傳遞的參考ID。
目的地	destination	True	string	具有工作流程的出站通話目的地。
截止日期時間（UTC）	dueDateTimeUtc	True	date-time	UTC 的到期日期和時間：範例：「2020-03-23T11：00：00Z」。
服務 UPN	serviceUpn	True	string	服務的 UPN。
最大嘗試次數	maxAttempts		integer	到達目的地的最大嘗試次數。
嘗試逾時（以秒為單位）	attemptTimeoutInSeconds		integer	定義 Nimbus 在嘗試停止之前嘗試到達目的地的時間長度。
名稱	name	True	string	自訂內容參數的名稱。
價值觀	value		string	自訂內容參數的值。
客戶名字	firstName		string	客戶的名字。
客戶姓氏	lastName		string	客戶的姓氏。
客戶顯示名稱	displayName		string	客戶的顯示名稱。
客戶公司	company		string	客戶的公司。
客戶職稱	jobTitle		string	客戶的職稱。
客戶部	department		string	客戶部門。
客戶街道地址	streetAddress		string	客戶的街道地址。
客戶郵遞區號	postCode		string	客戶的郵遞區號。
客戶的市/鎮	city		string	客戶的城市。
客戶狀態	state		string	客戶的狀態。
客戶的國家/地區	country		string	客戶所在的國家/地區。
客戶主要電話號碼	primaryTelNumber		string	客戶的主要電話號碼。
名稱	name	True	string	電話號碼的指定。
價值觀	value		string	電話號碼的值。
客戶 UPN	UPN		string	客戶的UPN。
客戶 IM 位址	imAddress		string	客戶的 IM 位址。
客戶電子郵件	email		string	客戶的電子郵件。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。

傳回

身體: OutboundCallWithWorkflowSchedulerEntryEventData

取得所有排程器項目

作業識別碼：: GetSchedulerEntries

傳回指定服務的所有排程器項目。

參數

名稱	機碼	必要	類型	Description
服務 UPN	serviceUpn	True	string	應該傳回排程器專案之服務的 UPN。

傳回

指定服務的所有排程工作清單

排程工作: array of SchedulerEntryEventData

取得虛擬使用者助理資料

作業識別碼：: GetVirtualUserAssistantData

傳回所選服務階段作業的虛擬使用者助理資料。

參數

名稱	機碼	必要	類型	Description
服務工作階段識別碼	serviceSessionId	True	string	應傳回虛擬使用者助理資料的服務階段作業 ID。
使用者工作階段識別碼	userSessionId		string	應傳回虛擬使用者助理資料的使用者階段作業 ID。
數據類型	dataType	True	string	應針對服務工作階段傳回的資料類型。

傳回

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

將連絡人新增至通訊錄

作業識別碼：: AddContact

將新連絡人新增至特定通訊錄。 ExternalId 會作為進一步要求中的參考。

參數

名稱	機碼	必要	類型	Description
通訊錄	AddressBook	True	string	要新增連絡人的通訊錄。
聯絡人外部ID	externalId	True	string	外部系統提供的聯絡人 ID。
聯絡人名字	firstName		string	連絡人的名字。
聯絡人姓氏	lastName		string	聯繫人的姓氏。
連絡人顯示名稱	displayName		string	聯絡人的顯示名稱。
聯絡人姓名縮寫	initials		string	聯繫人的縮寫。
聯絡公司	company		string	公司聯繫人。
聯絡部門	department		string	聯繫部門。
聯絡人職位	jobTitle		string	聯繫人的職稱。
聯絡使用者主體名稱	userPrincipalName		string	連絡人的使用者主體名稱。
聯絡 IM 位址	imAddresses		array of string	IM 位址清單。
聯絡電子郵件地址	emailAddresses		array of string	電子郵件地址清單。
聯絡商務電話	businessPhones		array of string	商務電話清單。
聯絡手機	mobilePhones		array of string	手機清單。
聯繫家庭電話	homePhones		array of string	家庭電話列表。
地址街	street		string	地址的街道和號碼。
地址城市	city		string	位址所在的城市。
地址國家	country		string	地址的國家/地區。
地址狀態	state		string	地址的狀態。
地址郵遞區號	postalCode		string	地址的郵遞區號。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。

傳回

身體: ContactReadDto

從通訊錄中移除連絡人

作業識別碼：: RemoveContacts

從通訊錄中移除一或多個連絡人。

參數

名稱	機碼	必要	類型	Description
通訊錄	AddressBook	True	string	要從中移除連絡人的通訊錄。
外部標識碼	externalIds	True	array of string

從通訊錄取得連絡人

作業識別碼：: GetContacts

從通訊錄傳回連絡人。

參數

名稱	機碼	必要	類型	Description
通訊錄	AddressBook	True	string	要從中獲取聯繫人的通訊錄。
外部標識	externalIds		array	要擷取的連絡人的外部 ID。選用：如果未提供任何聯絡人，則會傳回所有聯絡人。

傳回

傳回的聯絡人。

聯繫人: array of ContactReadDto

排程新的撥出通話

作業識別碼：: CreateSchedulerEntry

排程新的撥出呼叫（排程器條目）。

參數

名稱	機碼	必要	類型	Description
參考標識碼	ReferenceId		string	第三方系統傳遞的參考ID。
目的地	destination	True	string	方向為「出站」的排程器條目的目的地。
分發優先順序	distributionPriority		string	在 Nimbus 中處理工作的優先順序。
截止日期時間（UTC）	dueDateTimeUtc	True	date-time	UTC 的到期日期和時間：範例：「2020-03-23T11：00：00Z」。
服務 UPN	serviceUpn	True	string	服務的 UPN。
最大嘗試次數	maxAttempts		integer	到達目的地的最大嘗試次數。
嘗試逾時（以秒為單位）	attemptTimeoutInSeconds		integer	連線重試之間的逾時（間隔），直到達到 [嘗試次數上限] 為止。
佇列時間上限（以秒為單位）	maxQueueTimeInSeconds		integer	定義 Nimbus 嘗試解決任務的時間長度，直到任務被視為「已達到限制」。
RONA 超時（以秒為單位）	ronaTimeoutInSeconds		integer	定義 Nimbus 嘗試聯絡使用者的時間長度，直到將任務視為 RONA 並選取新使用者。
名稱	name	True	string	自訂內容參數的名稱。
價值觀	value		string	自訂內容參數的值。
客戶名字	firstName		string	客戶的名字。
客戶姓氏	lastName		string	客戶的姓氏。
客戶顯示名稱	displayName		string	客戶的顯示名稱。
客戶公司	company		string	客戶的公司。
客戶職稱	jobTitle		string	客戶的職稱。
客戶部	department		string	客戶部門。
客戶街道地址	streetAddress		string	客戶的街道地址。
客戶郵遞區號	postCode		string	客戶的郵遞區號。
客戶的市/鎮	city		string	客戶的城市。
客戶狀態	state		string	客戶的狀態。
客戶的國家/地區	country		string	客戶所在的國家/地區。
客戶主要電話號碼	primaryTelNumber		string	客戶的主要電話號碼。
名稱	name	True	string	電話號碼的指定。
價值觀	value		string	電話號碼的值。
客戶 UPN	UPN		string	客戶的UPN。
客戶 IM 位址	imAddress		string	客戶的 IM 位址。
客戶電子郵件	email		string	客戶的電子郵件。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。

傳回

身體: SchedulerEntryEventData

新增外部工作

作業識別碼：: AddExternalTask

新增外部工作

參數

名稱	機碼	必要	類型	Description
服務 UPN	serviceUpn	True	string	服務的 UPN。
客戶識別碼	customerIdentifier		string	選用的唯一報告識別碼，空白時為匿名。
客戶名字	firstName		string	客戶的名字。
客戶姓氏	lastName		string	客戶的姓氏。
客戶顯示名稱	displayName		string	客戶的顯示名稱。
客戶公司	company		string	客戶的公司。
客戶職稱	jobTitle		string	客戶的職稱。
客戶部	department		string	客戶部門。
客戶街道地址	streetAddress		string	客戶的街道地址。
客戶郵遞區號	postCode		string	客戶的郵遞區號。
客戶的市/鎮	city		string	客戶的城市。
客戶狀態	state		string	客戶的狀態。
客戶的國家/地區	country		string	客戶所在的國家/地區。
客戶主要電話號碼	primaryTelNumber		string	客戶的主要電話號碼。
名稱	name	True	string	電話號碼的指定。
價值觀	value		string	電話號碼的值。
客戶 UPN	UPN		string	客戶的UPN。
客戶 IM 位址	imAddress		string	客戶的 IM 位址。
客戶電子郵件	email		string	客戶的電子郵件。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。
名稱	name	True	string	自訂內容參數的名稱。
價值觀	value		string	自訂內容參數的值。
分發優先順序	distributionPriority		string	到期後應在 Nimbus 中處理任務的優先順序。
UPN	upn	True	string	慣用使用者的 UPN。
Priority	priority		integer	優先級。 1 高到 99 低。

傳回

身體: ExternalTaskWriteResult

更新工作

作業識別碼：: UpdateTask

更新進行中任務的客戶資訊、內容參數和/或偏好的使用者設定。

參數

名稱	機碼	必要	類型	Description
工作識別碼	taskId	True	string	任務的 Nimbus 特定 ID。
客戶名字	firstName		string	客戶的名字。
客戶姓氏	lastName		string	客戶的姓氏。
客戶顯示名稱	displayName		string	客戶的顯示名稱。
客戶公司	company		string	客戶的公司。
客戶職稱	jobTitle		string	客戶的職稱。
客戶部	department		string	客戶部門。
客戶街道地址	streetAddress		string	客戶的街道地址。
客戶郵遞區號	postCode		string	客戶的郵遞區號。
客戶的市/鎮	city		string	客戶的城市。
客戶狀態	state		string	客戶的狀態。
客戶的國家/地區	country		string	客戶所在的國家/地區。
客戶主要電話號碼	primaryTelNumber		string	客戶的主要電話號碼。
名稱	name	True	string	電話號碼的指定。
價值觀	value		string	電話號碼的值。
客戶 UPN	UPN		string	客戶的UPN。
客戶 IM 位址	imAddress		string	客戶的 IM 位址。
客戶電子郵件	email		string	客戶的電子郵件。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。
名稱	name	True	string	自訂內容參數的名稱。
價值觀	value		string	自訂內容參數的值。
UPN	upn	True	string	慣用使用者的 UPN。
Priority	priority		integer	優先級。 1 高到 99 低。
服務工作階段識別碼	serviceSessionId		string	服務工作階段的識別碼。
使用者工作階段識別碼	userSessionId		string	使用者工作階段的識別碼。

更新排程器項目

作業識別碼：: UpdateSchedulerEntry

變更已建立的排程器項目的設定。

參數

名稱	機碼	必要	類型	Description
排程器項目ID	SchedulerEntryID	True	string	要更新的排程器項目的 ID。
參考標識碼	ReferenceId		string	第三方系統傳遞的參考ID。
目的地	destination	True	string	方向為「出站」的排程器條目的目的地。
分發優先順序	distributionPriority		string	在 Nimbus 中處理工作的優先順序。
截止日期時間（UTC）	dueDateTimeUtc	True	date-time	UTC 的到期日期和時間：範例：「2020-03-23T11：00：00Z」。
服務 UPN	serviceUpn	True	string	服務的 UPN。
最大嘗試次數	maxAttempts		integer	到達目的地的最大嘗試次數。
嘗試逾時（以秒為單位）	attemptTimeoutInSeconds		integer	連線重試之間的逾時（間隔），直到達到 [嘗試次數上限] 為止。
佇列時間上限（以秒為單位）	maxQueueTimeInSeconds		integer	定義 Nimbus 嘗試解決任務的時間長度，直到任務被視為「已達到限制」。
RONA 超時（以秒為單位）	ronaTimeoutInSeconds		integer	定義 Nimbus 嘗試聯絡使用者的時間長度，直到將任務視為 RONA 並選取新使用者。
名稱	name	True	string	自訂內容參數的名稱。
價值觀	value		string	自訂內容參數的值。
客戶名字	firstName		string	客戶的名字。
客戶姓氏	lastName		string	客戶的姓氏。
客戶顯示名稱	displayName		string	客戶的顯示名稱。
客戶公司	company		string	客戶的公司。
客戶職稱	jobTitle		string	客戶的職稱。
客戶部	department		string	客戶部門。
客戶街道地址	streetAddress		string	客戶的街道地址。
客戶郵遞區號	postCode		string	客戶的郵遞區號。
客戶的市/鎮	city		string	客戶的城市。
客戶狀態	state		string	客戶的狀態。
客戶的國家/地區	country		string	客戶所在的國家/地區。
客戶主要電話號碼	primaryTelNumber		string	客戶的主要電話號碼。
名稱	name	True	string	電話號碼的指定。
價值觀	value		string	電話號碼的值。
客戶 UPN	UPN		string	客戶的UPN。
客戶 IM 位址	imAddress		string	客戶的 IM 位址。
客戶電子郵件	email		string	客戶的電子郵件。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。

傳回

身體: SchedulerEntryEventData

更新通訊錄中的連絡人

作業識別碼：: UpdateContact

更新指定通訊錄中的單一連絡人。

參數

名稱	機碼	必要	類型	Description
通訊錄	AddressBook	True	string	要更新聯絡人的通訊錄。
聯絡人外部ID	externalId	True	string	外部系統提供的聯絡人 ID。
聯絡人名字	firstName		string	連絡人的名字。
聯絡人姓氏	lastName		string	聯繫人的姓氏。
連絡人顯示名稱	displayName		string	聯絡人的顯示名稱。
聯絡人姓名縮寫	initials		string	聯繫人的縮寫。
聯絡公司	company		string	公司聯繫人。
聯絡部門	department		string	聯繫部門。
聯絡人職位	jobTitle		string	聯繫人的職稱。
聯絡使用者主體名稱	userPrincipalName		string	連絡人的使用者主體名稱。
聯絡 IM 位址	imAddresses		array of string	IM 位址清單。
聯絡電子郵件地址	emailAddresses		array of string	電子郵件地址清單。
聯絡商務電話	businessPhones		array of string	商務電話清單。
聯絡手機	mobilePhones		array of string	手機清單。
聯繫家庭電話	homePhones		array of string	家庭電話列表。
地址街	street		string	地址的街道和號碼。
地址城市	city		string	位址所在的城市。
地址國家	country		string	地址的國家/地區。
地址狀態	state		string	地址的狀態。
地址郵遞區號	postalCode		string	地址的郵遞區號。
名稱	name	True	string	自訂欄位的指定。
價值觀	value		string	自訂欄位的值。

傳回

身體: ContactReadDto

清空通訊錄

作業識別碼：: ClearContacts

刪除指定通訊錄中的所有聯繫人。

參數

名稱	機碼	必要	類型	Description
通訊錄	AddressBook	True	string	要清空的通訊錄

獲取開放時間

作業識別碼：: GetOpeningHours

取得服務開放時間：它會在指定時間傳回服務的狀態（開啟、關閉、假日等）。

參數

名稱	機碼	必要	類型	Description
服務 UPN	serviceUpn	True	string	將檢查其狀態之服務的 UPN。
截止日期時間（UTC）	time		date-time	UTC 的到期日期和時間：範例：「2020-03-23T11：00：00Z」。

傳回

服務的狀態（開啟、關閉等）。

response: CalendarStatus

移除外部工作

作業識別碼：: RemoveExternalTask

移除外部工作

參數

名稱	機碼	必要	類型	Description
外部工作識別碼	externalTaskId	True	string	要移除的外部任務的 ID

移除排程器項目

作業識別碼：: DeleteSchedulerEntry

從系統中移除排程器項目。只有在排程器項目尚未進行時才可能。

參數

名稱	機碼	必要	類型	Description
排程器項目ID	SchedulerEntryID	True	string	要移除的排程器項目的 ID。

觸發程序

當任務變更狀態時	每當符合篩選條件的任務變更其狀態時引發。
當排程器項目變更狀態時	每當符合篩選準則的排程器專案變更其狀態時，就會引發。
當虛擬使用者助理有更新時	當虛擬使用者助理有新的更新時，會觸發此事件。

當任務變更狀態時

作業識別碼：: RegisterTaskWebHook

每當符合篩選條件的任務變更其狀態時引發。

參數

名稱	機碼	必要	類型	Description
Services	services	True	array of string	服務的 UPN，應該擷取工作的事件。
任務事件	taskEvents	True	array of string	應引發此觸發程式的任務事件。
方式	modalities		array of string	指定任務的起始模式。
方向	directions		array of string	指定任務的方向。

傳回

身體: TaskEventData

當排程器項目變更狀態時

作業識別碼：: RegisterSchedulerEntryTrigger

每當符合篩選準則的排程器專案變更其狀態時，就會引發。

參數

名稱	機碼	必要	類型	Description
Services	services	True	array of string	服務的 UPN，應該擷取工作的事件。
排程器進入事件	schedulerEntryEvents	True	array of string	排程器項目的事件，應該引發此觸發程式。

傳回

身體: SchedulerEntryEventData

當虛擬使用者助理有更新時

作業識別碼：: RegisterVirtualUserAssistantTrigger

當虛擬使用者助理有新的更新時，會觸發此事件。

參數

名稱	機碼	必要	類型	Description
Services	services	True	array of string	服務的 UPN，應該擷取工作的事件。
虛擬用戶助手事件	virtualUserAssistantEvents	True	array of string	虛擬使用者助理的事件，應該引發此觸發程式。

傳回

身體: VirtualUserAssistantEventData

定義

任務事件資料

名稱	路徑	類型	Description
工作識別碼	taskId	string	任務的 Nimbus 特定 ID。
服務工作階段識別碼	serviceSessionId	string	服務工作階段的ID
使用者工作階段識別碼	userSessionId	string	使用者工作階段的識別碼
使用者工作階段以傳輸啟動	userSessionStartedWithTransfer	boolean	指出使用者階段作業是否因傳輸而啟動。
呼叫鏈 ID	callChainId	string	來自 Microsoft 的工作呼叫鏈結識別碼。
Event	event	string	在 Nimbus 中針對任務發生的事件。
方向	direction	string	Nimbus 中進行中任務的方向（入站/出站/無）。
Modality	modality	string	Nimbus 中任務的初始模式。
已建立	created	string	時間戳記，建立任務時。
已終止	terminated	string	時間戳記，當任務已終止時。
原因	reason	string	終止原因。
上次連線的使用者 ID	lastConnectedUserId	string	任務最後連線使用者的物件識別碼（AAD）。
上次連線使用者的 UPN	LastConnectedUserUPN	string	任務最後連線使用者的 UPN。
上次連線使用者的電子郵件	LastConnectedUserEmail	string	任務最後連線使用者的電子郵件。
Microsoft 來電顯示	microsoftCallerId	string	呼叫端的物件識別碼（AAD）。
參考標識碼	referenceId	string	第三方系統傳遞的參考ID。
呼叫者識別碼	callerId	string	Nimbus 中呼叫者的內部 ID。物件識別碼（AAD）（如果呼叫端已知）。
來電者電話號碼	callerTelNumber	string	來電者的電話號碼（E.164）。僅針對模式=音訊的任務設定。
來電者 UPN	callerUPN	string	客戶的UPN。
Microsoft 目的地識別碼	microsoftDestinationId	string	輸出工作中被呼叫者的物件識別碼（AAD）。
目的地 ID	destinationId	string	Nimbus 中目的地（出站）的內部 ID。物件識別碼（AAD）（如果呼叫端已知）。
目的地電話號碼	destinationTelNumber	string	目的地（出站）的電話號碼（E.164）。
目的地 UPN	destinationUPN	string	目的地的UPN（輸出）。
ACS 識別碼	acsId	string	呼叫端的 Azure 通訊識別碼。
是匿名的	isAnonymous	boolean	當呼叫者是匿名時，旗標設定為 true。
客戶識別碼	customerIdentifier	string	所有工作類型中客戶的識別碼。
初始訊息	initialMessage	string	首先向 IM 客戶發送消息。
服務識別碼	serviceId	string	Nimbus 服務的內部 ID。
服務名稱	serviceName	string	Nimbus 服務的名稱。
服務說明	serviceDescription	string	Nimbus 服務的描述（繼承自 Microsoft Teams）。
服務顯示名稱	serviceDisplayName	string	Nimbus 服務的顯示名稱。
服務 UPN	serviceUPN	string	Nimbus 服務的 UPN。
服務電話號碼	serviceTelNumber	string	Nimbus 服務的電話號碼（E.164）。
電子郵件主旨	emailSubject	string	電子郵件的主旨。
電子郵件正文獨特的 Rich Text	emailBodyUniqueRichText	string	電子郵件內文，RTF 文字。
電子郵件正文：獨特的純文字	emailBodyUniquePlainText	string	電子郵件正文，純文字。
電子郵件服務信箱 UPN	emailServiceMailboxUPN	string	指派給服務的信箱的 UPN。
出站嘗試	outboundAttempt	integer	嘗試到達輸出目的地的次數。
更新的參數名稱	updatedParameterName	string	最後更新的參數名稱。
更新的參數值	updatedParameterValue	string	最後更新的參數值。
任務資訊	taskInformation	TaskInformation	包含客戶、自訂內容參數和偏好使用者的相關資訊。

任務資訊

包含客戶、自訂內容參數和偏好使用者的相關資訊。

名稱	路徑	類型	Description
客戶	customer	Customer	包含客戶所有資訊的物件。
自訂內容參數	customContextParameters	array of CustomContextParameter	自訂內容參數清單（Key-Value）。
首選用戶	preferredUsers	array of PreferredUser	任務的偏好使用者清單（UPN-Priority）。

客戶

包含客戶所有資訊的物件。

名稱	路徑	類型	Description
客戶名字	firstName	string	客戶的名字。
客戶姓氏	lastName	string	客戶的姓氏。
客戶顯示名稱	displayName	string	客戶的顯示名稱。
客戶公司	company	string	客戶的公司。
客戶職稱	jobTitle	string	客戶的職稱。
客戶部	department	string	客戶部門。
客戶街道地址	streetAddress	string	客戶的街道地址。
客戶郵遞區號	postCode	string	客戶的郵遞區號。
客戶的市/鎮	city	string	客戶的城市。
客戶狀態	state	string	客戶的狀態。
客戶的國家/地區	country	string	客戶所在的國家/地區。
客戶主要電話號碼	primaryTelNumber	string	客戶的主要電話號碼。
電話號碼	telNumbers	array of TelNumber	客戶的其他電話號碼列表。
客戶 UPN	UPN	string	客戶的UPN。
客戶 IM 位址	imAddress	string	客戶的 IM 位址。
客戶電子郵件	email	string	客戶的電子郵件。
自訂欄位	customFields	array of CustomField	客戶的自訂欄位清單。

電話號碼

名稱	路徑	類型	Description
名稱	name	string	電話號碼的指定。
價值觀	value	string	電話號碼的值。

自訂欄位

名稱	路徑	類型	Description
名稱	name	string	自訂欄位的指定。
價值觀	value	string	自訂欄位的值。

CustomContextParameter

名稱	路徑	類型	Description
名稱	name	string	自訂內容參數的名稱。
價值觀	value	string	自訂內容參數的值。

偏好使用者

名稱	路徑	類型	Description
UPN	upn	string	慣用使用者的 UPN。
Priority	priority	integer	優先級。 1 高到 99 低。

聯絡方式ReadDto

名稱	路徑	類型	Description
聯絡人外部ID	externalId	string	外部系統提供的聯絡人 ID。
聯絡人名字	firstName	string	連絡人的名字。
聯絡人姓氏	lastName	string	聯繫人的姓氏。
連絡人顯示名稱	displayName	string	聯絡人的顯示名稱。
聯絡人姓名縮寫	initials	string	聯繫人的縮寫。
聯絡公司	company	string	公司聯繫人。
聯絡部門	department	string	聯繫部門。
聯絡人職位	jobTitle	string	聯繫人的職稱。
聯絡使用者主體名稱	userPrincipalName	string	連絡人的使用者主體名稱。
聯絡 IM 位址	imAddresses	array of string	IM 位址清單。
聯絡電子郵件地址	emailAddresses	array of string	電子郵件地址清單。
聯絡商務電話	businessPhones	array of string	商務電話清單。
聯絡手機	mobilePhones	array of string	手機清單。
聯繫家庭電話	homePhones	array of string	家庭電話列表。
addresses	addresses	array of Address	地址列表。
自訂欄位	customFields	array of CustomField	聯絡人的自訂欄位清單。

Address

名稱	路徑	類型	Description
地址街	street	string	地址的街道和號碼。
地址城市	city	string	位址所在的城市。
地址國家	country	string	地址的國家/地區。
地址狀態	state	string	地址的狀態。
地址郵遞區號	postalCode	string	地址的郵遞區號。

SchedulerEntryEventData

名稱	路徑	類型	Description
排程器項目ID	schedulerEntryId	string	排程器項目的 Nimbus 特定 ID。
對話類型	conversationType	string	排程器項目的交談類型。
Event	event	string	在 Nimbus 內針對排程任務發生的事件。
方向	direction	string	Nimbus 中進行中任務的方向（入站/出站/無）。
Modality	modality	string	Nimbus 中任務的初始模式。
參考標識碼	ReferenceId	string	第三方系統傳遞的參考ID。
統一交談標識碼	unifiedConversationId	string	統一交談識別碼。
完成原因	completionReason	string	終止時排程器項目的結果。
目的地	destination	string	方向為「出站」的排程器條目的目的地。
分發優先順序	distributionPriority	string	在 Nimbus 中處理工作的優先順序。
截止日期時間（UTC）	dueDateTimeUtc	date-time	UTC 的到期日期和時間：範例：「2020-03-23T11：00：00Z」。
服務 UPN	serviceUpn	string	排程項目之服務的 UPN。
最大嘗試次數	maxAttempts	integer	到達目的地的最大嘗試次數。
嘗試逾時（以秒為單位）	attemptTimeoutInSeconds	integer	連線重試之間的逾時（間隔），直到達到 [嘗試次數上限] 為止。
佇列時間上限（以秒為單位）	maxQueueTimeInSeconds	integer	定義 Nimbus 嘗試解決任務的時間長度，直到任務被視為「已達到限制」。
RONA 超時（以秒為單位）	ronaTimeoutInSeconds	integer	定義 Nimbus 嘗試聯絡使用者的時間長度，直到將任務視為 RONA 並選取新使用者。
自訂內容參數	customCallContextParameters	array of CustomContextParameter	自訂內容參數清單（Key-Value）。
客戶	customer	Customer	包含客戶所有資訊的物件。

OutboundCallWithWorkflowSchedulerEntryEventData

名稱	路徑	類型	Description
排程器項目ID	schedulerEntryId	string	排程器項目的 Nimbus 特定 ID。
對話類型	conversationType	string	排程器項目的交談類型。
Event	event	string	在 Nimbus 內針對排程任務發生的事件。
方向	direction	string	Nimbus 中進行中任務的方向（入站/出站/無）。
Modality	modality	string	Nimbus 中任務的初始模式。
參考標識碼	ReferenceId	string	第三方系統傳遞的參考ID。
統一交談標識碼	unifiedConversationId	string	統一交談識別碼。
完成原因	completionReason	string	終止時排程器項目的結果。
目的地	destination	string	方向為「出站」的排程器條目的目的地。
分發優先順序	distributionPriority	string	在 Nimbus 中處理工作的優先順序。
截止日期時間（UTC）	dueDateTimeUtc	date-time	UTC 的到期日期和時間：範例：「2020-03-23T11：00：00Z」。
服務 UPN	serviceUpn	string	排程項目之服務的 UPN。
最大嘗試次數	maxAttempts	integer	到達目的地的最大嘗試次數。
嘗試逾時（以秒為單位）	attemptTimeoutInSeconds	integer	定義 Nimbus 在嘗試停止之前嘗試到達目的地的時間長度。
自訂內容參數	customCallContextParameters	array of CustomContextParameter	自訂內容參數清單（Key-Value）。
客戶	customer	Customer	包含客戶所有資訊的物件。

VirtualUserAssistantEventData

名稱	路徑	類型	Description
統一工作階段ID	unifiedSessionId	string	相關 Nimbus 統一階段作業的 ID。
服務工作階段識別碼	serviceSessionId	string	相關 Nimbus 服務階段作業的 ID。
使用者工作階段識別碼	userSessionId	string	相關 Nimbus 使用者工作階段的 ID。
服務 UPN	serviceUpn	string	發生事件之服務的 UPN。
服務識別碼	serviceId	string	發生事件之服務的識別碼。
服務名稱	serviceName	string	發生事件的服務名稱。
Event	event	string	發生在 Nimbus 中的虛擬使用者助理事件。
使用者工作階段以傳輸啟動	userSessionStartedWithTransfer	boolean	指出使用者階段作業是否因傳輸而啟動。

外部任務寫入結果

名稱	路徑	類型	Description
外部工作識別碼	id	string	新增外部工作的識別碼。
Modality	modality	Modality	任務的模式。
已建立	created	string	時間戳記，建立外部任務時。
類型	type	string	外部任務的類型。
是匿名的	isAnonymous	boolean	當呼叫者是匿名時，旗標設定為 true。
服務識別碼	serviceId	string	Nimbus 服務的內部 ID。
服務名稱	serviceName	string	Nimbus 服務的名稱。
服務說明	serviceDescription	string	Nimbus 服務的描述（繼承自 Microsoft Teams）。
服務顯示名稱	serviceDisplayName	string	服務的顯示名稱。
服務 UPN	serviceUPN	string	服務的 UPN。
服務電話號碼	serviceTelNumber	string	服務的電話號碼。
首選用戶	preferredUsers	array of PreferredUser	任務的偏好使用者清單（UPN-Priority）。

Modality

任務的模式。

Modality: string

行事曆狀態

服務的狀態（開啟、關閉等）。

營業時間狀態: string

共用方式為

盧瓦爾雨雲

先決條件

如何建立安全連線

開始使用連接器

已知問題與限制

常見錯誤和補救措施

正在建立連線

預設

節流限制

動作

使用工作流程排程器項目更新出站通話

參數

傳回

使用工作流程排程新的外撥通話

參數

傳回

取得所有排程器項目

參數

傳回

取得虛擬使用者助理資料

參數

傳回

將連絡人新增至通訊錄

參數

傳回

從通訊錄中移除連絡人

參數

從通訊錄取得連絡人

參數

傳回

排程新的撥出通話

參數

傳回

新增外部工作

參數

傳回

更新工作

參數

更新排程器項目

參數

傳回

更新通訊錄中的連絡人

參數

傳回

清空通訊錄

參數

獲取開放時間

參數

傳回

移除外部工作

參數

移除排程器項目

參數

觸發程序

當任務變更狀態時

參數

傳回

當排程器項目變更狀態時

參數

傳回

當虛擬使用者助理有更新時

參數

傳回

定義

任務事件資料

任務資訊

客戶

電話號碼

自訂欄位

CustomContextParameter

偏好使用者

聯絡方式ReadDto

Address

SchedulerEntryEventData

OutboundCallWithWorkflowSchedulerEntryEventData

VirtualUserAssistantEventData

外部任務寫入結果

Modality

行事曆狀態