Preguntas más frecuentes sobre la API de registros de llamadas de Microsoft Graph

En este tema se proporcionan respuestas a las preguntas más frecuentes sobre la API de registros de llamadas en Microsoft Graph.

¿Qué es la API de registros de llamadas de Microsoft Graph?

La API de registros de llamadas de Microsoft Graph ofrece información de uso y diagnóstico para llamadas y reuniones en línea que se producen dentro de su organización al usar Microsoft Teams o Skype Empresarial. Las organizaciones, también denominadas "inquilinos", pueden usar la API de registros de llamadas para suscribirse, enumerar, recuperar registros de llamadas mediante identificadores de llamada y buscar llamadas para un participante. Para obtener más información, consulte Trabajar con la API de registros de llamadas en Microsoft Graph.

¿Qué permiso se necesita para usar la API de registros de llamadas?

La aplicación necesita el permiso CallRecords.Read.All para acceder a los registros de llamadas en Microsoft Graph. Un administrador debe conceder este permiso a la aplicación. Para más información, vea Permisos de Microsoft Graph.

¿Puedo usar permisos delegados con la API de registros de llamadas?

No, la API de registros de llamadas no admite permisos delegados.

¿Por qué no puedo usar permisos delegados con la API de registros de llamadas?

No puede usar permisos delegados porque no hay ninguna manera de limitar el permiso CallRecords.Read.All a llamadas o usuarios específicos. El permiso de aplicación se concede en el nivel de organización, no en el nivel de usuario individual.

Cómo solicitar un registro de llamada mediante la API de registros de llamadas?

Para solicitar un registro de llamada, debe realizar una GET solicitud al /communications/callRecords/{id} punto de conexión, donde {id} es el identificador único de la llamada. Asegúrese de que tiene el permiso CallRecords.Read.All e incluya el encabezado Authorization con un token de portador válido. Para obtener más información, consulte La documentación de Get callRecord.

¿Dónde puedo encontrar los identificadores de llamada de las llamadas que se produjeron en mi organización?

Puede buscar y recopilar identificadores de llamada de las siguientes maneras:

• Suscribirse a notificaciones: suscríbase a la fuente de notificaciones de cambios y reciba notificaciones que contengan identificadores de llamada cada vez que se cree un nuevo registro de llamadas.
• Enumerar registros de llamadas: obtenga una lista de identificadores de llamada solicitándola desde list callRecords API.
• Búsqueda manual: si tiene acceso a Análisis de llamadas en el Centro de Administración de Teams para Microsoft Teams, puede buscar manualmente un identificador de llamada en el historial de un usuario. Sin embargo, no hay ningún sistema automatizado disponible para recuperar todos los identificadores de llamada de Call Analytics.
• Use callChainId:: busque el identificador de llamada mediante desde callChainId la API get call una vez completada la llamada. Use este enfoque cuando la llamada se cree mediante programación y trabaje con el tipo de recurso de llamada. Además, callChainId puede diferir del identificador del registro de llamadas en determinados escenarios, como las llamadas de transferencia, debido a los detalles de la arquitectura. Por lo tanto, use los otros métodos de esta lista siempre que sea posible.

¿Cuándo está disponible un registro de llamadas?

Normalmente se genera una primera versión de un registro de llamada y se envía una notificación en un plazo de 15 minutos después de que finalice una llamada. Sin embargo, el servicio puede tardar hasta 60 minutos en hacer que el registro de llamada esté disponible. Para obtener más información, consulte la página Latencia .

¿Cuánto tiempo se conservan los registros de llamadas?

Los registros de llamadas se conservan durante 30 días después de que finalice la llamada.

¿Puedo recuperar registros de llamadas anteriores a 30 días?

No, la API de registros de llamadas no devuelve registros de llamada anteriores a 30 días. Las solicitudes de estos registros dan como resultado una respuesta de 404 Not Found error.

¿Por qué se retrasa mi primera notificación de registro de llamadas?

La notificación de registro de llamadas se puede retrasar porque el servicio puede tardar hasta 60 minutos en poner a disposición la primera versión de un registro de llamada. Si experimenta un retraso más largo para la entrega de la primera versión del registro de llamadas, compruebe si hay interrupciones notificadas por el equipo de la API de registros de llamadas en la pestaña Estado del Portal de teams Administración. Además, puede abrir una incidencia de soporte técnico con el equipo de API de registros de llamadas.

¿Por qué se retrasan las versiones posteriores de mi registro de llamadas?

Las versiones posteriores de un registro de llamada se pueden entregar después de la latencia inicial de 60 minutos. Esto significa que, aunque la primera versión está disponible en un plazo de 60 minutos, las actualizaciones posteriores del registro de llamadas pueden llegar más tarde debido a la telemetría retrasada del cliente y otros factores.

¿Por qué falta un registro de llamadas?

Un registro de llamada puede tener campos que faltan debido a la telemetría retrasada de un cliente. Cuando hay nuevos datos de telemetría disponibles, el sistema genera un nuevo registro de llamadas con información actualizada, incrementa el valor de la version propiedad y le envía el registro de llamada actualizado. Si faltan propiedades en el registro de llamada, espere a la siguiente versión del registro de llamadas.

Sin embargo, es importante tener en cuenta que algunos campos pueden permanecer vacíos por diseño o porque la telemetría del cliente nunca llegó, como los valores de flujo multimedia.

Si faltan campos críticos o entregados previamente, abra una incidencia de soporte técnico con el equipo de API de registros de llamadas.

¿Cómo puedo enumerar todos los participantes que han asistido a una llamada?

Puede usar los métodos siguientes para enumerar todos los participantes en la llamada:

1. Api de participants_v2 de lista

   Use list participants_v2 API para recopilar la lista completa de participantes para un identificador de llamada solicitado.

2. Use el parámetro de consulta $expand OData en el objeto callRecords para expandir la propiedad participants_v2

   Puede llamar GET communications/callRecords/{id}?$expand=participants_v2 a para recuperar detalles de llamadas de alto nivel junto con la lista de participantes.

3. Compilación de una lista de participantes personalizados

   Para ver a todos los participantes, implemente una solución personalizada para compilar la lista de participantes a partir de los datos de registros de llamadas:

   1. Llame a la API Get callRecord y expanda la sessions propiedad : GET /communications/callRecords/{id}?$expand=sessions.
   2. Para las llamadas punto a punto (P2P), lea las caller propiedades y callee de cada una session de las de la lista recibida sessions . Para las llamadas a reuniones, lea solo la caller propiedad .
   3. Cree la lista de participantes personalizados en función de la identidad del caller punto de conexión. En el caso de las llamadas P2P, también incluye la identidad del punto de callee conexión. Recopile , iddisplayNamey otras propiedades que necesite para cada participante.

¿Por qué no veo a todos los participantes que han asistido a una llamada mientras llaman a la lista participants_v2 API?

Es posible que no vea a todos los participantes porque list participants_v2 API admite la paginación, lo que limita el número de participantes en la respuesta a 130 por página. Si había más de 130 usuarios en la llamada, la primera respuesta del registro de llamadas contiene 130 participantes junto con una @odata.nextLink propiedad. Esta propiedad incluye la dirección URL para llamar a la API y recibir el siguiente conjunto de participantes. Continúe con este proceso hasta que el siguiente vínculo esté vacío, lo que indica que no hay más participantes que recuperar.

¿Por qué se devuelven sesiones duplicadas para un registro de llamada?

Una sesión de registro de llamadas representa de forma única una comunicación usuario-usuario única en llamadas punto a punto o una única comunicación de servicio de usuario en una llamada de grupo o reunión. Sin embargo, en algunos escenarios de llamada, una única comunicación de servicio de usuario puede implicar varias identidades de servicio en una sola sesión, como una transferencia virtual entre un operador automático y una cola de llamadas. En estos escenarios, un identificador de sesión podría duplicarse una o varias veces para representar correctamente cada identidad implicada en la comunicación y la duración de la comunicación correspondiente.

¿Por qué recibo un error 404 No encontrado?

Estas son algunas de las razones por las que podría encontrarse con un 404 Not Found error:

• Llamada reciente: si la llamada se realizó en los últimos 60 minutos, es posible que aún no se genere el registro de llamada. Espere 60 minutos después de que finalice la llamada e inténtelo de nuevo.
• Llamada antigua: si la llamada es anterior a 30 días, la API de registros de llamada devuelve un 404 Not Found error por diseño.
• Otros problemas: si no se aplica ninguna de las razones, compruebe si hay interrupciones notificadas por el equipo de API de registros de llamadas en la pestaña Estado del Portal de teams Administración. Además, puede abrir una incidencia de soporte técnico con el equipo de API de registros de llamadas para obtener ayuda.