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

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

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

파트너 웹훅이 제공하는 기능

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

• 현재 시간을 기준으로 10분 전부터 5분 전까지 종료된 통화 기록입니다.
• Webex 통화 클라우드에서 처리된 모든 지연 기록.
• 지연된 통화 기록을 후속 웹훅 페이로드에 자동으로 채워 넣어 안정적인 전달을 보장합니다.

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

• 수신된 페이로드 14:05 종료된 통화를 포함합니다. 13:55 그리고 14:00.
• 통화 종료 사이 14:00 그리고 14:05 다음 항목에 포함됩니다. 14:10 유효 탑재량.
• 이전에 완료된 기록(예: 종료된 통화) 14:04) 하지만 Webex Calling 클라우드에서 늦게 처리됩니다(예: 14:11) 다음 예정된 페이로드에 포함됩니다(예: 14:15).

파트너 허브의 웹훅

웹훅을 제공하면 분석 플랫폼이 통화 기록이 생성될 때마다 콜백 URL로 전송할 수 있게 됩니다.

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

• 분석 기능 - 파트너가 Webex 통화 서비스를 이용하는 모든 고객사의 통화 기록을 모두 포함합니다. 여기에는 다음과 같은 조직이 포함됩니다.
  • 파트너는 파트너 정식 관리자 권한을 가지고 고객 조직을 관리합니다.
  • 고객사는 파트너사 내에서 Webex 통화 구독을 활성화한 상태입니다.
• 청구 - 파트너가 판매 및 제공한 Webex 통화 라이선스를 보유한 사용자가 건 통화 기록이 포함됩니다. 이 피드에는 워크스페이스 통화 기록이 포함되어 있습니다.

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

청구 목적으로 통화 상세 기록(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 엔드포인트

레코드 API 엔드포인트는 조정 API를 사용하여 불일치 또는 누락된 데이터가 확인된 특정 조직의 누락된 통화 기록을 조회하는 데 사용됩니다.

레코드 API는 상세 통화 내역 API에 설명된 형식과 동일한 JSON 형식으로 통화 기록을 반환합니다. 반환된 페이로드에는 상세 통화 내역 반환 페이로드와 동일한 필드가 포함되어 있습니다. 필드 및 해당 값에 대한 자세한 내용은 Webex 통화 상세 통화 기록 보고서를 참조하세요.

이 API는 현재 시간으로부터 5분 전에 종료된 통화 기록을 제공합니다. 모든 통화 기록을 확인하려면 원하는 시간대 이후 한 시간 뒤에 API를 조회하는 것이 좋습니다.

레코드 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 매개변수

• 조직 ID (필수, 문자열) - 레코드를 검색할 조직 ID입니다. 조직 ID는 조정 API에서 얻을 수 있습니다.
• startTime (필수, 문자열) - 수집하려는 첫 번째 레코드의 시작 날짜 및 시간(UTC). 다음 사항을 확인하십시오:
  • 시간을 YYYY-MM-DDTHH:MM:SS.mmmZ형식으로 지정합니다. 예를 들어, 2025-08-15T06:00:00.000Z.
  • 시작 날짜 및 시간은 현재 UTC 시간으로부터 30일 이내여야 합니다.
  • startTime 와 endTime 사이의 간격은 단일 API 요청에서 12시간을 초과해서는 안 됩니다.
• endTime (필수, 문자열) - 수집하려는 마지막 레코드의 종료 날짜 및 시간(UTC). 기록은 통화가 완료된 보고 시간을 기준으로 합니다. 다음 사항을 확인하십시오:
  • 시간을 YYYY-MM-DDTHH:MM:SS.mmmZ형식으로 지정합니다. 예를 들어, 2025-08-15T18:00:00.000Z.
  • 종료 날짜 및 시간은 현재 UTC 시간보다 최소 5분 전이어야 하며, 30일 이내여야 합니다.
  • 종료 날짜 및 시간은 startTime보다 커야 합니다.
  • startTime 와 endTime 사이의 간격은 단일 API 요청에서 12시간을 초과해서는 안 됩니다.
• 최대 (선택 사항, 숫자) - 응답에서 페이지당 최대 레코드 수를 제한합니다. 다음 사항을 확인하십시오:
  • 범위는 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

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

; rel="next"

다른 가능한 링크 값으로는 첫 페이지와 이전 페이지에 대해 각각 rel="first" 와 rel="prev" 가 있습니다.

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

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