Luware Nimbus (プレビュー)
Luware Nimbus ソリューションで使用するコネクタ。
このコネクタは、次の製品および地域で利用可能です:
Service | クラス | 地域 |
---|---|---|
Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
お問い合わせ先 | |
---|---|
件名 | Luware ヘルプデスク |
[URL] | https://helpdesk.luware.cloud/ |
メール | nimbus.support@luware.com |
Connector Metadata | |
---|---|
発行者 | Luware AG |
Web サイト | https://luware.com/ |
プライバシー ポリシー | https://luware.com/en/privacy-policy/ |
カテゴリー | 通信、コラボレーション |
Luware Nimbus Connector は Nimbus と CRM や発券システムなどのサードパーティ ソフトウェアとの統合を可能にします。 Luware Nimbus で発生するタスクとスケジューラのエントリ イベントを聞くことができます。 タスクを作成したり、発信者情報データで既存のタスクを強化したり、ルーティング パラメータを追加したり、サードパーティ システムでイベントをトリガーしたりできます。 さらに、アドレス帳を管理したり、発信通話をスケジュールしたり、外部タスクを追加したりすることもできます。
使用用途は以下の通りです:
- 着信コールの連絡先詳細を Nimbus に表示します。
- Nimbus の IVR から CRM まで言語の選択を維持します。
- CRM での通話後に、通話後の作業項目を作成します。
- CRM で不在着信に対するコールバック タスクを作成します。
- CRM のキャンペーンに基づいて Nimbus アウトバウンド コールを作成します。
- 顧客の好みに応じて通話をルーティングします。
- 着信通話の発信者の設定を表示します。
- サードパーティ システムでチケットを作成します。
- サードパーティ システムで不在着信のリストを作成します。
- エージェントが電話を受けたときに顧客の記録を開きます。
Luware のナレッジ ベースで詳細情報と多くのヘルプを見つけてください: https://help.luware.com/nimbus/?contentKey=powerautomate
前提条件
- 「プレミアム」レベルの Microsoft PowerApps または PowerAutomate プラン
- Azure テナント
- 少なくとも 1 つの Luware Nimbus サービスがプロビジョニングされている
- Luware Nimbus コネクタの使用を許可する Luware Nimbus の役割 (https://help.luware.com/nimbus/?contentKey=PARBAC)
資格情報の入手方法
Nimbus の API は Azure Active Directory (AAD)/Microsoft Entra ID で保護されているので、コネクタが Luware Nimbus に安全にアクセスできるように、まず Azure AD/Entra ID でいくつかの設定をする必要があります。 完了後、コネクタを作成およびテストできます。
コネクタの Azure AD/Entra ID アプリケーションの設定
まず、Azure AD/Entra ID にアプリケーションとしてコネクタを登録する必要があります。 これによりコネクタは Azure AD を識別し、エンドユーザーに代わって Luware Nimbus API へのアクセス許可を求めることができます。 詳しくはこちらをご覧ください: https://docs.microsoft.com/en-us/azure/active-directory/develop/authentication-scenarios を参照し、以下の手順に従ってください:
Azure AD / Entra ID アプリケーションを作成する この Azure AD / Entra ID アプリケーションは Luware Nimbus へのコネクタを識別するために使用されます。 これは、Azure ポータルを使用して行うことができます (https://portal.azure.com)、こちらの手順に従ってください(https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app)。 作成したら、アプリケーション (クライアント) ID の値を書き留めます。 これは後で必要になります。
Azure AD / Entra ID アプリケーションを構成または更新して Luware Nimbus API にアクセスします。 この手順により、アプリケーションが アクセス トークン を正常に取得して、ユーザーに代わって Luware Nimbus を呼び出すことができるようになります。 これを行うには、https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-configure-app-access-web-apis の手順に従いします。
- URI のリダイレクトには、https://global.consent.azure-apim.net/redirect を使用します
- 資格情報には、(証明書ではなく) クライアント シークレットを使用します。 シークレットを忘れずにメモしてください。これは後で必要になりますが、表示されるのは 1 回だけです。
- API 権限については、「User.Read」(委任) が追加されていることを確認してください。
この時点で、有効な Azure AD / Entra ID アプリケーションができ、O365 アカウントでエンドユーザーから許可を得て、Luware Nimbus にアクセスすることができます。
コネクタの使用を開始する
- Luware Nimbus トリガーで「タスクの状態変更時」トリガーを選択します。
- 着信を聞きたい Nimbus サービスを設定します。
- イベント「システムが承認されました」を選択します (ワークフローの「会話を承認」アクティビティに到達するとトリガーされます)。
- 発信者の電話番号に基づいて発信者情報の検索を実装します。CRM 内で使用するか、Sharepoint でホストされている Excel シートでテスト目的で使用します。
- 「タスクの更新」アクションを使用して、タスクに姓/名、住所、都市、国などの顧客情報を設定します。
ナレッジベースのユースケースセクションを参照してください: https://help.luware.com/nimbus/?contentKey=pauclist
既知の問題と制限事項
- Luware Nimbus でアクセス許可 (RBAC) を失うと、エンド ユーザーに透過的な情報が提供されずに Power Automate のトリガーが無効になります。 フローはトリガーされなくなります。
- Luware はフローの実行時間には影響を及ぼさないため、結果が遅れて Nimbus に返される可能性があります。 フローの完了に依存するワークフローは、この制限を念頭に置いて構築する必要があります。
一般的なエラーと解決策
HTTP エラー コード:
- 400: Luware Nimbus API に送信したリクエストに有効なパラメーターが含まれていないか、パラメーターを適用できません。 例: 渡されたすべての優先ユーザーが無効であるため、優先ユーザーが設定されていない、または、既にユーザーに割り当てられている外部タスクを削除しようとしました。
- 401: 提供された認証トークンは解析できないか無効です。 Azure AD /Entra ID アプリケーションの登録が正しく設定されていること、および O365 アカウントに正しい認証情報が指定されていることを確認してください。
- 403: アカウントには、フローで構成されたアクションを実行するために Nimbus で必要な権限がありません。 追加の役割/権限が必要な場合は、ナレッジベースを参照し、管理者 にご連絡ください。
- 404 : 渡された識別子は、バックエンドのどのエンティティとも一致できません。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
件名 | タイプ | Description | Required |
---|---|---|---|
場所 | string | テナントが所在する場所。 | True |
調整制限
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
すべてのスケジューラ エントリーを取得する |
指定されたサービスのすべてのスケジューラ エントリを返します。 |
アドレス帳から連絡先を削除する |
アドレス帳から 1 つまたは複数の連絡先を削除します。 |
アドレス帳から連絡先を取得する |
アドレス帳から連絡先を返します。 |
アドレス帳を空にする |
指定したアドレス帳のすべての連絡先を削除します。 |
スケジューラ エントリを削除する |
スケジューラ エントリをシステムから削除します。 スケジューラのエントリがまだ進行中でない場合にのみ可能です。 |
スケジューラ エントリを更新する |
すでに作成されているスケジューラ エントリの設定を変更します。 |
タスクの更新 |
進行中のタスクの顧客情報、コンテキスト パラメーター、および/または優先ユーザー設定を更新します。 |
外部タスクを削除する |
外部タスクを削除する |
新しい外部タスクを追加する |
新しい外部タスクを追加する |
新しい発信電話をスケジュールする |
新しい発信電話 (スケジューラ エントリ) をスケジュールする |
連絡先をアドレス帳で更新する |
指定したアドレス帳の単一の連絡先を更新します。 |
連絡先をアドレス帳に追加する |
特定のアドレス帳に新しい連絡先を追加します。 ExternalId は、以降のリクエストで参照として使用されます。 |
すべてのスケジューラ エントリーを取得する
指定されたサービスのすべてのスケジューラ エントリを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
サービス UPN
|
serviceUpn | True | string |
スケジューラ エントリを返す必要があるサービスの UPN。 |
戻り値
指定したサービスのスケジュールされているすべてのタスクの一覧
- スケジュール済みタスク
- array of SchedulerEntryEventData
アドレス帳から連絡先を削除する
アドレス帳から 1 つまたは複数の連絡先を削除します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Addressbook
|
AddressBook | True | string |
連絡先を削除するアドレス帳。 |
externalIds
|
externalIds | True | array of string |
アドレス帳から連絡先を取得する
アドレス帳から連絡先を返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Addressbook
|
AddressBook | True | string |
連絡先を取得するアドレス帳。 |
ExternalId
|
externalIds | array |
取得する連絡先の外部 ID。 オプション: 何も指定されない場合は、すべての連絡先が返されます。 |
戻り値
返された連絡先。
- Contacts
- array of ContactReadDto
アドレス帳を空にする
指定したアドレス帳のすべての連絡先を削除します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Addressbook
|
AddressBook | True | string |
空にする addressbook |
スケジューラ エントリを削除する
スケジューラ エントリをシステムから削除します。 スケジューラのエントリがまだ進行中でない場合にのみ可能です。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
スケジューラ エントリ ID
|
SchedulerEntryID | True | string |
削除するスケジューラ エントリの ID。 |
スケジューラ エントリを更新する
すでに作成されているスケジューラ エントリの設定を変更します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
スケジューラ エントリ ID
|
SchedulerEntryID | True | string |
更新するスケジューラ エントリの ID。 |
Reference ID
|
ReferenceId | string |
サードパーティ システムによって渡される参照用の ID。 |
|
Destination
|
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 |
Nimbus が宛先への到達を試行してから停止するまでの時間を定義します。 |
|
最大キュー時間 (秒)
|
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 |
電話番号の値。 |
|
顧客の UPN
|
UPN | string |
顧客の UPN。 |
|
顧客の IM アドレス
|
imAddress | string |
顧客の IM アドレス。 |
|
Customer Email
|
string |
顧客のメール。 |
||
件名
|
name | True | string |
カスタム フィールドの指定。 |
価値
|
value | string |
カスタム フィールドの値。 |
戻り値
タスクの更新
進行中のタスクの顧客情報、コンテキスト パラメーター、および/または優先ユーザー設定を更新します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Task 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 |
電話番号の値。 |
|
顧客の UPN
|
UPN | string |
顧客の UPN。 |
|
顧客の IM アドレス
|
imAddress | string |
顧客の IM アドレス。 |
|
Customer Email
|
string |
顧客のメール。 |
||
件名
|
name | True | string |
カスタム フィールドの指定。 |
価値
|
value | string |
カスタム フィールドの値。 |
|
件名
|
name | True | string |
カスタム コンテキスト パラメーターの名前。 |
価値
|
value | string |
カスタム コンテキスト パラメーターの値。 |
|
UPN
|
upn | True | string |
優先するユーザーの UPN。 |
優先順位
|
priority | integer |
優先順位。 1 高から 99 低。 |
外部タスクを削除する
外部タスクを削除する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
外部タスク Id
|
externalTaskId | True | string |
削除される外部タスクの ID |
新しい外部タスクを追加する
新しい外部タスクを追加する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
サービス 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 アドレス。 |
|
Customer Email
|
string |
顧客のメール。 |
||
件名
|
name | True | string |
カスタム フィールドの指定。 |
価値
|
value | string |
カスタム フィールドの値。 |
|
件名
|
name | True | string |
カスタム コンテキスト パラメーターの名前。 |
価値
|
value | string |
カスタム コンテキスト パラメーターの値。 |
|
配布の優先順位
|
distributionPriority | string |
タスクが期日になったら Nimbus で処理する優先順位。 |
|
UPN
|
upn | True | string |
優先するユーザーの UPN。 |
優先順位
|
priority | integer |
優先順位。 1 高から 99 低。 |
戻り値
新しい発信電話をスケジュールする
新しい発信電話 (スケジューラ エントリ) をスケジュールする
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Reference ID
|
ReferenceId | string |
サードパーティ システムによって渡される参照用の ID。 |
|
Destination
|
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 |
Nimbus が宛先への到達を試行してから停止するまでの時間を定義します。 |
|
最大キュー時間 (秒)
|
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 |
電話番号の値。 |
|
顧客の UPN
|
UPN | string |
顧客の UPN。 |
|
顧客の IM アドレス
|
imAddress | string |
顧客の IM アドレス。 |
|
Customer Email
|
string |
顧客のメール。 |
||
件名
|
name | True | string |
カスタム フィールドの指定。 |
価値
|
value | string |
カスタム フィールドの値。 |
戻り値
連絡先をアドレス帳で更新する
指定したアドレス帳の単一の連絡先を更新します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Addressbook
|
AddressBook | True | string |
連絡先を更新する addressbook。 |
連絡先の外部 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
連絡先をアドレス帳に追加する
特定のアドレス帳に新しい連絡先を追加します。 ExternalId は、以降のリクエストで参照として使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Addressbook
|
AddressBook | True | string |
連絡先を追加する addressbook。 |
連絡先の外部 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
トリガー
スケジューラ エントリの状態が変化したとき |
フィルター条件に一致するスケジューラ エントリの状態が変化するたびに発生します。 |
タスクの状態が変更するとき |
フィルター条件に一致するタスクの状態が変化するたびに発生します。 |
スケジューラ エントリの状態が変化したとき
フィルター条件に一致するスケジューラ エントリの状態が変化するたびに発生します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
サービス
|
services | True | array of string |
タスクのイベントを取得する必要があるサービスの UPN。 |
スケジューラ エントリ イベント
|
schedulerEntryEvents | True | array of string |
このトリガーを発生させる必要があるスケジューラ エントリのイベント。 |
戻り値
タスクの状態が変更するとき
フィルター条件に一致するタスクの状態が変化するたびに発生します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
サービス
|
services | True | array of string |
タスクのイベントを取得する必要があるサービスの UPN。 |
タスク イベント
|
taskEvents | True | array of string |
このトリガーを発生させる必要があるタスクのイベント。 |
モダリティ
|
modalities | array of string |
タスクの初期モダリティを指定します。 |
|
案内
|
directions | array of string |
タスクの方向を指定します。 |
戻り値
- Body
- TaskEventData
定義
TaskEventData
名前 | パス | 型 | 説明 |
---|---|---|---|
Task ID
|
taskId | string |
タスクの Nimbus 固有 ID。 |
コール チェーン ID
|
callChainId | string |
Microsoft からのタスクのコール チェーン ID。 |
イベント
|
event | string |
タスクの Nimbus 内で発生したイベント。 |
指示
|
direction | string |
Nimbus で進行中のタスクの方向 (受信/発信/なし)。 |
モダリティ
|
modality | string |
Nimbus でのタスクの初期モダリティ。 |
Created
|
created | string |
タスクが作成されたときのタイムスタンプ。 |
終了
|
terminated | string |
タスクが終了したときのタイムスタンプ。 |
最後に接続したユーザーの ID
|
lastConnectedUserId | string |
タスクに最後に接続したユーザーのオブジェクト ID (AAD) |
最後に接続したユーザーの UPN
|
LastConnectedUserUPN | string |
タスクに最後に接続したユーザーの UPN |
最後に接続したユーザーのメールアドレス
|
LastConnectedUserEmail | string |
タスクに最後に接続したユーザーのメールアドレス。 |
Microsoft 呼び出し元 ID
|
microsoftCallerId | string |
発信者のオブジェクト ID (AAD)。 |
Reference ID
|
referenceId | string |
サードパーティ システムによって渡される参照用の ID。 |
呼び出し元 ID
|
callerId | string |
Nimbus における発信者の内部 ID。 発信者がわかっている場合のオブジェクトID (AAD)。 |
発信者の電話番号
|
callerTelNumber | string |
発信者の電話番号 (E.164)。 modality=Audio のタスクにのみ設定します。 |
発信者の UPN
|
callerUPN | string |
顧客の UPN。 |
Microsoft 宛先 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。 |
匿名かどうか
|
isAnonymous | boolean |
発信者が匿名の場合、フラグは true に設定されます。 |
顧客識別子
|
customerIdentifier | string |
すべてのタスク タイプにおける顧客の識別子。 |
Initial Message
|
initialMessage | string |
まず、IM 顧客にメッセージします。 |
サービス ID
|
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)。 |
発信の試み
|
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 |
顧客の追加の電話番号の一覧。 |
顧客の UPN
|
UPN | string |
顧客の UPN。 |
顧客の IM アドレス
|
imAddress | string |
顧客の IM アドレス。 |
Customer Email
|
string |
顧客のメール。 |
|
Custom Fields
|
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 | 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
|
addresses | array of Address |
アドレスの一覧。 |
customFields
|
customFields | array of CustomField |
連絡先のカスタム フィールドの一覧。 |
番地
名前 | パス | 型 | 説明 |
---|---|---|---|
住所の番地
|
street | string |
住所の番地と番号。 |
住所の市区町村
|
city | string |
住所の市区町村。 |
住所の国
|
country | string |
住所の国。 |
住所の都道府県
|
state | string |
住所の都道府県。 |
住所郵便番号
|
postalCode | string |
住所の郵便番号。 |
SchedulerEntryEventData
名前 | パス | 型 | 説明 |
---|---|---|---|
スケジューラ エントリ ID
|
schedulerEntryId | string |
スケジューラ エントリの Nimbus 固有 ID。 |
イベント
|
event | string |
スケジュールされたタスクの Nimbus 内で発生したイベント。 |
指示
|
direction | string |
Nimbus で進行中のタスクの方向 (受信/発信/なし)。 |
モダリティ
|
modality | string |
Nimbus でのタスクの初期モダリティ。 |
Reference ID
|
ReferenceId | string |
サードパーティ システムによって渡される参照用の ID。 |
統合会話 ID
|
unifiedConversationId | string |
統合会話 ID。 |
完了理由
|
completionReason | string |
終了時のスケジューラ エントリの結果。 |
Destination
|
destination | string |
方向が「発信」のスケジューラ エントリの宛先。 |
配布の優先順位
|
distributionPriority | string |
タスクを Nimbus で処理する優先順位。 |
期限日時 (UTC)
|
dueDateTimeUtc | date-time |
UTC での期限日時: 例: '2020-03-23T11:00:00Z'。 |
サービス UPN
|
serviceUpn | string |
エントリがスケジュールされているサービスの UPN。 |
最大試行回数
|
maxAttempts | integer |
宛先に到達するための最大試行回数。 |
試行タイムアウト (秒)
|
attemptTimeoutInSeconds | integer |
Nimbus が宛先への到達を試行してから停止するまでの時間を定義します。 |
最大キュー時間 (秒)
|
maxQueueTimeInSeconds | integer |
タスクが「限界に達した」とみなされるまで、Nimbus がタスクの解決を試みる時間を定義します。 |
RONA タイムアウト (秒)
|
ronaTimeoutInSeconds | integer |
タスクが RONA と見なされ、新しいユーザーが検索されるまで、Nimbus がユーザーに到達しようとする時間を定義します。 |
カスタム コンテキスト パラメーター
|
customCallContextParameters | array of CustomContextParameter |
カスタム コンテキスト パラメーターの一覧 (Key-Value)。 |
顧客
|
customer | Customer |
顧客のすべての情報を含むオブジェクト。 |
ExternalTaskWriteResult
名前 | パス | 型 | 説明 |
---|---|---|---|
外部タスク ID
|
id | string |
追加された外部タスクの ID。 |
モダリティ
|
modality | Modality |
タスクのモダリティ。 |
Created
|
created | string |
外部タスクが作成されたときのタイムスタンプ。 |
タイプ
|
type | string |
外部タスクの種類。 |
匿名かどうか
|
isAnonymous | boolean |
発信者が匿名の場合、フラグは true に設定されます。 |
サービス ID
|
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)。 |