CCaaS_CreateProactiveVoiceDelivery API を使用して、顧客へのプロアクティブなアウトバウンド音声通話を開始したり、顧客がプロアクティブエンゲージメントサービスを通じてコールバックをスケジュールできるようにしたりできます。
このAPIは再挑戦や頻度制限などの積極的なエンゲージメント機能をサポートしていません。 これらの機能には CCaaS_CreateProactiveDelivery APIを使ってください。
Important
組織が CCaaS_CreateProactiveVoiceDelivery API を使用して音声通話の送信を開始している場合、その組織は、顧客との連絡の待機時間を設定するための "通話禁止リスト" の手動更新など、同意管理を担当します。 次の条件が満たされていることを確認します。
- 顧客に連絡する前に同意を得ます。
- お客様には許可された時間内にのみ連絡します。
前提条件
- このAPIを呼び出すには、オムニチャネルエージェントまたはオムニチャネルスーパーバイザーの役割が必要です。
- プロアクティブなエンゲージメントが構成されています。 詳細は 「積極的な関与の設定」をご覧ください。
プロアクティブな発信通話を開始する
プロアクティブなエンゲージメントにより、組織は音声チャネルを通じてアウトバウンドコミュニケーションを開始することで、顧客とのやり取りを強化できます。 プロアクティブなエンゲージメントは、Customer Insights 体験または CCaaS_CreateProactiveVoiceDeliveryを使用して構成できます。
CCaaS_CreateProactiveVoiceDelivery API を使用すると、組織は Proactive Engagement Service を通じて、顧客へのプロアクティブなアウトバウンド音声通話を開始できます。 この API は、Voice Runtime システムを通じてアウトバウンド音声通話をトリガーします。 コールは、設定されたダイヤル モードに従って、すぐに(時間枠が指定されていない場合)、または指定した時間枠内で発信されます。
このAPIにより、コンタクトセンターは適切なタイミングで顧客に関連情報、リマインダー、または通知を連絡し、運用効率を最適化しながら顧客体験を向上させることができます。
要求の詳細
-
URL:
https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery - 方法: POST
- バージョン: 1.0
- OData 操作: アクション
- OData タイプ: 無制限
- 承認の要求: 必須。 API呼び出しを行うユーザーのための有効なAzure AD Bearerトークンを含んでいる必要があります。 このトークンはカスタマーサービスインスタンスと同じAzure ADテナントから発行される必要があります。
リクエストヘッダー
| Key | タイプ | Description |
|---|---|---|
| ApiVersion | String | CCaaS API バージョン。 |
| プロアクティブエンゲージメント設定 | String | 使用するプロアクティブエンゲージメント設定のID。 これにより、使用するダイヤル モードの種類、作業ストリーム、および発信プロファイルが指定されます。 この ID を取得するには、次の手順を実行します。
|
| 宛先電話番号 | String | 電話をかける顧客の電話番号。 |
| ContactId | String | Dynamics CRMの顧客連絡先のIDです。 |
| ウィンドウズ | Window オブジェクトの JSON 配列 | 発信コールを発信できる有効な時間を指定します。 指定しない場合、システムはデフォルトで、即時 (現在時刻から 24 時間後まで) から始まる 24 時間のウィンドウになります。 |
| 入力属性 | キーと値の文字列のJSONオブジェクト | Optional. Copilot エージェントフロー内で参照可能な変数で、挙動のカスタマイズ、条件付きロジックの駆動、Dataverseレコードからパーソナライズされた情報を取得することができます。 |
Windowsオブジェクト
| Key | タイプ | Description |
|---|---|---|
| [開始] | String | このウィンドウの開始タイムスタンプ。
yyyy-MM-ddTHH:mm:ss.fffZ形式でUTCで指定する必要があります。 |
| End | String | このウィンドウの終了タイムスタンプ。
yyyy-MM-ddTHH:mm:ss.fffZ形式でUTCで指定する必要があります。 |
Important
一部のクライアントは"Windows": "[{\"Start\":\"2025-01-30T16:32:45.930Z\",\"End\":\"2025-06-25T16:32:45.930Z\"}]"のような特定のフォーマットを必要とします。 それに応じてテストすることをお勧めします。
サンプルリクエスト
{
"ApiVersion": "1.0",
"ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
"DestinationPhoneNumber": "+123456798",
"ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
"Windows": [
{
"Start": "2024-09-10T13:00:00.000Z",
"End": "2024-09-10T15:59:59.999Z"
},
{
"Start": "2024-09-11T13:00:00.000Z",
"End": "2024-09-11T15:59:59.999Z"
}
],
"InputAttributes": {
"orderNumber": "ORD123456789",
"type": "callback",
"isFinalAttempt": "false"
}
}
レスポンスの詳細
成功した場合、このメソッドは DeliveryIdを返します。 配信 ID は、API を通じて受け入れられ、msdyn_proactive_delivery テーブルに格納される各プロアクティブ エンゲージメント要求に割り当てられた一意の識別子です。
応答の例は次のとおりです。
{
"@odata.context": "[Organization URI]api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CCaaS_CreateProactiveVoiceDeliveryResponse",
"DeliveryId": "9838deee-0b4e-4116-bf73-ecb80474568d"
}