Ir al contenido

Metadatos de Llamadas

Uspeech analiza lo que ocurre dentro de la llamada. Todo lo que la rodea —cuándo ocurrió, qué agente la atendió, si fue entrante o saliente, quién colgó primero, a qué campaña pertenecía— proviene de sus propios sistemas. Hay tres formas de aportarlo:

  • Un manifiesto CSV para todo un proyecto — la forma más rápida de cubrir un lote de grabaciones
  • El diálogo Editar metadatos de la llamada sobre un archivo concreto — para corregir o completar una sola llamada
  • La API, al subir el archivo o después — consulte API de Metadatos de Llamadas

Las tres escriben en el mismo lugar, así que puede combinarlas sin problema.

Sin metadatos, Uspeech utiliza la hora de subida del archivo y el nombre del agente que la IA escucha en la conversación. El informe se genera igualmente, pero:

  • La tendencia de cumplimiento y los filtros de fecha usan la fecha de subida en lugar de la fecha real de la llamada
  • La comparación de turnos no puede clasificar las llamadas (solo cuentan las que tienen fecha y hora reales)
  • El desempeño de agentes depende del nombre pronunciado en la llamada, que varía entre grabaciones
  • Dirección y campaña no están disponibles como filtros
  • Los pasos de cierre pueden descontarse en llamadas que el cliente cortó, porque la transcripción rara vez muestra quién colgó; vea Quién colgó primero

Aportar los metadatos resuelve todo esto de una vez.


  1. Haga clic en Conversaciones en la barra de navegación
  2. Seleccione su proyecto de call center
  3. En la pestaña Archivos, haga clic en Metadatos de llamadas (CSV)
  4. Elija su archivo CSV y haga clic en Subir

Diálogo de subida de metadatos de llamadas

El diálogo informa cuántos archivos se asociaron, cuántas filas quedan pendientes (aún no existe el archivo correspondiente) y qué filas no se pudieron leer.


Una fila por llamada, con fila de encabezado:

ColumnaObligatoriaDescripción
filenameSíNombre del archivo de audio o transcripción tal como se subió
call_datetimeSíFecha y hora en que ocurrió la llamada
agent_idNoIdentificador del agente en sus propios sistemas
agent_nameNoNombre visible del agente
agent_emailNoCorreo del agente, que permite a un agente invitado ver sus propias llamadas; vea Correo del agente
directionNoinbound (entrante) o outbound (saliente)
ended_byNoQuién colgó primero: customer (el cliente) o agent (el agente); vea Quién colgó primero
caller_numberNoNúmero telefónico del cliente
campaignNoNombre de la campaña o cola

Ejemplo:

filename,call_datetime,agent_id,agent_name,agent_email,direction,ended_by,caller_number,campaign
call_001.mp3,2026-06-15 09:12:00,A-06,Ana Diaz,ana.diaz@example.com,inbound,customer,+34600111222,Retención
call_002.mp3,2026-06-15 09:41:00,A-10,Luis Gomez,luis.gomez@example.com,outbound,agent,+34600333444,Recuperación
call_003.mp3,2026-06-15 10:02:00,A-06,Ana Diaz,ana.diaz@example.com,inbound,,+34600555666,Retención

Formatos de fecha y hora aceptados:

  • 2026-06-15T09:12:00 (ISO 8601, con o sin zona horaria)
  • 2026-06-15 09:12:00 o 2026-06-15 09:12
  • 15/06/2026 09:12:00 o 15/06/2026 09:12

Los valores sin zona horaria se interpretan en la zona horaria del servidor.


  1. Coincidencia exacta del nombre de archivo (call_001.mp3 → call_001.mp3)
  2. Nombre sin extensión, sin distinguir mayúsculas, como alternativa — así un manifiesto que indica call_001.wav también coincide con un call_001.mp3 ya subido

Dos consecuencias útiles:

  • El orden no importa. Las filas que todavía no coinciden con ningún archivo se guardan en el proyecto y se aplican automáticamente a los archivos subidos más tarde. Puede subir el manifiesto antes, durante o después de las grabaciones. Con el análisis automático, subirlo primero evita que una llamada aparezca con un nombre deducido.
  • Las transcripciones también cuentan como llamadas. Los archivos SRT y VTT se asocian igual que los de audio.

Puede subir el manifiesto varias veces; las subidas posteriores agregan y actualizan las filas guardadas.


Una fila se rechaza —y se informa en el diálogo— cuando:

  • filename está vacío
  • call_datetime falta o no tiene uno de los formatos aceptados

El resto es opcional: las columnas opcionales vacías o desconocidas simplemente se ignoran. Un valor de direction o de ended_by que no sea uno de los aceptados se descarta, igual que un agent_email que no sea una dirección válida. El resto de la fila se aplica igualmente.


La mayoría de los marcadores y ACD registran qué lado cortó primero, a menudo como motivo de terminación o de liberación. Envíelo en la columna ended_by:

ValorSignificado
customerEl cliente colgó primero
agentEl agente colgó primero

El manifiesto también acepta cliente, client y caller para el cliente, y agente, asesor y asesora para el agente, con cualquier combinación de mayúsculas, así que la mayoría de las exportaciones del marcador sirven tal cual. Deje la celda vacía cuando el marcador no lo registró.

Por qué enviarlo. Un cliente que dice “bueno, gracias” y cuelga mientras el agente todavía está cerrando se ve, en la transcripción, exactamente como una despedida normal. Con ended_by, los pasos del guion de cierre que usted marque en la rúbrica no se descuentan en esas llamadas; vea Pasos de cierre cuando el cliente cuelga.

Tres cosas que conviene saber:

  • Es opcional. Las llamadas que no lo traen se califican exactamente igual que antes.
  • customer en una llamada normal es lo esperado. Muchos clientes cuelgan después de la despedida del agente. Esas llamadas se siguen calificando con normalidad: un paso solo se exime cuando el agente no llegó a despedirse.
  • Se lee al calificar la llamada. Agregarlo o cambiarlo en una llamada ya calificada no cambia nada hasta que vuelva a analizar esa llamada.

El valor también aparece como Colgó primero en el detalle de la llamada, y como columna Hung up first en la exportación a Excel de los resultados COPC.


En un proyecto de call center la tabla de archivos muestra dos columnas adicionales —Fecha y hora de la llamada y Agente— para que vea de un vistazo qué llamadas ya tienen metadatos. Una fecha y hora en gris es la hora de subida del archivo, usada como marcador porque todavía no se ha aportado la fecha real de la llamada.

Tabla de archivos con las columnas Fecha y hora de la llamada y Agente

Para modificar una llamada concreta, abra el menú ⋯ de su fila y elija Editar metadatos de la llamada.

Diálogo de edición de metadatos de la llamada

El diálogo tiene un campo para cada columna del manifiesto, incluido Colgó primero. Está disponible para archivos de audio y para transcripciones SRT/VTT. Conviene tener presente:

  • Vacío borra. Si guarda un campo en blanco, se elimina el valor que hubiera. Es lo contrario del manifiesto CSV, donde una celda vacía simplemente deja el valor existente intacto. Correo del agente es la excepción: permanece en el agente mientras la llamada conserve su ID o su nombre. Vea Correo del agente.
  • La fecha y hora no se puede vaciar. Si la borra, la llamada vuelve a usar la hora de subida del archivo.
  • Un manifiesto posterior tiene prioridad. Si después sube un manifiesto CSV, sus filas sobrescriben lo que haya escrito aquí. Edite llamadas individuales después de la carga masiva, no antes.
  • Editar metadatos nunca vuelve a ejecutar el análisis. Las puntuaciones, los temas y el sentimiento quedan exactamente igual; solo cambian los campos descriptivos. Eso incluye Colgó primero: para que un valor nuevo cuente en la puntuación, vuelva a analizar la llamada.

Uspeech mantiene un registro por agente y vincula cada llamada a él:

  • Si indica agent_id, esa es la clave — renombrar al agente más adelante conserva todo el histórico
  • Si indica solo agent_name, los agentes se asocian por nombre (se normalizan mayúsculas y espacios)
  • Si no indica ninguno, se usa como alternativa el nombre del agente que la IA extrajo de la conversación

Los metadatos siempre tienen prioridad. Un nombre extraído del audio nunca sobrescribe un agente aportado por el manifiesto o la API.


agent_email vincula las llamadas de un agente con su acceso, para que pueda ver sus propios resultados. No tiene ningún efecto hasta que invite a esa dirección con el rol de Agente.

  • Envíelo junto con el agent_id. El correo pertenece al registro del agente, así que una fila con ambos basta para todas las llamadas que tengan ese agent_id, incluidas las subidas antes.
  • Un agent_id que sea un correo también vale. Si sus sistemas identifican a los agentes por correo, no necesita la columna adicional: un agent_id que sea una dirección válida se interpreta también como el correo del agente.
  • Evite un correo sin ID. Una fila sin agent_id se asocia por correo. Si ningún agente tiene ese correo todavía, se crea un registro de agente nuevo, aunque ya exista un agente con el mismo nombre, de modo que la misma persona puede aparecer como dos agentes.
  • Escribir otro correo lo reemplaza en el registro del agente, para todas sus llamadas. Quien fue invitado con la dirección anterior pierde el acceso a ellas. Vea Administrar agentes.
  • Vaciar el campo no lo elimina. Para retirar el acceso a un agente, elimínelo del equipo.

Si sube las grabaciones de forma programática, puede adjuntar los mismos campos a cada archivo al subirlo en lugar de mantener un CSV, modificarlos después y consultar los metadatos que tiene una llamada — consulte API de Metadatos de Llamadas.