El webhook de registros de llamadas detallados ofrece una solución segura, escalable y robusta basada en eventos en lugar de solicitudes. Este webhook proporciona mayor visibilidad de las actividades de llamadas de Webex de sus clientes, admitiendo casos de uso que van desde la facturación hasta la generación de informes personalizados.

Puede utilizar este webhook para recopilar cómodamente los registros de todos los clientes gestionados 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 añadido.

Para una introducción al webhook y sus API asociadas, vea este Vidcast: API de historial de llamadas detallado del socio de llamadas de Webex.

¿Qué ofrece el webhook de socios?

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

• Registros de llamadas que finalizaron entre 10 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 de webhook subsiguientes para garantizar una entrega fiable.

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

• Se recibió una carga útil en 14:05 Contiene llamadas que terminaron 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 finalizó en 14:04) pero procesados con retraso 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 Partner Hub

Al proporcionar un webhook, permite que la plataforma de análisis envíe los 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. Puedes 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 llamadas de Webex. Esto incluye organizaciones donde:
  • El socio gestiona la organización del cliente con un rol de Administrador Pleno del Socio.
  • La organización cliente tiene una suscripción activa a 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 aprovisionada por el socio. En este feed se incluyen los registros de llamadas de Workspaces.

Acceso y privacidad de datos

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

• El socio (o subsocio) que gestiona la licencia asociada al registro de llamadas se convierte en el socio propietario.
• La propiedad se determina mediante: ID de usuario > ID de licencia > ID de suscripción > ID de socio.
• Cada CDR es accesible para un único socio.
• Algunos registros de llamadas no se corresponden con un socio de facturación, y no todos los socios asociados a una organización reciben el mismo acceso a todos los registros, ya que estos pueden contener información de identificación personal (PII).

Además del webhook, Webex Calling proporciona endpoints de API para admitir la conciliación de datos. Estos puntos de conexión le permiten ponerse al día o reconciliar sus almacenes de datos con cualquier registro faltante que su receptor de webhook podría no haber recibido. Los dos puntos de conexión de la API son la API de conciliacióny 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 gestione su token de acceso de socio de acuerdo con las prácticas estándar de gestión de tokens de acceso para desarrolladores de Webex.

punto de conexión de la API de reconciliación

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

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

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

Parámetros de la API

Puedes utilizar la API para recuperar los registros de llamadas de los últimos 30 días. El intervalo de tiempo seleccionado debe comenzar al menos 5 minutos antes de la hora UTC actual y no puede exceder las 12 horas entre la hora de inicio y la hora de finalización en una sola llamada a la 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:
  • El formato de la hora es 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 desde la hora UTC actual.
  • El intervalo 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:
  • El formato de la hora es 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 una antigüedad superior a 30 días.
  • La fecha y hora de finalización deben ser posteriores a startTime.
  • El intervalo entre startTime y endTime no puede exceder las 12 horas.

Ejemplo de respuesta JSON de un punto de conexión 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
          }
          ]
          }          
        

Las cabeceras de respuesta de la API indican el número total de organizaciones devueltas y si hay páginas adicionales disponibles. Comprueba los siguientes parámetros de encabezado para asegurarte de que has consultado todas las páginas:

• número de páginas: Número total de páginas (por ejemplo, 2)
• total-orgs: 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 un total de 283 organizaciones. Para acceder a la página siguiente, agregue el page=2 parámetro de 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 de conexión de la API de registros

El punto de conexión de la API de registros se utiliza para consultar los registros de llamadas faltantes de organizaciones específicas en las que 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 del historial de llamadas detallado. Para obtener más información sobre los campos y sus valores, consulte Informe detallado del historial de llamadas de Webex.

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 del intervalo de tiempo que prefiera.

La URL del punto de conexión 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 la API

• OrgID (obligatorio, cadena)—El ID de la organización para la cual desea recuperar registros. Puede obtener los ID de organización a través de 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:
  • El formato de la hora es 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 desde la hora UTC actual.
  • El intervalo entre startTime y endTime no debe exceder las 12 horas en una sola solicitud a la 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:
  • El formato de la hora es 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 una antigüedad superior a 30 días.
  • La fecha y hora de finalización deben ser posteriores a startTime.
  • El intervalo entre startTime y endTime no debe exceder las 12 horas en una sola solicitud a la 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 va 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 Max especificado, 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 la baja hasta 5000.

Paginación

Para identificar si las respuestas de la API están paginadas, compruebe las cabeceras de respuesta en busca de una cabecera Link. Si hay un enlace next presente en el encabezado Link, extráigalo y use el valor startTimeForNextFetch para solicitar el siguiente conjunto de registros. Si no hay un enlace siguiente, se recopilan todos los informes para el intervalo de tiempo seleccionado.

Las solicitudes a la API para las páginas subsiguientes se pueden realizar de inmediato, pero deben estar limitadas a un máximo de 10 solicitudes paginadas por minuto, por ámbito de token.

Por ejemplo, si la solicitud inicial a la 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:

; rel="next"

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

Pareja reports/templates API

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

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