El webhook de registros de llamadas detallados ofrece una solución segura, escalable y sólida impulsada por eventos en lugar de solicitudes. Este webhook proporciona una mayor visibilidad de las actividades de Webex Calling de sus clientes y admite casos de uso que van desde la facturación hasta informes personalizados.

Puede utilizar este webhook para recopilar registros cómodamente de todos los clientes administrados a través de Partner Hub sin tener que consultar a cada cliente individualmente. Este webhook le permite desarrollar aplicaciones personalizadas de informes, facturación y análisis tanto para requisitos comerciales internos como para servicios de valor agregado.

Para obtener una introducción al webhook y las API que lo acompañan, mire este Vidcast: API de historial detallado de llamadas de socios de Webex Calling.

Qué ofrece el webhook de socio

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

• Registros de llamadas que finalizaron entre 10 minutos y 5 minutos antes de la hora actual.
• Cualquier registro tardío procesado por la nube de Webex Calling.
• Rellena automáticamente los registros de llamadas tardías en las cargas útiles del webhook posterior 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 en 14:05 Contiene llamadas que finalizaron entre 13:55 y 14:00.
• Llamadas que terminan entre 14:00 y 14:05 están incluidos en el 14:10 carga útil.
• Registros completados anteriormente (por ejemplo, una llamada que terminó en 14:04) pero procesado tarde por la nube de Webex Calling (por ejemplo, en 14:11) se incluyen en la siguiente carga útil programada (por ejemplo, 14:15).

Webhook en Parter 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.

Los registros de llamadas de Webex 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 feed:

• Análisis: incluye todos los registros de llamadas de todas las organizaciones de clientes con las que el socio tiene una relación de Webex Calling. Esto incluye organizaciones donde:
  • El socio administra la organización del cliente con un rol de administrador completo de socio.
  • La organización del cliente tiene una suscripción activa de Webex Calling dentro de la organización asociada.
• Facturación: incluye registros de llamadas realizadas por usuarios con una licencia de Webex Calling vendida y suministrada por el socio. Los registros de llamadas para espacios de trabajo se incluyen en esta fuente.

Acceso y privacidad de los datos

Sólo el socio propietario puede acceder a los registros de detalles de llamadas (CDR) para la 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 de API para respaldar la conciliación de datos. Estos puntos finales le permiten ponerse al día o conciliar sus almacenes de datos con cualquier registro faltante que su receptor de webhook podría no haber recibido. Los dos puntos finales de la API son la API de conciliación y la API de registros.

Los registros de estas API están disponibles durante 30 días. Para garantizar que reciba todos los registros esperados, le recomendamos conciliar sus almacenes de registros periódicamente, por ejemplo, cada 12 o 24 horas.

Debe utilizar un token de acceso de socio para acceder a estas API. Obtenga y administre su token de acceso de socio de acuerdo con las prácticas estándar de administración de tokens de acceso para desarrolladores de Webex.

Punto final de la API de conciliación

El punto final de la API de conciliació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 utilizar estos totales para verificar su almacenamiento local e identificar registros de llamadas faltantes o inconsistentes para clientes específicos.

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

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

Parámetros de API

Puede utilizar 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 API.

Los parámetros de la API son:

• startTime (obligatorio, cadena): la fecha y hora de inicio (UTC) del primer registro que desea recopilar. Asegúrese de que:
  • Formatea 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 anteriores a 30 días de la hora UTC actual.
  • La ventana entre startTime y endTime no puede exceder las 12 horas.
• endTime (obligatorio, 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:
  • Formatea 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 anteriores a la hora UTC actual y no tener más de 30 días de antigüedad.
  • La fecha y hora de finalización deben ser mayores que startTime.
  • La ventana entre startTime y endTime no puede exceder las 12 horas.

Ejemplo de una respuesta JSON del punto final de la 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 de la API indican la cantidad total de organizaciones devueltas y si hay páginas adicionales disponibles. Compruebe los siguientes parámetros de encabezado para asegurarse de haber consultado todas las páginas:

• num-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ás viendo la primera página de una respuesta de dos páginas que contiene 283 organizaciones en total. Para acceder a la siguiente página, agregue el page=2 parámetro 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

Punto final de la API de registros

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

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 Historial detallado de llamadas. Para obtener más información sobre los campos y sus valores, consulte Informe detallado del historial de llamadas de Webex Calling.

La API proporciona registros de llamadas que finalizaron 5 minutos antes de la hora actual. Para garantizar que todos los registros de llamadas estén disponibles, recomendamos consultar la API una hora después de su ventana de tiempo preferida.

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 la organización para la que desea recuperar registros. Puede obtener los ID de organización desde la API de conciliación.
• startTime (obligatorio, cadena): la fecha y hora de inicio (UTC) del primer registro que desea recopilar. Asegúrese de que:
  • Formatea 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 anteriores a 30 días de la hora UTC actual.
  • El intervalo entre startTime y endTime no debe exceder las 12 horas en una sola solicitud de API.
• endTime (obligatorio, 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:
  • Formatea 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 anteriores a la hora UTC actual y no tener más de 30 días de antigüedad.
  • La fecha y hora de finalización deben ser mayores que startTime.
  • El intervalo entre startTime y endTime no debe exceder las 12 horas en una sola solicitud de API.
• Máx. (opcional, número): limita la cantidad máxima 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 para devolver que el valor máximo especificado, entonces la respuesta se pagina.
  • Si se especifica un valor inferior a 500, se ajustará automáticamente hasta 500. Si se especifica un valor superior a 5000, se ajusta a 5000.

Paginación

Para identificar si las respuestas de la API están paginadas, verifique los encabezados de respuesta en busca de un encabezado de enlace. Si hay un enlace next en el encabezado Enlace, extráigalo y use el valor startTimeForNextFetch para solicitar el siguiente conjunto de registros. Si no hay ningún enlace siguiente, se recopilarán todos los informes correspondientes al rango de tiempo seleccionado.

Las solicitudes de API para páginas subsiguientes se pueden realizar de inmediato, pero deben tener un límite de velocidad de un máximo de 10 solicitudes paginadas por minuto, por alcance de token.

Por ejemplo, si la solicitud de API inicial 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 del enlace en la respuesta es:

; rel="next"

Otros posibles valores de enlace incluyen rel="first" y rel="prev" para la primera página y las páginas anteriores, respectivamente.

Puede generar y descargar informes disponibles en Partner Hub mediante las API de informes de socios. Para obtener más información, consulte el socio report/templates.

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