Gracias por sus comentarios.

El webhook Detailed Call Records ofrece una solución segura, escalable y robusta impulsada por eventos en lugar de solicitudes. Este webhook proporciona una mayor visibilidad de Webex Calling las actividades de sus clientes, soportando casos de uso, desde facturación hasta informes personalizados.

Puede usar este webhook para recopilar registros convenientemente para todos los clientes administrados a través de Partner Hub sin consultar a cada cliente individualmente. Este webhook le permite desarrollar informes personalizados, facturación y aplicaciones analíticas tanto para los requisitos internos del negocio como para los servicios de valor agregado.

Para una introducción al webhook y sus API que lo acompañan, vea esta API de Vidcast: Webex Calling Partner Detailed Call History.

Qué ofrece el Webhook Partner

El webhook entrega registros detallados del historial de llamadas cada 5 minutos. Cada carga útil de webhook contiene :

• Registros de llamadas que terminaron entre 10 minutos y 5 minutos antes de la hora actual.
• Cualquier registro tardío procesado por la Webex Calling nube.
• Rellena automáticamente los registros de llamadas tardías en las cargas útiles subsiguientes del webhook para garantizar una entrega confiable.

Para mostrar cómo se incluyen los registros de llamadas en cada carga útil, considere el siguiente ejemplo:

• Una carga útil recibida a las 14:05 contiene llamadas que terminaron entre las 13:55 y las 14:00.
• Las llamadas que terminan entre las 14:00 y las 14:05 están incluidas en la carga útil 14:10.
• Los registros completados antes (por ejemplo, una llamada que terminó a las 14:04) pero procesados tarde por Webex Calling la nube (por ejemplo, a las 14:11) se incluyen en la siguiente carga útil programada (por ejemplo, 14:15).

Webhook en Partner Hub

Al proporcionar un webhook, permite que la plataforma de análisis envíe registros de llamadas a su URL de devolución de llamada cada vez que se generen.

Webex Callinglos registros se entregan utilizando el mismo formato que las API de Registros de Llamadas Detallados existentes. Puede configurar un webhook y elegir entre dos tipos de alimentación:

• Análisis: incluye todos los registros de llamadas de todas las organizaciones de clientes con las que el socio tiene una Webex Calling relación. Esto incluye organizaciones en las que:
  • El socio administra la organización del cliente con una función de Partner Full Administrator.
  • La organización del cliente tiene una Webex Calling suscripción activa dentro de la organización asociada.
• Facturación: incluye registros de llamadas para llamadas realizadas por usuarios con una Webex Calling licencia vendida y aprovisionada por el socio. Los registros de llamadas de los espacios de trabajo se incluyen en este feed.

Acceso y privacidad de datos

Solo el socio propietario puede acceder a los registros de detalles de llamadas (CDR) para facturación.

• Un socio (o subsocio) que administra la licencia asociada con el registro de llamadas se convierte en el socio propietario.
• La propiedad está determinada por: ID de usuario > ID de licencia > ID de suscripción > ID de socio.
• Cada CDR es accesible para un solo socio.
• Algunos registros de llamadas no se asignan a un socio de facturación, y no todos los socios asociados con una organización reciben el mismo acceso a todos los registros, ya que estos registros pueden contener información de identificación personal (PII).

Además del webhook, Webex Calling proporciona puntos finales API para admitir la reconciliación de datos. Estos puntos finales le permiten ponerse al día o reconciliar sus almacenes de datos con cualquier registro faltante que su oyente de webhook podría no haber recibido. Los dos puntos finales de API son la API de reconciliación y la API de registros.

Los registros de estas API están disponibles durante 30 días. Para asegurarse de recibir todos los registros esperados, le recomendamos reconciliar sus tiendas de discos periódicamente, como cada 12 o 24 horas.

Debe usar un token de acceso de socio para acceder a estas API. El usuario autenticador debe ser un administrador completo asociado con acceso de nivel administrativo completo de la organización y debe tener habilitado el acceso a la API Webex Calling CDR. El token OAuth debe incluir el spark-admin:calling_cdr_readalcance. Las funciones de administrador de solo lectura no son suficientes para las API de Reconciliación y Registros de socios.

Utilice el analytics-callingpunto final para la región de Webex Calling datos de la organización del cliente. Utilice la URL base aplicable para las API de reconciliación y registros:

• Estados Unidos y Canadá: https://analytics-calling.webexapis.com
• Europa: https://analytics-calling-eu.webexapis.com
• India: https://analytics-calling-in.webexapis.com
• Australia: https://analytics-calling-au.webexapis.com

Punto final de API de reconciliación

El punto final de la API de reconciliación devuelve el número total de registros de llamadas generados para cada cliente administrado por el socio dentro del período de tiempo especificado. Puede usar estos totales para verificar su almacenamiento local e identificar cualquier registro de llamadas faltante o inconsistente para clientes específicos.

Si administra más de 200 organizaciones de clientes, la API pagina los resultados para mejorar la legibilidad.

La dirección URL del punto final de la API de reconciliación utiliza el siguiente formato:

Parámetros de API

Puede usar la API para recuperar registros de llamadas de los últimos 30 días. La ventana de tiempo seleccionada debe comenzar al menos 5 minutos antes de la hora UTC actual y no puede exceder las 12 horas entre las horas de inicio y finalización en una sola llamada a la API.

Los parámetros de la API son:

• StartTime (requerido, cadena): la fecha y hora de inicio (UTC) del primer registro que desea recopilar. Asegúrese de que:
  • Formatee la hora como YYYY-MM-DDTHH:MM:SS.mmmZ. Por ejemplo, 2025-08-15T06:00:00.000Z.
  • La fecha y hora de inicio no deben ser mayores de 30 días a partir de la hora UTC actual.
  • La ventana entre startTimey no endTimepuede exceder las 12 horas.
• EndTime (requerido, cadena): la fecha y hora de finalización (UTC) de los registros que desea recopilar. Los registros se basan en la hora del informe, que es cuando se realiza la llamada. Asegúrese de que:
  • Formatee la hora como YYYY-MM-DDTHH:MM:SS.mmmZ. Por ejemplo, 2025-08-15T18:00:00.000Z.
  • La fecha y hora de finalización deben ser 5 minutos antes de la hora UTC actual y no más de 30 días.
  • La fecha y hora de finalización deben ser mayores que la startTime.
  • La ventana entre los startTimey no endTimepuede exceder las 12 horas.

Ejemplo de una respuesta JSON de punto final de API de reconciliación:

          {
          "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
          }
          ]
          }          
        

Los encabezados de respuesta API indican el número total de organizaciones devueltas y si hay páginas adicionales disponibles. Compruebe los siguientes parámetros de encabezado para asegurarse de que ha realizado consultas en todas las páginas:

• número de páginas: número total de páginas (por ejemplo, 2)
• organizaciones totales: número total de organizaciones incluidas en la respuesta (por ejemplo, 283)
• página actual: el número de página actual (por ejemplo, 1)

Por ejemplo, si los encabezados muestran num-pages=2, total-orgs=283 y current-page=1, está viendo la primera página de una respuesta de dos páginas que contiene 283 organizaciones en total. Para acceder a la página siguiente, agregue el parámetro page=2 a su solicitud GET, como se muestra a continuación:

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

Registra el punto final de la API

El punto final de la API de registros se utiliza para consultar registros de llamadas faltantes para organizaciones específicas donde se identificaron discrepancias o datos faltantes mediante la API de reconciliación.

Flujo recomendado: Llame /v1/partners/cdrcountbyorgprimero. Luego use la información exacta orgIddevuelta cdr_counts[].orgIdcuando llame /v1/partners/cdrsbyorg.

La API de registros devuelve registros de llamadas en formato JSON, idéntico al formato descrito en la API de historial de llamadas detallado. La carga útil devuelta contiene campos idénticos a la carga útil devuelta del Historial de llamadas detallado. Para obtener más información sobre los campos y sus valores, consulte Informe Webex Calling detallado del historial de llamadas.

La API proporciona registros de llamadas que terminaron 5 minutos antes de la hora actual. Para asegurarse de que todos los registros de llamadas estén disponibles, le recomendamos consultar la API una hora después de su horario preferido.

La URL del punto final de la API de registros utiliza el siguiente formato:

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

Parámetros de API

• orgId(obligatorio, cadena): el ID de organización del cliente para el que desea recuperar registros. El nombre del parámetro distingue entre mayúsculas y minúsculas. Puede obtener ID de organización en el campo de respuesta API de reconciliación cdr_counts[].orgId.
• StartTime (requerido, cadena): la fecha y hora de inicio (UTC) del primer registro que desea recopilar. Asegúrese de que:
  • Formatee la hora como YYYY-MM-DDTHH:MM:SS.mmmZ. Por ejemplo, 2025-08-15T06:00:00.000Z.
  • La fecha y hora de inicio no deben ser mayores de 30 días a partir de la hora UTC actual.
  • El intervalo entre los startTimey no endTimedebe exceder las 12 horas en una sola solicitud de API.
• EndTime (requerido, cadena): la fecha y hora de finalización (UTC) del último registro que desea recopilar. Los registros se basan en la hora del informe, que es cuando se realiza la llamada. Asegúrese de que:
  • Formatee la hora como YYYY-MM-DDTHH:MM:SS.mmmZ. Por ejemplo, 2025-08-15T18:00:00.000Z.
  • La fecha y hora de finalización deben ser al menos 5 minutos antes de la hora UTC actual y no más de 30 días.
  • La fecha y hora de finalización deben ser mayores que la startTime.
  • El intervalo entre los startTimey no endTimedebe exceder las 12 horas en una sola solicitud de API.
• max (opcional, número): limita el número máximo de registros por página en la respuesta. Asegúrese de que:
  • El rango es de 500 a 5000. El valor predeterminado es 5000. Por ejemplo, max=1000.
  • Si la API tiene más registros que devolver que el valor máximo especificado, entonces la respuesta se pagina.
  • Si se especifica un valor inferior a 500, se ajusta automáticamente hasta 500. Si se especifica un valor superior a 5000, se ajusta a 5000.

Paginación

Para identificar si las respuestas API están paginadas, compruebe los encabezados de respuesta para un encabezado Link. Si hay un nextenlace en el encabezado Link, extráigalo y use el startTimeForNextFetchvalor para solicitar el siguiente conjunto de registros. Si no hay un enlace siguiente, entonces se recopilan todos los informes para el intervalo de tiempo seleccionado.

Las solicitudes de API para páginas posteriores se pueden realizar de inmediato, pero deben tener una tarifa limitada a un máximo de 10 solicitudes paginadas por minuto, por alcance de token.

Utilice el procesamiento idempotente y la deduplicación cuando recupere registros, incluso a través de respuestas paginadas o ventanas de reconciliación repetidas. reportIdUtilícelo como clave principal y reportTimepara determinar el último registro procesado.

Por ejemplo, si la solicitud inicial de API es:

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

entonces el encabezado Link en la respuesta es:

<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"

La paginación utiliza solo el encabezado rel="next"Link. Si la respuesta incluye un rel="next"enlace, use esa URL para recuperar la siguiente página de registros. Si la respuesta no incluye un rel="next"enlace, ha recuperado todos los registros disponibles para el intervalo de tiempo seleccionado.

Puede generar y descargar informes disponibles en Partner Hub utilizando las API de informes de socios. Para obtener más información, consulte el informe/plantillas de socios.

Los socios también pueden acceder y descargar múltiples informes directamente desde Partner Hub. Para obtener más información, consulte los informes de Partner Hub.