Luware Nimbus

Nimbus Contact Center および Enterprise Routing ライセンスサービス用コネクタ。Nimbus をサードパーティのシステムにすばやく接続します。 トリガー イベントをリッスンして応答することで、コネクタはフロー アクションをフォローアップできます。たとえば、外部システムからデータを取得し、Nimbus ワークフロー内で後で使用できるように Nimbus パラメーターに格納します。

このコネクタは、次の製品とリージョンで使用できます。

サービス	クラス	リージョン
コピロット スタジオ	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
ロジック アプリ	Standard	次を除くすべての Logic Apps リージョン :      - Azure Government リージョン      - Azure China リージョン      - 米国国防総省 (DoD)
Power Apps	Premium	次を除くすべての Power Apps リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
Power Automate	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)

お問い合わせ
名前	Luware Helpdesk
URL	https://helpdesk.luware.cloud/
Email	nimbus.support@luware.com

コネクタ メタデータ
Publisher	Luware
Website	https://luware.com/
プライバシー ポリシー	https://luware.com/en/privacy-policy/
カテゴリ	通信;コラボレーション

Luware Nimbusコネクタを使用すると、NimbusとCRMやチケットシステムなどのサードパーティ製ソフトウェアとの統合が可能です。 これにより、Luware Nimbus で発生するタスクとスケジューラのエントリ イベントをリッスンできます。 タスクの作成、呼び出し元情報データを使用した既存のタスクの強化、ルーティング パラメーターの追加、サード パーティ システムでのイベントのトリガーを行うことができます。 さらに、アドレス帳の管理、発信呼び出しのスケジュール設定、外部タスクの追加を行うことができます。

一部のユース ケースは次のとおりです。

• 着信通話の連絡先の詳細を Nimbus に表示します。
• Nimbus の IVR から CRM への言語の選択を保持します。
• CRM での呼び出しの後に、呼び出し後の作業項目を作成します。
• CRM で不在着信のコールバック タスクを作成します。
• CRM のキャンペーンに基づいて Nimbus 送信呼び出しを作成します。
• 顧客の好みに従って通話をルーティングします。
• 着信通話の発信者設定を表示します。
• サード パーティシステムでチケットを作成します。
• サード パーティ システムで不在着信の一覧を作成します。
• エージェントが通話を受けると、顧客のレコードを開きます。

Luware のナレッジ ベースに関する詳細情報と多くのヘルプを参照してください。 https://help.luware.com/nimbus-power-automate-connector

[前提条件]

• "Premium" レベルの Microsoft PowerApps または PowerAutomate プラン
• Azure テナント
• 少なくとも 1 つの 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 Login" アプリケーションにこれらのアクセス許可を付与する必要があります。 ほとんどの場合、これらのアクセス許可は Nimbus のオンボード中に既に付与されているため、再確認する必要はありません。

この手順が完了したら、Nimbus クラスターへの接続を確立することでコネクタを使用できます。 Nimbus インストールと同じクラスターの場所を選択してください。 これが不明な場合は、Nimbus 管理にログインして、リダイレクト先のクラスターを確認します。

コネクタの概要

1. Luware Nimbus トリガーで [タスクが状態を変更したとき] トリガーを選択します。
2. 着信通話をリッスンする Nimbus サービスを構成します。
3. イベント "System accepted" (ワークフローの "会話の受け入れ" アクティビティに達したときにトリガーされます) を選択します。
4. 発信者番号に基づいて発信者情報の検索を実装します (例: CRM または Sharepoint でホストされている Excel シートのテスト目的)。
5. [タスクの更新] アクションを使用して、タスクの Firstname/Lastname、Address、City、Country などの顧客情報を設定します。

ナレッジ ベースのユース ケースセクションを参照してください。 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: 渡された識別子をバックエンドのどのエンティティにも照合できません。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト	接続を作成するためのパラメーター。	すべてのリージョン	共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前	タイプ	Description	必須
ロケーション	文字列	テナントが配置されている場所。	正しい

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

すべてのスケジューラ エントリを取得する	指定されたサービスのすべてのスケジューラ エントリを返します。
アドレス帳から連絡先を削除する	アドレス帳から 1 つまたは複数の連絡先を削除します。
アドレス帳から連絡先を取得する	アドレス帳から連絡先を返します。
アドレス帳に連絡先を追加する	特定のアドレス帳に新しい連絡先を追加します。 ExternalId は、それ以降の要求で参照として使用されます。
アドレス帳の連絡先を更新する	指定したアドレス帳の 1 つの連絡先を更新します。
アドレス帳を空にする	指定したアドレス帳内のすべての連絡先を削除します。
スケジューラ エントリを削除する	システムからスケジューラ エントリを削除します。 スケジューラ エントリがまだ進行中でない場合にのみ可能です。
スケジューラ エントリを更新する	既に作成されているスケジューラ エントリの設定を変更します。
タスクを更新する	進行中のタスクの顧客情報、コンテキスト パラメーター、または優先ユーザー設定を更新します。
ワークフロー スケジューラ エントリを使用して送信呼び出しを更新する	ワークフロー スケジューラ エントリを使用して、既に作成されている送信呼び出しの設定を変更します。
ワークフローを使用して新しい発信呼び出しをスケジュールする	ワークフロー (スケジューラ エントリ) を使用して新しい発信呼び出しをスケジュールします。
仮想ユーザー アシスタント データを取得する	選択したサービス セッションの仮想ユーザー アシスタント データを返します。
営業時間を取得する	サービスの営業時間を取得します。指定された時刻にサービスの状態 (オープン、クローズ、休日など) が返されます。
外部タスクを削除する	外部タスクを削除する
新しい外部タスクを追加する	新しい外部タスクを追加する
新しい発信呼び出しをスケジュールする	新しい発信呼び出し (スケジューラ エントリ) をスケジュールします。

すべてのスケジューラ エントリを取得する

操作 ID:

GetSchedulerEntries

指定されたサービスのすべてのスケジューラ エントリを返します。

パラメーター

名前	キー	必須	型	説明
Service UPN	serviceUpn	True	string	スケジューラ エントリを返す必要があるサービスの UPN。

戻り値

指定されたサービスのすべてのスケジュールされたタスクの一覧

スケジュールされたタスク

array of SchedulerEntryEventData

アドレス帳から連絡先を削除する

操作 ID:

RemoveContacts

アドレス帳から 1 つまたは複数の連絡先を削除します。

パラメーター

名前	キー	必須	型	説明
アドレス帳	AddressBook	True	string	連絡先を削除するアドレス帳。
externalIds	externalIds	True	array of string

アドレス帳から連絡先を取得する

操作 ID:

GetContacts

アドレス帳から連絡先を返します。

パラメーター

名前	キー	必須	型	説明
アドレス帳	AddressBook	True	string	連絡先を取得するアドレス帳。
ExternalId	externalIds		array	フェッチする連絡先の外部 ID。 省略可能: 指定されていない場合は、すべての連絡先が返されます。

戻り値

返された連絡先。

連絡先

array of ContactReadDto

アドレス帳に連絡先を追加する

操作 ID:

AddContact

特定のアドレス帳に新しい連絡先を追加します。 ExternalId は、それ以降の要求で参照として使用されます。

パラメーター

名前	キー	必須	型	説明
アドレス帳	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	ユーザー設定フィールドの値。

戻り値

Body

ContactReadDto

アドレス帳の連絡先を更新する

操作 ID:

UpdateContact

指定したアドレス帳の 1 つの連絡先を更新します。

パラメーター

名前	キー	必須	型	説明
アドレス帳	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	ユーザー設定フィールドの値。

戻り値

Body

ContactReadDto

アドレス帳を空にする

操作 ID:

ClearContacts

指定したアドレス帳内のすべての連絡先を削除します。

パラメーター

名前	キー	必須	型	説明
アドレス帳	AddressBook	True	string	空にするアドレス帳

スケジューラ エントリを削除する

操作 ID:

DeleteSchedulerEntry

システムからスケジューラ エントリを削除します。 スケジューラ エントリがまだ進行中でない場合にのみ可能です。

パラメーター

名前	キー	必須	型	説明
Scheduler エントリ ID	SchedulerEntryID	True	string	削除するスケジューラ エントリの ID。

スケジューラ エントリを更新する

操作 ID:

UpdateSchedulerEntry

既に作成されているスケジューラ エントリの設定を変更します。

パラメーター

名前	キー	必須	型	説明
Scheduler エントリ ID	SchedulerEntryID	True	string	更新するスケジューラ エントリの ID。
参照 ID	ReferenceId		string	サード パーティ システムによって渡される参照の ID。
行き先	destination	True	string	方向が "送信" のスケジューラ エントリの宛先。
配布の優先順位	distributionPriority		string	Nimbus でタスクを処理する優先度。
期限 (UTC)	dueDateTimeUtc	True	date-time	期限日時 (UTC): 例: '2020-03-23T11:00:00Z'。
Service UPN	serviceUpn	True	string	サービスの UPN。
最大試行回数	maxAttempts		integer	宛先に到達するための最大試行回数。
試行タイムアウト (秒単位)	attemptTimeoutInSeconds		integer	最大試行回数に達するまでの接続再試行の間のタイムアウト (間隔)。
最大キュー時間 (秒単位)	maxQueueTimeInSeconds		integer	タスクが制限に達したと見なされるまで、Nimbus がタスクの解決を試みる時間を定義します。
RONA タイムアウト (秒単位)	ronaTimeoutInSeconds		integer	タスクが RONA と見なされ、新しいユーザーが選択されるまで、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	電話番号の値。
Customer UPN	UPN		string	顧客の UPN。
顧客の IM アドレス	imAddress		string	顧客の IM アドレス。
顧客の電子メール	email		string	顧客の電子メール。
名前	name	True	string	ユーザー設定フィールドの指定。
価値	value		string	ユーザー設定フィールドの値。

戻り値

Body

SchedulerEntryEventData

タスクを更新する

操作 ID:

UpdateTask

進行中のタスクの顧客情報、コンテキスト パラメーター、または優先ユーザー設定を更新します。

パラメーター

名前	キー	必須	型	説明
タスク ID	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	電話番号の値。
Customer 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 低。
サービス セッション ID	serviceSessionId		string	サービス セッションの ID。
ユーザー セッション ID	userSessionId		string	ユーザー セッションの ID。

ワークフロー スケジューラ エントリを使用して送信呼び出しを更新する

操作 ID:

UpdateOutboundCallWithWorkflowSchedulerEntry

ワークフロー スケジューラ エントリを使用して、既に作成されている送信呼び出しの設定を変更します。

パラメーター

名前	キー	必須	型	説明
Scheduler エントリ ID	SchedulerEntryID	True	string	更新するスケジューラ エントリの ID。
参照 ID	ReferenceId		string	サード パーティ システムによって渡される参照の ID。
行き先	destination	True	string	ワークフローを使用した発信呼び出しの宛先。
期限 (UTC)	dueDateTimeUtc	True	date-time	期限日時 (UTC): 例: '2020-03-23T11:00:00Z'。
Service 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	電話番号の値。
Customer UPN	UPN		string	顧客の UPN。
顧客の IM アドレス	imAddress		string	顧客の IM アドレス。
顧客の電子メール	email		string	顧客の電子メール。
名前	name	True	string	ユーザー設定フィールドの指定。
価値	value		string	ユーザー設定フィールドの値。

戻り値

Body

OutboundCallWithWorkflowSchedulerEntryEventData

ワークフローを使用して新しい発信呼び出しをスケジュールする

操作 ID:

CreateOutboundCallWithWorkflowSchedulerEntry

ワークフロー (スケジューラ エントリ) を使用して新しい発信呼び出しをスケジュールします。

パラメーター

名前	キー	必須	型	説明
参照 ID	ReferenceId		string	サード パーティ システムによって渡される参照の ID。
行き先	destination	True	string	ワークフローを使用した発信呼び出しの宛先。
期限 (UTC)	dueDateTimeUtc	True	date-time	期限日時 (UTC): 例: '2020-03-23T11:00:00Z'。
Service 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	電話番号の値。
Customer UPN	UPN		string	顧客の UPN。
顧客の IM アドレス	imAddress		string	顧客の IM アドレス。
顧客の電子メール	email		string	顧客の電子メール。
名前	name	True	string	ユーザー設定フィールドの指定。
価値	value		string	ユーザー設定フィールドの値。

戻り値

Body

OutboundCallWithWorkflowSchedulerEntryEventData

仮想ユーザー アシスタント データを取得する

操作 ID:

GetVirtualUserAssistantData

選択したサービス セッションの仮想ユーザー アシスタント データを返します。

パラメーター

名前	キー	必須	型	説明
サービス セッション ID	serviceSessionId	True	string	仮想ユーザー アシスタント データを返すサービス セッションの ID。
ユーザー セッション ID	userSessionId		string	仮想ユーザー アシスタント データを返す必要があるユーザー セッションの ID。
データ型	dataType	True	string	サービス セッションに対して返されるデータの種類。

戻り値

この操作の出力は状況に応じて変わります。

営業時間を取得する

操作 ID:

GetOpeningHours

サービスの営業時間を取得します。指定された時刻にサービスの状態 (オープン、クローズ、休日など) が返されます。

パラメーター

名前	キー	必須	型	説明
Service UPN	serviceUpn	True	string	状態が確認されるサービスの UPN。
期限 (UTC)	time		date-time	期限日時 (UTC): 例: '2020-03-23T11:00:00Z'。

戻り値

サービスの状態 (オープン、クローズなど)。

response

CalendarStatus

外部タスクを削除する

操作 ID:

RemoveExternalTask

外部タスクを削除する

パラメーター

名前	キー	必須	型	説明
外部タスク ID	externalTaskId	True	string	削除される外部タスクの ID

新しい外部タスクを追加する

操作 ID:

AddExternalTask

新しい外部タスクを追加する

パラメーター

名前	キー	必須	型	説明
Service 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	電話番号の値。
Customer 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 低。

戻り値

Body

ExternalTaskWriteResult

新しい発信呼び出しをスケジュールする

操作 ID:

CreateSchedulerEntry

新しい発信呼び出し (スケジューラ エントリ) をスケジュールします。

パラメーター

名前	キー	必須	型	説明
参照 ID	ReferenceId		string	サード パーティ システムによって渡される参照の ID。
行き先	destination	True	string	方向が "送信" のスケジューラ エントリの宛先。
配布の優先順位	distributionPriority		string	Nimbus でタスクを処理する優先度。
期限 (UTC)	dueDateTimeUtc	True	date-time	期限日時 (UTC): 例: '2020-03-23T11:00:00Z'。
Service UPN	serviceUpn	True	string	サービスの UPN。
最大試行回数	maxAttempts		integer	宛先に到達するための最大試行回数。
試行タイムアウト (秒単位)	attemptTimeoutInSeconds		integer	最大試行回数に達するまでの接続再試行の間のタイムアウト (間隔)。
最大キュー時間 (秒単位)	maxQueueTimeInSeconds		integer	タスクが制限に達したと見なされるまで、Nimbus がタスクの解決を試みる時間を定義します。
RONA タイムアウト (秒単位)	ronaTimeoutInSeconds		integer	タスクが RONA と見なされ、新しいユーザーが選択されるまで、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	電話番号の値。
Customer UPN	UPN		string	顧客の UPN。
顧客の IM アドレス	imAddress		string	顧客の IM アドレス。
顧客の電子メール	email		string	顧客の電子メール。
名前	name	True	string	ユーザー設定フィールドの指定。
価値	value		string	ユーザー設定フィールドの値。

戻り値

Body

SchedulerEntryEventData

トリガー

スケジューラ エントリの状態が変更されたとき	フィルター条件に一致するスケジューラ エントリが状態を変更するたびに発生します。
タスクの状態が変更されたとき	フィルター条件に一致するタスクが状態を変更するたびに発生します。
仮想ユーザー アシスタントに更新プログラムがある場合	このイベントは、仮想ユーザー アシスタントが新しい更新を行ったときにトリガーされます。

スケジューラ エントリの状態が変更されたとき

操作 ID:

RegisterSchedulerEntryTrigger

フィルター条件に一致するスケジューラ エントリが状態を変更するたびに発生します。

パラメーター

名前	キー	必須	型	説明
Services	services	True	array of string	サービスの UPN。タスクのイベントをフェッチする必要があります。
Scheduler エントリ イベント	schedulerEntryEvents	True	array of string	このトリガーを発生させるスケジューラ エントリのイベント。

戻り値

Body

SchedulerEntryEventData

タスクの状態が変更されたとき

操作 ID:

RegisterTaskWebHook

フィルター条件に一致するタスクが状態を変更するたびに発生します。

パラメーター

名前	キー	必須	型	説明
Services	services	True	array of string	サービスの UPN。タスクのイベントをフェッチする必要があります。
タスク イベント	taskEvents	True	array of string	このトリガーを発生させるタスクのイベント。
モダリティ	modalities		array of string	タスクの初期モダリティを指定します。
道順	directions		array of string	タスクの指示を指定します。

戻り値

Body

TaskEventData

仮想ユーザー アシスタントに更新プログラムがある場合

操作 ID:

RegisterVirtualUserAssistantTrigger

このイベントは、仮想ユーザー アシスタントが新しい更新を行ったときにトリガーされます。

パラメーター

名前	キー	必須	型	説明
Services	services	True	array of string	サービスの UPN。タスクのイベントをフェッチする必要があります。
Virtual User Assistant イベント	virtualUserAssistantEvents	True	array of string	このトリガーを発生させる仮想ユーザー アシスタントのイベント。

戻り値

Body

VirtualUserAssistantEventData

定義

TaskEventData

名前	パス	型	説明
タスク ID	taskId	string	タスクの Nimbus 固有の ID。
サービス セッション ID	serviceSessionId	string	サービス セッションの ID
ユーザー セッション ID	userSessionId	string	ユーザー セッションの ID
転送で開始されたユーザー セッション	userSessionStartedWithTransfer	boolean	転送の結果としてユーザー セッションが開始されたかどうかを示します。
呼び出しチェーン ID	callChainId	string	タスクの Microsoft からの呼び出しチェーン ID。
Event	event	string	タスクの Nimbus 内で発生したイベント。
通信方向	direction	string	Nimbus で進行中のタスクの方向 (受信/送信/なし)。
Modality	modality	string	Nimbus でのタスクの初期モダリティ。
作成済み	created	string	タスクが作成されたときのタイムスタンプ。
終了	terminated	string	タスクが終了したときのタイムスタンプ。
理由	reason	string	終了の理由。
最後に接続されたユーザーの ID	lastConnectedUserId	string	タスクの最後に接続されたユーザーのオブジェクト ID (AAD)。
最後に接続されたユーザーの UPN	LastConnectedUserUPN	string	タスクの最後に接続されたユーザーの UPN。
最後に接続されたユーザーの電子メール	LastConnectedUserEmail	string	タスクの最後に接続されたユーザーの電子メール。
Microsoft 発信者番号	microsoftCallerId	string	呼び出し元のオブジェクト ID (AAD)。
参照 ID	referenceId	string	サード パーティ システムによって渡される参照の ID。
呼び出し元 ID	callerId	string	Nimbus の呼び出し元の内部 ID。 呼び出し元がわかっている場合は、オブジェクト ID (AAD)。
発信者番号	callerTelNumber	string	発信者の電話番号 (E.164)。 modality=Audio を使用するタスクにのみ設定します。
呼び出し元 UPN	callerUPN	string	顧客の UPN。
Microsoft Destination ID	microsoftDestinationId	string	送信タスクの呼び出し先のオブジェクト ID (AAD)。
宛先 ID	destinationId	string	Nimbus の宛先 (送信) の内部 ID。 呼び出し元がわかっている場合は、オブジェクト ID (AAD)。
宛先電話番号	destinationTelNumber	string	宛先 (送信) の電話番号 (E.164)。
宛先 UPN	destinationUPN	string	宛先の UPN (送信)。
ACS ID	acsId	string	呼び出し元の Azure 通信 ID。
Is Anonymous	isAnonymous	boolean	呼び出し元が匿名の場合、フラグを true に設定します。
顧客識別子	customerIdentifier	string	すべてのタスクの種類の顧客の識別子。
初期メッセージ	initialMessage	string	最初に IM 顧客にメッセージを送信します。
サービス識別子	serviceId	string	Nimbus サービスの内部 ID。
サービス名	serviceName	string	Nimbus サービスの名前。
サービスの説明	serviceDescription	string	Nimbus サービスの説明 (Microsoft Teams から継承)。
サービスの表示名	serviceDisplayName	string	Nimbus サービスの表示名。
Service UPN	serviceUPN	string	Nimbus サービスの UPN。
サービス電話番号	serviceTelNumber	string	Nimbus サービスの電話番号 (E.164)。
電子メールの件名	emailSubject	string	メールの件名。
電子メール本文固有のリッチ テキスト	emailBodyUniqueRichText	string	電子メールの本文。リッチ テキスト。
電子メール本文の一意のプレーン テキスト	emailBodyUniquePlainText	string	電子メールの本文(プレーンテキスト)。
電子メール サービス メールボックス UPN	emailServiceMailboxUPN	string	サービスに割り当てられているメールボックスの UPN。
送信試行	outboundAttempt	integer	送信先に到達する試行回数。
更新されたパラメーター名	updatedParameterName	string	更新された最後のパラメーターの名前。
パラメーター値の更新	updatedParameterValue	string	更新された最後のパラメーターの値。
タスク情報	taskInformation	TaskInformation	顧客、カスタム コンテキスト パラメーター、優先ユーザーに関する情報が含まれます。

TaskInformation

顧客、カスタム コンテキスト パラメーター、優先ユーザーに関する情報が含まれます。

名前	パス	型	説明
顧客	customer	Customer	顧客のすべての情報を含むオブジェクト。
カスタム コンテキスト パラメーター	customContextParameters	array of CustomContextParameter	カスタム コンテキスト パラメーターの一覧 (Key-Value)。
優先ユーザー	preferredUsers	array of PreferredUser	タスク (UPN-Priority) の優先ユーザーの一覧。

カスタマー

顧客のすべての情報を含むオブジェクト。

名前	パス	型	説明
顧客名	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	顧客の追加電話番号の一覧。
Customer UPN	UPN	string	顧客の UPN。
顧客の IM アドレス	imAddress	string	顧客の IM アドレス。
顧客の電子メール	email	string	顧客の電子メール。
ユーザー設定フィールド	customFields	array of CustomField	顧客のユーザー設定フィールドの一覧。

TelNumber

名前	パス	型	説明
名前	name	string	電話番号の指定。
価値	value	string	電話番号の値。

CustomField

名前	パス	型	説明
名前	name	string	ユーザー設定フィールドの指定。
価値	value	string	ユーザー設定フィールドの値。

CustomContextParameter

名前	パス	型	説明
名前	name	string	カスタム コンテキスト パラメーターの名前。
価値	value	string	カスタム コンテキスト パラメーターの値。

PreferredUser

名前	パス	型	説明
UPN	upn	string	優先ユーザーの UPN。
Priority	priority	integer	優先順位。 1 高から 99 低。

ContactReadDto

名前	パス	型	説明
連絡先の外部 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	array of Address	アドレスの一覧。
customFields	customFields	array of CustomField	連絡先のユーザー設定フィールドの一覧。

住所

名前	パス	型	説明
住所街	street	string	住所の番地と番号。
住所の市区町村	city	string	住所の市区町村。
住所の国	country	string	住所の国。
アドレスの状態	state	string	アドレスの状態。
住所の郵便番号	postalCode	string	住所の郵便番号。

SchedulerEntryEventData

名前	パス	型	説明
Scheduler エントリ ID	schedulerEntryId	string	スケジューラ エントリの Nimbus 固有の ID。
ConversationType	conversationType	string	スケジューラ エントリの会話の種類。
Event	event	string	スケジュールされたタスクの Nimbus 内で発生したイベント。
通信方向	direction	string	Nimbus で進行中のタスクの方向 (受信/送信/なし)。
Modality	modality	string	Nimbus でのタスクの初期モダリティ。
参照 ID	ReferenceId	string	サード パーティ システムによって渡される参照の ID。
統合された会話 ID	unifiedConversationId	string	統合された会話 ID。
完了理由	completionReason	string	終了したときのスケジューラ エントリの結果。
行き先	destination	string	方向が "送信" のスケジューラ エントリの宛先。
配布の優先順位	distributionPriority	string	Nimbus でタスクを処理する優先度。
期限 (UTC)	dueDateTimeUtc	date-time	期限日時 (UTC): 例: '2020-03-23T11:00:00Z'。
Service UPN	serviceUpn	string	エントリがスケジュールされているサービスの UPN。
最大試行回数	maxAttempts	integer	宛先に到達するための最大試行回数。
試行タイムアウト (秒単位)	attemptTimeoutInSeconds	integer	最大試行回数に達するまでの接続再試行の間のタイムアウト (間隔)。
最大キュー時間 (秒単位)	maxQueueTimeInSeconds	integer	タスクが制限に達したと見なされるまで、Nimbus がタスクの解決を試みる時間を定義します。
RONA タイムアウト (秒単位)	ronaTimeoutInSeconds	integer	タスクが RONA と見なされ、新しいユーザーが選択されるまで、Nimbus がユーザーに到達しようとする時間を定義します。
カスタム コンテキスト パラメーター	customCallContextParameters	array of CustomContextParameter	カスタム コンテキスト パラメーター (Key-Value) の一覧。
顧客	customer	Customer	顧客のすべての情報を含むオブジェクト。

OutboundCallWithWorkflowSchedulerEntryEventData

名前	パス	型	説明
Scheduler エントリ ID	schedulerEntryId	string	スケジューラ エントリの Nimbus 固有の ID。
ConversationType	conversationType	string	スケジューラ エントリの会話の種類。
Event	event	string	スケジュールされたタスクの Nimbus 内で発生したイベント。
通信方向	direction	string	Nimbus で進行中のタスクの方向 (受信/送信/なし)。
Modality	modality	string	Nimbus でのタスクの初期モダリティ。
参照 ID	ReferenceId	string	サード パーティ システムによって渡される参照の ID。
統合された会話 ID	unifiedConversationId	string	統合された会話 ID。
完了理由	completionReason	string	終了したときのスケジューラ エントリの結果。
行き先	destination	string	方向が "送信" のスケジューラ エントリの宛先。
配布の優先順位	distributionPriority	string	Nimbus でタスクを処理する優先度。
期限 (UTC)	dueDateTimeUtc	date-time	期限日時 (UTC): 例: '2020-03-23T11:00:00Z'。
Service UPN	serviceUpn	string	エントリがスケジュールされているサービスの UPN。
最大試行回数	maxAttempts	integer	宛先に到達するための最大試行回数。
試行タイムアウト (秒単位)	attemptTimeoutInSeconds	integer	Nimbus が宛先に到達してから試行が停止されるまでの時間を定義します。
カスタム コンテキスト パラメーター	customCallContextParameters	array of CustomContextParameter	カスタム コンテキスト パラメーター (Key-Value) の一覧。
顧客	customer	Customer	顧客のすべての情報を含むオブジェクト。

VirtualUserAssistantEventData

名前	パス	型	説明
統合セッション ID	unifiedSessionId	string	関連する Nimbus 統合セッションの ID。
サービス セッション ID	serviceSessionId	string	関連する Nimbus サービス セッションの ID。
ユーザー セッション ID	userSessionId	string	関連する Nimbus ユーザー セッションの ID。
Service UPN	serviceUpn	string	イベントが発生したサービスの UPN。
サービス識別子	serviceId	string	イベントが発生したサービスの ID。
サービス名	serviceName	string	イベントが発生したサービスの名前。
Event	event	string	Nimbus 内で発生した仮想ユーザー アシスタント イベント。
転送で開始されたユーザー セッション	userSessionStartedWithTransfer	boolean	転送の結果としてユーザー セッションが開始されたかどうかを示します。

ExternalTaskWriteResult

名前	パス	型	説明
外部タスク ID	id	string	追加された外部タスクの ID。
Modality	modality	Modality	タスクのモダリティ。
作成済み	created	string	外部タスクが作成されたときのタイムスタンプ。
タイプ	type	string	外部タスクの種類。
Is Anonymous	isAnonymous	boolean	呼び出し元が匿名の場合、フラグを true に設定します。
サービス識別子	serviceId	string	Nimbus サービスの内部 ID。
サービス名	serviceName	string	Nimbus サービスの名前。
サービスの説明	serviceDescription	string	Nimbus サービスの説明 (Microsoft Teams から継承)。
サービスの表示名	serviceDisplayName	string	サービスの表示名。
Service UPN	serviceUPN	string	サービスの UPN。
サービス電話番号	serviceTelNumber	string	サービスの電話番号。
優先ユーザー	preferredUsers	array of PreferredUser	タスクの優先ユーザーの一覧 (UPN-Priority)。

Modality

タスクのモダリティ。

タスクのモダリティ。

Modality

string

CalendarStatus

サービスの状態 (オープン、クローズなど)。

サービスの状態 (オープン、クローズなど)。

営業時間の状態

string