CCaaS_CreateProactiveDelivery APIを使おう

CCaaS_CreateProactiveDelivery APIを使って、Proactive Engagementサービスを通じて顧客への積極的な音声通話を開始できます。

Important

  • 組織が CCaaS_CreateProactiveDelivery APIを使って発信音声通話を開始する場合、同意管理の責任があり、顧客との連絡のための静かな時間を設定するための「電話禁止リスト」の手動更新も含まれます。 以下の条件を満たしていることを確認してください:
    • 顧客に連絡する前に同意を得ます。
    • お客様には許可された時間内にのみ連絡します。

前提条件

  • このAPIを呼び出すには、オムニチャネルエージェントまたはオムニチャネルスーパーバイザーの役割が必要です。
  • プロアクティブなエンゲージメントが構成されています。 詳細は 「積極的な関与の設定」をご覧ください。

リクエストの詳細

  • URL: https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveDelivery
  • 方法: POST
  • バージョン: 1.0
  • OData 操作: アクション
  • OData タイプ: 無制限
  • 承認の要求: 必須。 API呼び出しを行うユーザーのための有効なMicrosoft Entra IDベアラートークンを含んでいる必要があります。 このトークンはカスタマーサービスインスタンスと同じMicrosoft Entra IDテナントから発行されなければなりません。

リクエストヘッダー

Key タイプ Description
ApiVersion String CCaaS API バージョン。
プロアクティブエンゲージメント設定 String 使用するプロアクティブエンゲージメント構成のID。 また、ダイヤルモードの種類、作業ストリーム、アウトバウンドプロファイルも指定しています。 このIDを取得するには、以下の手順を踏みます:
  1. Power Appsにアクセスし、必要な環境を選択してください。
  2. テーブルを選択し>積極的な関与設定。
  3. 必要なレコードの ID を選択します。
RequestId String Optional. ソースシステムからのリクエストを追跡するために渡す属性。
優先順位 String Optional. リクエストの優先度値を定義します。
連絡先 ContactオブジェクトのJSON配列 この要請に対して1つ以上の連絡先(最大5人)を指定すること。 連絡先ごとに少なくとも1つの電話番号が必要です。
ウィンドウズ Window オブジェクトの JSON 配列 発信通話が有効な時間帯を指定する。 指定しない場合、システムはデフォルトで、即時 (現在時刻から 24 時間後まで) から始まる 24 時間のウィンドウになります。

接触オブジェクト

Key タイプ Description
ユニーク識別子 String 連絡先の一意識別子。 ContactIDでも外部IDでも構いません。
firstName String 連絡先の名前。
lastName String 連絡先の姓。
携帯電話番号 String 連絡先の携帯電話番号。
ビジネス電話番号 String 連絡先のビジネス電話番号。
homePhoneNumber String 連絡先の自宅電話番号。
メール String Optional. 連絡先のメール アドレス。
postalcode String Optional. 連絡先の郵便番号。
状態 String Optional. 接触の状態。
country String Optional. 連絡先の国・地域。
addressline String Optional. 連絡先の住所。
city String Optional. 連絡先の都市。
timezone String Optional. 連絡先のタイムゾーン。 Dynamics 365承認リストの中から値でなければなりません。
inputAttributes キーと値の文字列のJSONオブジェクト Optional. Copilot エージェントフロー内で参照可能な変数で、挙動のカスタマイズ、条件付きロジックの駆動、Dataverseレコードからパーソナライズされた情報を取得することができます。
ウィンドウズ Window オブジェクトの JSON 配列 Optional. この特定の接触に関する最上層Windowsを上書きする接触レベルの時間windows。

Note

1回の接触につき、 mobilePhoneNumber、 businessPhoneNumber、または homePhoneNumber のいずれかが少なくとも1つ必要です。

Windowsオブジェクト

Key タイプ Description
[開始] String このウィンドウの開始タイムスタンプ。 yyyy-MM-ddTHH:mm:ss.fffZ形式でUTCで指定する必要があります。
End String このウィンドウの終了タイムスタンプ。 yyyy-MM-ddTHH:mm:ss.fffZ形式でUTCで指定する必要があります。

サンプルリクエスト

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "RequestId": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
  "Priority": "1",
  "Contacts": "[{\"uniqueIdentifier\":\"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\"firstName\":\"John\",\"lastName\":\"Doe\",\"mobilePhoneNumber\":\"+15550100\",\"businessPhoneNumber\":\"+15550101\",\"homePhoneNumber\":\"+15550102\",\"email\":\"text@a.com\",\"postalcode\":\"25642\",\"state\":\"WA\",\"country\":\"USA\",\"addressline\":\"1234 227th PL SE\",\"city\":\"Seattle\",\"timezone\":\"(GMT-03:00) Brasilia\",\"inputAttributes\":{\"AppointmentTime\":\"10:00 AM\",\"CustomerNumber\":\"1234567\"},\"windows\":[{\"start\":\"2025-12-10T09:00:00Z\",\"end\":\"2025-12-10T17:00:00Z\"}]}]"
}

CCaaS_CreateProactiveVoiceDelivery API を使用する
CCaaS_CreateOperation APIを使う
レポート作成にプロアクティブなエンゲージメントテーブルを使用する

  • Last updated on