상세 통화 기록 웹훅은 요청보다는 이벤트에 따라 구동되는 안전하고 확장 가능하며 견고한 솔루션을 제공합니다. 이 웹훅은 고객의 Webex Calling 활동에 대한 가시성을 높여 청구부터 맞춤형 보고까지 다양한 사용 사례를 지원합니다.

이 웹훅을 사용하면 각 고객에게 개별적으로 쿼리를 보내지 않고도 Partner Hub를 통해 관리되는 모든 고객에 대한 기록을 편리하게 수집할 수 있습니다. 이 웹훅을 사용하면 내부 비즈니스 요구 사항과 부가가치 서비스 모두에 맞는 맞춤형 보고, 청구 및 분석 애플리케이션을 개발할 수 있습니다.

웹훅과 관련 API에 대한 소개를 보려면 이 비디오캐스트를 시청하세요. Webex 통화 파트너 상세 통화 내역 API.

파트너 웹훅이 제공하는 것

웹훅은 5분마다 자세한 통화 내역 기록을 제공합니다. 각 웹훅 페이로드에는 다음이 포함됩니다.

• 현재 시간으로부터 10분에서 5분 전에 종료된 통화 기록입니다.
• Webex Calling 클라우드에서 처리된 모든 늦은 기록입니다.
• 안정적인 전달을 보장하기 위해 후속 웹훅 페이로드에서 늦은 통화 기록을 자동으로 백필합니다.

각 페이로드에 통화 기록이 어떻게 포함되는지 보여드리기 위해 다음 예를 살펴보겠습니다.

• 수신된 페이로드 14:05 사이에 종료된 통화가 포함되어 있습니다. 13:55 그리고 14:00.
• 통화 종료 시간 14:00 그리고 14:05 에 포함됩니다 14:10 유효 탑재량.
• 이전에 완료된 기록(예: 종료된 통화) 14:04) 그러나 Webex Calling 클라우드에서 늦게 처리됨(예: 14:11) 다음 예정된 페이로드에 포함됩니다(예: 14:15).

파트너 허브의 웹훅

웹훅을 제공하면 분석 플랫폼에서 통화 기록이 생성될 때마다 해당 통화 기록을 콜백 URL로 보낼 수 있습니다.

Webex 통화 기록은 기존 상세 통화 기록 API와 동일한 형식을 사용하여 제공됩니다. 웹훅을 설정하고 두 가지 유형의 피드 중에서 선택할 수 있습니다.

• 분석—파트너가 Webex Calling 관계를 맺고 있는 모든 고객 조직의 모든 통화 기록이 포함됩니다. 여기에는 다음과 같은 조직이 포함됩니다.
  • 파트너는 파트너 전체 관리자 역할을 통해 고객 조직을 관리합니다.
  • 고객 조직은 파트너 조직 내에서 활성 Webex Calling 구독을 보유하고 있습니다.
• 청구—파트너가 판매하고 제공한 Webex Calling 라이선스를 통해 사용자가 한 통화에 대한 통화 기록이 포함됩니다. 이 피드에는 작업 공간의 통화 기록이 포함됩니다.

접근 및 데이터 개인 정보 보호

청구를 위해 통화 세부 기록(CDR)에 액세스할 수 있는 사람은 소유 파트너뿐입니다.

• 통화 기록과 관련된 라이선스를 관리하는 파트너(또는 하위 파트너)가 소유 파트너가 됩니다.
• 소유권은 다음에 의해 결정됩니다. 사용자 ID > 라이센스 ID > 구독 ID > 파트너 ID.
• 각 CDR은 단일 파트너가 접근할 수 있습니다.
• 일부 통화 기록은 청구 파트너에 매핑되지 않으며, 조직과 관련된 모든 파트너가 모든 기록에 동등하게 액세스할 수 있는 것은 아닙니다. 이러한 기록에는 개인 식별 정보(PII)가 포함될 수 있기 때문입니다.

Webex Calling은 웹훅 외에도 데이터 조정을 지원하는 API 엔드포인트를 제공합니다. 이러한 엔드포인트를 사용하면 웹훅 리스너가 수신하지 못한 누락된 레코드를 따라잡거나 데이터 저장소를 조정할 수 있습니다. 두 개의 API 엔드포인트는 조정 API 및 레코드 API입니다.

이러한 API의 기록은 30일 동안 사용할 수 있습니다. 예상 기록을 모두 받을 수 있도록 12시간이나 24시간마다 등 주기적으로 기록 보관소를 조정하는 것이 좋습니다.

이러한 API에 액세스하려면 파트너 액세스 토큰을 사용해야 합니다. 표준 Webex 개발자 액세스 토큰 관리 관행에 따라 파트너 액세스 토큰을 얻고 관리하세요.

조정 API 엔드포인트

조정 API 엔드포인트는 지정된 기간 내에 파트너가 관리하는 각 고객에 대해 생성된 총 통화 레코드 수를 반환합니다. 이러한 총계를 사용하여 로컬 저장소를 확인하고 특정 고객에 대한 누락되거나 일관되지 않은 통화 기록을 파악할 수 있습니다.

200개 이상의 고객 조직을 관리하는 경우 API는 가독성을 높이기 위해 결과를 페이지별로 구분합니다.

조정 API 엔드포인트 URL은 다음 형식을 사용합니다.

API 매개변수

API를 사용하면 지난 30일간의 통화 기록을 검색할 수 있습니다. 선택한 시간 창은 현재 UTC 시간보다 최소 5분 전에 시작해야 하며 단일 API 호출에서 시작 시간과 종료 시간 사이에 12시간을 초과할 수 없습니다.

API 매개변수는 다음과 같습니다.

• startTime (필수, 문자열)—수집하려는 첫 번째 레코드의 시작 날짜 및 시간(UTC). 다음 사항을 확인하세요.
  • 시간은 YYYY-MM-DDTHH:MM:SS.mmmZ형식으로 지정합니다. 예를 들어, 2025-08-15T06:00:00.000Z.
  • 시작 날짜와 시간은 현재 UTC 시간으로부터 30일을 넘을 수 없습니다.
  • startTime 와 endTime 사이의 창은 12시간을 초과할 수 없습니다.
• endTime (필수, 문자열)—수집하려는 레코드의 종료 날짜 및 시간(UTC). 기록은 보고 시간, 즉 통화가 완료된 시간을 기준으로 합니다. 다음 사항을 확인하세요.
  • 시간은 YYYY-MM-DDTHH:MM:SS.mmmZ형식으로 지정합니다. 예를 들어, 2025-08-15T18:00:00.000Z.
  • 종료 날짜와 시간은 현재 UTC 시간보다 5분 전이어야 하며 30일을 넘을 수 없습니다.
  • 종료 날짜와 시간은 startTime보다 커야 합니다.
  • startTime 와 endTime 사이의 창은 12시간을 초과할 수 없습니다.

조정 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)
• 전체 조직: 응답에 포함된 조직의 총 수(예: 283)
• 현재 페이지: 현재 페이지 번호(예: 1)

예를 들어, 헤더가 표시되는 경우 num-pages=2, total-orgs=283, 그리고 current-page=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 엔드포인트는 Reconciliation API를 사용하여 불일치 또는 누락된 데이터가 식별된 특정 조직의 누락된 통화 기록을 쿼리하는 데 사용됩니다.

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입니다. 조정 API에서 조직 ID를 얻을 수 있습니다.
• startTime (필수, 문자열)—수집하려는 첫 번째 레코드의 시작 날짜 및 시간(UTC). 다음 사항을 확인하세요.
  • 시간은 YYYY-MM-DDTHH:MM:SS.mmmZ형식으로 지정합니다. 예를 들어, 2025-08-15T06:00:00.000Z.
  • 시작 날짜와 시간은 현재 UTC 시간으로부터 30일을 넘을 수 없습니다.
  • 단일 API 요청에서 startTime 와 endTime 사이의 간격은 12시간을 초과할 수 없습니다.
• endTime (필수, 문자열)—수집하려는 마지막 레코드의 종료 날짜 및 시간(UTC). 기록은 보고 시간, 즉 통화가 완료된 시간을 기준으로 합니다. 다음 사항을 확인하세요.
  • 시간은 YYYY-MM-DDTHH:MM:SS.mmmZ형식으로 지정합니다. 예를 들어, 2025-08-15T18:00:00.000Z.
  • 종료 날짜와 시간은 현재 UTC 시간보다 최소 5분 전이어야 하며 30일을 넘을 수 없습니다.
  • 종료 날짜와 시간은 startTime보다 커야 합니다.
  • 단일 API 요청에서 startTime 와 endTime 사이의 간격은 12시간을 초과할 수 없습니다.
• Max (선택 사항, 숫자)—응답의 페이지당 최대 레코드 수를 제한합니다. 다음 사항을 확인하세요.
  • 범위는 500에서 5000까지입니다. 기본값은 5000입니다. 예를 들어, Max=1000.
  • API가 반환할 레코드가 지정된 최대값보다 많은 경우 응답이 페이지별로 나뉩니다.
  • 500 미만의 값을 지정하면 자동으로 500까지 조정됩니다. 5000보다 큰 값이 지정되면 5000으로 조정됩니다.

페이지 매김

API 응답이 페이지별로 나뉘었는지 확인하려면 응답 헤더에서 Link 헤더를 확인하세요. Link 헤더에 next 링크가 있는 경우 해당 링크를 추출하고 startTimeForNextFetch 값을 사용하여 다음 레코드 세트를 요청합니다. 다음 링크가 없으면 선택한 기간의 모든 보고서가 수집됩니다.

이후 페이지에 대한 API 요청은 즉시 이루어질 수 있지만, 토큰 범위당 분당 최대 10개의 페이지 분할 요청으로 속도가 제한되어야 합니다.

예를 들어, 초기 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

그러면 응답의 Link 헤더는 다음과 같습니다.

; rel="next"

다른 가능한 링크 값으로는 각각 첫 번째 페이지와 이전 페이지의 경우 rel="first" 와 rel="prev" 가 있습니다.

파트너 reports/templates API

파트너 보고서 API를 사용하여 파트너 허브에서 제공되는 보고서를 생성하고 다운로드할 수 있습니다. 자세한 내용은 파트너를 참조하세요. report/templates.

파트너는 파트너 허브에서 여러 보고서에 직접 액세스하여 다운로드할 수도 있습니다. 자세한 내용은 파트너 허브 보고서를 참조하세요.