コメントありがとうございます。

Detailed Call Recordsウェブフックは、 リクエストではなくイベントによって駆動される安全でスケーラブルで堅牢なソリューションを提供します。 このウェブフックは、 Webex Calling顧客の活動を可視化して、請求からカスタムメイドのレポートまで、さまざまなユースケースをサポートします。

このWebhookを使用すると、 Partner Hubで管理しているすべての顧客の記録を、各顧客に個別に問い合わせることなく便利に収集できます。 このウェブフックを使用すると、 社内のビジネス要件と付加価値サービスの両方に対応したカスタムレポート、請求、分析アプリケーションを開発できます。

Webhookとそれに付随するAPIの概要については、こちらのVidcast：Webex Callingパートナー詳細通話履歴APIをご覧ください。

パートナーウェブフックが提供するもの

Webhookは、詳細な通話履歴記録を5分ごとに配信します。 各Webhookペイロードには以下が含まれます：

• 現在の時刻の10分から5分前に終了した通話記録。
• Webex Callingクラウドで処理されたすべての遅延記録。
• 信頼性の高い配信を確保するために、後続のWebhookペイロードにレイトコール記録を自動的にバックフィルします。

通話記録が各ペイロードにどのように含まれるかを示すには、次の例を考えてみましょう。

• 14:05 に受信したペイロードには、13:55 から 14:00 の間に終了した通話が含まれています。
• 14:00 から 14:05 の間に終了した通話は 14:10 のペイロードに含まれます。
• 以前に完了した記録（たとえば、14:04 に終了した通話） Webex Callingがクラウドによって遅れて処理された（たとえば 14:11 に）記録は、次に予定されているペイロード（たとえば 14:15）に含まれます。

パートナーハブのWebhook

Webhookを提供することで、分析プラットフォームが通話記録を生成するたびに、コールバックURLに通話記録を送信できるようになります。

Webex Calling記録は、既存の詳細通話記録APIと同じ形式で配信されます。 Webhookを設定して、次の2種類のフィードから選択できます。

• 分析-パートナーが関係のあるすべての顧客組織のすべての通話記録が含まれます。Webex Calling これには、次のような組織が含まれます。
  • パートナーは、パートナーのフルアドミニストレータの役割で顧客組織を管理します。
  • 顧客組織は、Webex Callingパートナー組織内で有効なサブスクリプションを持っています。
• 請求-Webex Calling パートナーが販売・提供したライセンスを持つユーザーによる通話記録が含まれます。 このフィードには、ワークスペースの通話記録が含まれています。

アクセスとデータプライバシー

通話詳細記録（CDR）にアクセスして請求できるのは、オーナーパートナーだけです。

• 通話記録に関連するライセンスを管理するパートナー（またはサブパートナー） がオーナーパートナーになります。
• 所有権は、ユーザーID > ライセンスID > サブスクリプションID > パートナーIDによって決まります。
• 各CDRには、1人のパートナーがアクセスできます。
• 通話記録の中には請求パートナーに紐付けられないものもあり、 組織に関連するすべてのパートナーがすべての記録に平等にアクセスできるわけではありません。 これらの記録には個人を特定できる情報（PII）が含まれている可能性があるためです。

Webhookに加えて、Webex Callingデータ調整をサポートするAPIエンドポイントを提供します。 これらのエンドポイントを使用すると、Webhookリスナーが受信していない可能性のある欠落しているレコードをデータストアに追いついたり、調整したりできます。 2つのAPIエンドポイントは、照合APIとレコードAPIです。

これらのAPIの記録は30日間利用可能です。 期待されるレコードをすべて確実に受け取れるように、レコード店を12時間ごとや24時間ごとなど、定期的に照合することをお勧めします。

これらのAPIにアクセスするには、パートナーアクセストークンを使用する必要があります。 認証するユーザーは、組織のフル管理者レベルのアクセス権を持つパートナーのフルアドミニストレーターで、Webex CallingCDR APIアクセスが有効になっている必要があります。 OAuthトークンにはスコープを含める必要があります。spark-admin:calling_cdr_read 読み取り専用の管理者ロールは、パートナー照合APIとレコードAPIには不十分です。

analytics-callingWebex Calling顧客組織のデータリージョンのエンドポイントを使用してください。 照合 API とレコード API の両方に該当するベース URL を使用してください。

• 米国とカナダ:https://analytics-calling.webexapis.com
• ヨーロッパ:https://analytics-calling-eu.webexapis.com
• インド:https://analytics-calling-in.webexapis.com
• オーストラリア:https://analytics-calling-au.webexapis.com

リコンシリエーション API エンドポイント

照合APIエンドポイントは、指定された期間内にパートナーが管理する各顧客について生成された通話記録の合計数を返します。 これらの合計を使用して、ローカルストレージを確認し、特定の顧客の通話記録の欠落や一貫性のない通話記録を特定できます。

200を超える顧客組織を管理している場合、APIは結果をページ分割して読みやすくします。

リコンシリエーション API エンドポイントのURLは次の形式を使用します。

API パラメーター

APIを使用して、過去30日間の通話記録を取得できます。 選択した時間枠は、現在のUTC時刻の少なくとも5分前に開始し、1回のAPI呼び出しの開始時刻と終了時刻の間が12時間を超えてはなりません。

APIパラメータは:

• startTime（必須、文字列）—収集したい最初のレコードの開始日時（UTC）。 次のことを確認してください。
  • YYYY-MM-DDTHH:MM:SS.mmmZ時刻を次のようにフォーマットします。 例えば、2025-08-15T06:00:00.000Z。
  • 開始日時は、現在のUTC時刻から30日以上経過してはいけません。
  • startTimeendTimeとの間隔は12時間を超えてはいけません。
• endTime（必須、文字列）—収集したいレコードの終了日時（UTC）。 記録は、通話が終了したレポート時間に基づいています。 次のことを確認してください。
  • YYYY-MM-DDTHH:MM:SS.mmmZ時刻を次のようにフォーマットします。 例えば、2025-08-15T18:00:00.000Z。
  • 終了日時は、現在のUTC時間の5分前で、30日以内である必要があります。
  • 終了日時は、より大きくなければなりませんstartTime。
  • startTimeとの間のウィンドウは12時間を超えてはいけません。endTime

リコンシリエーション API エンドポイントの JSON レスポンスの例:

          {
          "cdr_counts": [
          {
          "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 3009
          },
          {
          "orgId": "yyyyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 129
          },
          {
          "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 27895
          }
          ]
          }          
        

API応答ヘッダーには、返された組織の総数と、追加のページがあるかどうかが示されます。 次のヘッダーパラメータをチェックして、すべてのページを検索したことを確認してください。

• ページ数:ページの総数 (たとえば、2)
• total-orgs: 回答に含まれていた組織の総数（たとえば、283）
• 現在のページ:現在のページ番号 (たとえば、1)

たとえば、ヘッダーに num-pages=2、total-orgs=283、現在のページ=1と表示されている場合、表示されているのは合計283の組織を含む2ページの回答の最初のページです。 次のページにアクセスするには、以下に示すように page=2 パラメーターを GET リクエストに追加します。

https://analytics-calling.webexapis.com/v1/partners/cdrcountbyorg?endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z&page=2

レコード API エンドポイント

Records APIエンドポイントは、照合APIを使用して不一致や欠落データが特定された特定の組織の欠落している通話記録を照会するために使用されます。

推奨フロー：/v1/partners/cdrcountbyorgまず電話してください。 そして、cdr_counts[].orgIdあなたが電話をかけたときには、orgId戻ってきたものとまったく同じものを使用してください/v1/partners/cdrsbyorg。

Records APIは、詳細通話履歴APIで説明されている形式と同じJSON形式で通話記録を返します。 返されたペイロードには、返された詳細な通話履歴ペイロードと同じフィールドが含まれています。 フィールドとその値の詳細については、Webex Calling詳細な通話履歴レポートを参照してください。

APIは、現在の時刻の5分前に終了した通話記録を提供します。 すべての通話記録を確実に入手できるようにするには、希望する時間帯の1時間後にAPIにクエリを実行することをお勧めします。

Records APIエンドポイントのURLは次の形式を使用しています。

https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z

API パラメーター

• orgId(必須、文字列) — レコードを取得したい顧客組織のID。 パラメータ名は大文字と小文字が区別されます。 組織IDは、調整 APIのレスポンスフィールドから取得できます。cdr_counts[].orgId
• startTime（必須、文字列）—収集したい最初のレコードの開始日時（UTC）。 次のことを確認してください。
  • YYYY-MM-DDTHH:MM:SS.mmmZ時刻を次のようにフォーマットします。 例えば、2025-08-15T06:00:00.000Z。
  • 開始日時は、現在のUTC時刻から30日以上経過してはいけません。
  • startTime1回のAPIリクエストで、endTimeとの間隔が12時間を超えてはいけません。
• endTime（必須、文字列）—収集したい最後のレコードの終了日時（UTC）。 記録は、通話が終了したレポート時間に基づいています。 次のことを確認してください。
  • YYYY-MM-DDTHH:MM:SS.mmmZ時刻を次のようにフォーマットします。 例えば、2025-08-15T18:00:00.000Z。
  • 終了日時は、現在のUTC時刻の少なくとも5分前で、30日以内である必要があります。
  • 終了日時は、より大きくなければなりませんstartTime。
  • startTime1回のAPIリクエストで、endTimeとの間隔が12時間を超えてはいけません。
• max（オプション、数値）—応答の1ページあたりの最大レコード数を制限します。 次のことを確認してください。
  • 範囲は500から5000です。 デフォルト値は5000です。 例えば、max=1000。
  • APIが返すレコードの数が指定された最大値を超える場合、応答はページ分割されます。
  • 500未満の値を指定すると、500まで自動的に調整されます。 5000を超える値が指定された場合は、5000に調整されます。

ページネーション

APIレスポンスがページ分割されているかどうかを確認するには、レスポンスヘッダーにリンクヘッダーがあるかどうかを確認してください。 nextリンクヘッダーにリンクがある場合は、それを抽出し、startTimeForNextFetchその値を使用して次のレコードセットをリクエストしてください。 次のリンクがない場合は、選択した時間範囲のすべてのレポートが収集されます。

次のページのAPIリクエストはすぐに行うことができますが、トークンスコープあたり1分あたり最大10ページのリクエストにレート制限する必要があります。

レコードを取得するときは、ページ分割された回答や調整期間が繰り返される場合を含め、偶数処理と重複排除を使用してください。 reportIdreportTime主キーとして使用し、最後に処理されたレコードを決定します。

たとえば、最初のAPIリクエストが次のような場合です。

https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=2025-08-15T18:00:00.000Z&startTime=2025-08-15T06:00:00.000Z&max=5000

その場合、応答のリンクヘッダーは：

<https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=2025-08-15T18:00:00.000Z&startTime=2025-08-15T06:00:00.000Z&startTimeForNextFetch=2025-08-15T09:30:00.000Z&totalCount=20000&max=5000>; rel="next"

rel="next"ページネーションはリンクヘッダーのみを使用します。 rel="next"応答にリンクが含まれている場合は、そのURLを使用して次のページのレコードを取得してください。 rel="next"応答にリンクが含まれていない場合は、選択した時間範囲で利用可能なすべてのレコードを取得したことになります。

パートナーレポートAPIを使用して、パートナーハブで利用可能なレポートを生成してダウンロードできます。 詳細については、 パートナーレポート/テンプレートを参照してください。

パートナーは、Partner Hubから複数のレポートに直接アクセスしてダウンロードすることもできます。 詳細については、パートナーハブのレポートを参照してください。